开源框架到CocoaPods

上传至CocoaPods和Bug总结

---

一、将代码传到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

---

二、打上标签

打标签的目的就相当于给你的开源框架制定版本号

1．cd仓库目录

2．查看本地tag git tag

3．添加本地tag 1.0.0 git tag -a 1.0.0 -m 'release 1.0.0'

4．将tag传到远程 git push origin --tags

三、删除

1．删除本地tag git tag -d 1.0.0

2．删除远程tag git push origin -d tag 1.0.0

3、删除trunk库指定版本 pod trunk delete KJEmitterView 0.0.1

4、删除pods所有版本 pod trunk deprecate KJEmitterView

• 删除之后，重新pod repo处理 pod repo update

四、注册Trunk

1．注册Trunk pod trunk register 邮箱 '用户名' --description='描述'

成功的话就会受到一份邮件，点击邮件中的链接后验证一下：

2．打开邮箱点击地址：https://trunk.cocoapods.org/sessions/verify/965b5e96

点击红色terminal跳转回到终端

3．注册 pod trunk me

成功会看到如下类似字段：

4．添加新成员（可更改和上传pod库） pod trunk add-owner 名称 邮箱

5．移除成员： pod trunk remove-owner 邮箱地址

---

五、获取MIT文件

1．网页链接 https://choosealicense.com/

复制，修改相应的数据

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" => "393103982@qq.com" }
  s.platform     = :ios
  s.source       = { :git => "https://github.com/yangKJ/KJEmitterView.git", :tag => "#{s.version}" }
  s.social_media_url = 'https://www.jianshu.com/u/c84c00476ab6'
  s.requires_arc = true

  s.default_subspec = 'Kit' # 默认引入的文件
  s.ios.source_files = 'KJEmitterView/KJEmitterHeader.h' # 添加头文件

  s.subspec 'Kit' do |y|
    y.source_files = "KJEmitterView/Kit/**/*.{h,m}" # 添加文件
    y.public_header_files = 'KJEmitterView/Kit/*.h',"KJEmitterView/Kit/**/*.h"   # 添加头文件
    y.frameworks = 'Foundation','UIKit','Accelerate'
  end

  s.subspec 'Control' do |a|
    a.source_files = "KJEmitterView/Control/**/*.{h,m}" # 添加文件
    a.public_header_files = "KJEmitterView/Control/**/*.h",'KJEmitterView/Control/*.h'# 添加头文件
    a.dependency 'KJEmitterView/Kit'
    a.frameworks = 'QuartzCore'
  end

  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}" # 添加数据资料
    ss.dependency 'KJEmitterView/Kit'
  end

  s.subspec 'Function' do |fun|
    fun.source_files = "KJEmitterView/Foundation/**/*.{h,m}" # 添加文件
    fun.public_header_files = 'KJEmitterView/Foundation/*.h',"KJEmitterView/Foundation/**/*.h"   # 添加头文件
    fun.dependency 'KJEmitterView/Kit'
  end
  
end

3．验证你本地的podspec文件 pod spec lint KJEmitterView.podspec

4．忽略警告 pod spec lint KJEmitterView.podspec --allow-warnings

5．忽略警告和看到进度验证 pod spec lint KJEmitterView.podspec --allow-warnings --verbose

6．不需要联网验证 pod lib lint --verbose --allow-warnings

验证成功

---

七、传到CocoaPods上

1．首先验证你本地的podspec文件，之后会上传spec文件到trunk

2．将podspec文件传到trunk上 pod trunk push KJEmitterView.podspec

3．忽略警告上传 pod trunk push KJEmitterView.podspec --allow-warnings

成功如下：

3．一直处于Updating spec repo master 状态，更新一下 pod repo update --verbose

4．检查是否上传成功 pod search KJEmitterView

5. 删除trunk上面的库 pod trunk delete KJEmitterView 0.0.1

八、问题总结

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、license: Unable to find a license file

• 原因：没有找到License文件，根据规则也可以直接把文本写在podspec文件里
• 解决方案：podspec文件里面添加
• s.license = "Copyright (c) 2018 yangkejun"

3、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．最后上传 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，然后再执行搜索

成功如下：

6、校验不通过

可能原因：github上面的tag文件格式已经确定,下图位置下载下来看一下，是否和本地的文件格式保持一致。如果不一致按照下列方式解决bug
解决方案：

- 删除本地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、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 xxx
查看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、[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、[KJEmitterView/Classes] xcodebuild: KJEmitterView/KJEmitterView/Classes/AlertView/KJAlertView.m:10:9: fatal error: ‘UIView+KJFrame.h’ file not found

• 原因：不在同一个文件夹下面
• 解决方案：修改不引入该头文件的错误，或者将需要引入的头文件和KJAlertView放在同一个文件夹之下。

14、name: The name of the spec should match the name of the file.

• 原因：文件名字不一样
• 解决方案：xxx.podspec 文件名必须和文件里面的 s.name 文件名 “xxx” 保持一致

15、

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

16、[KJEmitterView/Control] xcodebuild: KJEmitterView/KJEmitterView/Control/MarqueeLabel/KJMarqueeLabel.m:23:14: warning: null passed to a callee that requires a non-null argument [-Wnonnull]

• 原因：此警告就是某属性说好的不能为空，你又在某地方写了XX = nil 所以冲突
• 解决方案：声明一个属性的时候加上 __nullable（？可以为空）与__nonnull（！不能为空）或者用宏 NS_ASSUME_NONNULL_BEGIN 和 NS_ASSUME_NONNULL_END 包住多个属性全部具备nonnull，然后仅对需要nullable的改下就行

17、[KJEmitterView/Classes] xcodebuild: :19:9: error: declaration of ‘Method’ must be imported from module ‘ObjectiveC.runtime’ before it is required

• 原因：未引入runtime
• 解决方案：在缺少的文件当中引入#import <objc/runtime.h>

######18、RPC failed; curl 56 LibreSSL SSL_read: SSL_ERROR_SYSCALL, errno 54

- ERROR | [iOS] unknown: Encountered an unknown error ([!] /usr/bin/git clone https://github.com/yangKJ/KJPlayerDemo.git /var/folders/fd/yxh686d17s3bfcz11t3_s9ch0000gn/T/d20191022-3327-1a1sjwn --template= --single-branch --depth 1 --branch 1.0.6

Cloning into '/var/folders/fd/yxh686d17s3bfcz11t3_s9ch0000gn/T/d20191022-3327-1a1sjwn'...
error: RPC failed; curl 56 LibreSSL SSL_read: SSL_ERROR_SYSCALL, errno 54
fatal: the remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed
) during validation.

Analyzed 1 podspec.

[!] The spec did not pass validation, due to 1 error.

解决方案：

git config http.postBuffer 524288000
git config https.postBuffer 524288000

19、pod trunk push上传时出错，国内CDN源用不了

Updating spec repo `trunk`
[!] CDN: trunk Repo update failed - 6 error(s):
no block given
no block given

解决方案：
1、移除trunk源pod repo remove trunk
2、升级你的cocoapodssudo gem install cocoapods -n /usr/local/bin

20、pod install 或者 pod upadate xx 时更新错误

Analyzing dependencies
[!] CDN: trunk Repo update failed - 34 error(s):
no block given

解决方案：

21、error: duplicate interface definition for class ‘_KJIFinishTools’

- ERROR | [KJEmitterView/InteriorFinish] xcodebuild:  /Users/yangkejun/Library/Developer/Xcode/DerivedData/App-gpmktkjjgkmqxbewzsgsipmxwyrx/Build/Products/Release-iphonesimulator/KJEmitterView/KJEmitterView.framework/Headers/_KJInteriorFinishTools.h:22:1: error: duplicate interface definition for class '_KJIFinishTools'

原因：_KJInteriorFinishTools.h和_KJIFinishTools文件冲突，之前修改过名字导致多出一个文件
解决方案：找到该文件，删除即可

22、You need to run pod trunk register to register a session first.

解决方案：

pod trunk register 电子邮箱 '您的姓名' --description='描述'

23、CocoaPods could not find compatible versions for pod “KJEmitterView”

[!] CocoaPods could not find compatible versions for pod "KJEmitterView":
  In Podfile:
    KJEmitterView (~> 4.7.9)

None of your spec sources contain a spec satisfying the dependency: `KJEmitterView (~> 4.7.9)`.

解决方案：

快速更新：pod repo update
更新指定库：pod update KJEmitterView