前言
- 制作属于自己的组件库并上传至CocoaPods
一、先将代码传到github上
1．创建本地仓库
git init
2．添加名称为origin的远程连接git remote add origin 'Github项目地址'
3．将本地代码加入到本地仓库git add .
4．提交修改到本地仓库git commit -m '修改记录'
5．推送master分支的代码到名称为orgigin的远程仓库git push origin master
二、给你git打上tag
打tag的目的就相当于给你的开源框架制定版本号，每个版本一个tag
1．cd仓库目录
2．查看本地taggit tag
3．添加本地tag 1.0.0git tag -a 1.0.0 -m 'release 1.0.0'
image
4．将tag传到远程git push origin --tags
tag的其他操作
1．删除本地tag
git tag -d 1.0.0
2．删除远程taggit push origin -d tag 1.0.0
三、注册Trunk
1．注册Trunk
pod trunk register 邮箱 '用户名' --description='描述'
image
成功的话就会受到一份邮件，点击邮件中的链接后验证一下：
2．打开邮箱点击地址：https://trunk.cocoapods.org/sessions/verify/965b5e96
点击红色terminal跳转回到终端
image
3．注册
pod trunk me
成功会看到如下类似字段：
image
4．如果你的pod是由多人维护的，你也可以添加其他维护者
pod trunk add-owner 名称 邮箱
四、获取MIT文件
1．网页链接 https://choosealicense.com/
image
复制，修改相应的数据
image
2．将生成的LICENSE文件同步至Github
五、创建自己项目的Podspec描述文件
1．创建podspec文件
pod spec create KJEmitterView
2．podspec文件代码
Pod::Spec.new do |s|
s.name = "KJEmitterView"
s.version = "1.0.0"
s.summary = "Some iOS Emitter"
s.homepage = "https://github.com/yangKJ/KJEmitterView"
s.license = "MIT"
s.license = { :type => "MIT", :file => "LICENSE" }
s.license = "Copyright (c) 2018 yangkejun"
s.author = { "77" => "ykj310@126.com" }
s.platform = :iOS
s.source = { :git => "https://github.com/yangKJ/KJEmitterView.git", :tag => "#{s.version}" }
s.framework = "UIKit"
# s.dependency "JSONKit", "~> 1.4"
s.requires_arc = true
s.subspec 'Classes' do |ss|
ss.source_files = "KJEmitterView/Classes/**/*.{h,m}" # 添加文件
ss.public_header_files = 'KJEmitterView/Classes/*.h',"KJEmitterView/Classes/**/*.h" # 添加头文件
ss.resources = "KJEmitterView/Classes/**/*.{bundle}" # 添加数据资料
end
end
3．验证你本地的podspec文件
pod spec lint KJEmitterView.podspec
4．忽略警告pod spec lint KJEmitterView.podspec --allow-warnings
验证成功，
image
六、传到CocoaPods上
1．首先验证你本地的podspec文件，之后会上传spec文件到trunk
2．将podspec文件传到trunk上pod trunk push KJEmitterView.podspec
成功如下：
image
3．一直处于Updating spec repo master 状态
可以选择更新下pod repo update --verbose
4．检查是否上传成功：pod search KJEmitterView
七、Bug总结
1、[!] There was an error registering with trunk: getaddrinfo: nodename nor servname provided, or not known
- 解决方案：开启了ShadowSocks，把ShadowSocks关闭再重试就好了，根本原因是DNS不对
- 附上解决方案链接：https://link.jianshu.com/?t=https://github.com/CocoaPods/CocoaPods/issues/2174
2、- WARN | [iOS] license: Unable to find a license file
- 原因：没有找到License文件，根据规则也可以直接把文本写在podspec文件里
- 解决方案：podspec文件里面添加
- s.license = "Copyright (c) 2018 yangkejun"
3、- WARN | source: The version should be included in the Git tag.
- 原因：podspec里的version要跟git上的tag相匹配
- 解决方案：
- 查看当前tag： git tag
- 推到远端： git push --tags
4、[!] Unable to accept duplicate entry for: KJEmitterDemo (1.0.0)
- 原因：重复
- 解决方案：
- 4.1．重新给git库添加tag git tag -a 1.0.1 -m'release 1.0.1'
- 4.2．上传到远端 git push origin --tags
- 4.3．重新修改podspec文件 s.version = "1.0.1"
- 4.4．再次校验 pod spec lint KJEmitterDemo.podspec --allow-warnings
- 4.5．最后上传到trunk pod trunk push KJEmitterDemo.podspec
5、[!] Unable to find a pod with name, author, summary, or description matching KJEmitterDemo
- 原因：审核过程是要两三天
- 解决方案：
- 执行
pod setup命令进行本地依赖库更新，然后再搜索 - 如果还是不行删除~/Library/Caches/CocoaPods目录下的search_index.json文件
- 执行
rm ~/Library/Caches/CocoaPods/search_index.json - 然后再执行搜索
pod search KJEmitterDemo -
成功如下：
image
6、校验不通过
可能原因：github上面的tag文件格式已经确定,下图位置下载下来看一下，是否和本地的文件格式保持一致。如果不一致按照下列方式解决bug。
-
查看git上面的文件格式
image -
Github上面下载下来的文件格式：
image -
本地文件格式：
image -
需要校验的格式：
image
- 解决方案：很明显不一样
- 删除本地tag：
git tag -d 1.0.0 - 删除远端tag：
git push origin -d tag 1.0.0 - 重新添加本地tag：
git tag -a 1.0.0 -m ‘release 1.0.0’ - 重新上传到远端：
git push origin --tags - 再次校验：
pod spec lint KJEmitterView.podspec
7、[!] There was an error pushing a new version to trunk: execution expired
- 原因：推送过期
- 解决方案：重新将podspec文件传到trunk上
pod trunk push KJEmitterView.podspec
8、- ERROR | [iOS] public_header_files: The pattern includes header files that are not listed in source_files
- 原因：文件夹层次结构过浅，导致无法找到对应的文件
- 解决方案：默认的头文件目录设置为：
- s.public_header_files = 'KJEmitterView/Classes/** / *.h'
- 但是如果Classes目录中，你的代码文件夹层次结构超过两级，就会出现该错误。修改文件层级
9、搜索不到最新版本pod库
- 原因：没有更新pod库
- 解决方案：更新pod库
- pod update 要更新库的名字
- 查看Podfile文件中的依赖库的最新版本：pod outdated
10、代码中有__weak typeof(self) weakSelf = self;
- 原因：有__weak就一直验证不通过
- 解决方案：s.frameworks当中加入可以用__weak的库
11、代码中有dispatch_source_t库相关
- 原因：有
dispatch_source_t相关的库函数，也一直验证不通过 - 解决方案：s.frameworks当中加入可以用
dispatch_source_t的库
12、- ERROR | [KJEmitterView/Classes] xcodebuild: KJEmitterView/KJEmitterView/Classes/AlertView/KJAlertView.m:163:116: error: property 'height' not found on object of type 'UILabel *'
- 原因：未引入头文件UIView+KJFrame在KJAlertView当中
- 解决方案：引入头文件
13、- NOTE | [iOS] [KJEmitterView/Classes] xcodebuild: KJEmitterView/KJEmitterView/Classes/AlertView/KJAlertView.m:10:9: fatal error: 'UIView+KJFrame.h' file not found
- 原因：不在同一个文件夹下面
- 解决方案：修改不引入该头文件的错误，或者将需要引入的头文件和KJAlertView放在同一个文件夹之下。
14、ERROR | name: The name of the spec should match the name of the file.
- 原因：文件名字不一样
- 解决方案：xxx.podspec 文件名必须和文件里面的 s.name 文件名 "xxx" 保持一致
15、ERROR | [iOS] unknown: Encountered an unknown error (Could not find a ios simulator (valid values: com.apple.coresimulator.simruntime.ios-12-2, com.apple.coresimulator.simruntime.tvos-12-2, com.apple.coresimulator.simruntime.watchos-5-2). Ensure that Xcode -> Window -> Devices has at least one ios simulator listed or otherwise add one.) during validation.
- 解决方案：升级CocoaPods，终端执行 sudo gem install cocoapods 代码即可
