iOS-CocoaPods发布开元框架补充(升级)

上篇文章[Cocoapods发布框架]:http://www.jianshu.com/p/e7c2047e3de1 的文章中,主要介绍了整个流程第一次配置的大致过程, 当然文章看上去是一番丰顺的. 但是, 事实并不是这样. 上篇文章主要讲的是第一次配置的步骤,所以文章篇幅过长, 现把抓哟步骤整理一下,顺便也把遇到的问题单独列了出来.

其实让自己的框架支持cocoapods,只需要几步
1.注册Trunk
2.创建/编辑.podspec
3.将自己的项目打成tag
4.验证
5.发布

用到的主要命令

1.注册Trunk

pod trunk register allisonwangjj@163.com 'Allisonwangjj' --description='第一次发布框架'
[!] Please verify the session by clicking the link in the verification email that has been sent to allisonwangjj@163.com
wuxianlvzhoudeMacBook-Pro:~ Allison$ pod trunk me

此时会收到一封邮件,点击邮件中的链接后验证一下即可.

2.创建/编辑.podspec

wuxianlvzhoudeMacBook-Pro:~ Allison$ cd /Users/wuxianlvzhou/FFAdditions/Additions 
//2.1 创建FFAdditions框架的Podspec描述文件
wuxianlvzhoudeMacBook-Pro:Additions Allison$ pod spec create https://github.com/AllisonWangJiaoJiao/FFAdditions

2.2 编辑.podspec
创建好后打开,删除注释, 前面有#的为注释,整理好你所需要的文件

3.将自己的项目打成tag

执行命令

//为git打tag
git tag "0.0.1" 
//将tag推送到远程仓库
git push --tags

4.验证

wuxianlvzhoudeMacBook-Pro:Additions Allison$ pod spec lint

验证成功后会出现如下信息:
FFAdditions.podspec passed validation.
注意此时可能并不会一帆风顺,可能会出现如下错误

• ERROR

 -> FFAdditions (0.0.1)
    - ERROR | attributes: Missing required attribute `summary`.
    - ERROR | [iOS] unknown: Encountered an unknown error (The `FFAdditions` pod failed to validate due to 1 error.
[!] The validator for Swift projects uses Swift 3.0 by default, if you are using a different version of swift you can use a `.swift-version` file to set the version for your Pod. For example to use Swift 2.3, run: 
    `echo "2.3" > .swift-version`:
    - ERROR | attributes: Missing required attribute `summary`.
) during validation.
Analyzed 1 podspec.
[!] The spec did not pass validation, due to 2 errors.
[!] The validator for Swift projects uses Swift 3.0 by default, if you are using a different version of swift you can use a `.swift-version` file to set the version for your Pod. For example to use Swift 2.3, run: 
    `echo "2.3" > .swift-version`.

原因:没有填写summary信息,需要添加描述信息,如: s.summary = "第一次发布框架"

5.发布

wuxianlvzhoudeMacBook-Pro:Additions Allison$ pod trunk push

如果顺利的话,发布成功会出现如下界面:

Validating podspec
 -> FFAdditions (0.0.3)

Updating spec repo `master`

--------------------------------------------------------------------------------
 ?  Congrats

 ?  FFAdditions (0.0.3) successfully published
 ?  April 26th, 07:55
 ?  https://cocoapods.org/pods/FFAdditions
 ?  Tell your friends!
--------------------------------------------------------------------------------

发布的时候常见的错误:

• ERROR

[!] Found podspec `FFAdditions.podspec`
Updating spec repo `master`
Validating podspec
 -> FFAdditions (0.0.1)
[!] Unable to accept duplicate entry for: FFAdditions (0.0.1)

原因:意思是：不能接受同一版本的提交
解决方案：
5.1、执行如下命令

wuxianlvzhoudeMacBook-Pro:Additions Allison$ git tag 0.0.2
wuxianlvzhoudeMacBook-Pro:Additions Allison$ git push --tags
wuxianlvzhoudeMacBook-Pro:Additions Allison$ git push origin master

5.22、修改FFAdditions.podspec文件中的内容

Pod::Spec.new do |s|
  s.name         = "FFAdditions"
  s.version      = "0.0.2"
  s.summary      = "第一次发布框架"
  s.homepage     = "https://github.com/AllisonWangJiaoJiao/FFAdditions"
  s.license      = "MIT"
  s.author       = { "AllisonWangJiaoJiao" => "email@address.com" }
  s.platform     = :ios, "8.0"
  s.source       = { :git => "https://github.com/AllisonWangJiaoJiao/FFAdditions.git", :tag => s.version }
  s.source_files  = "FFAdditions", "Additions/**/*.{h,m}"
  s.requires_arc = true
end

5.3 3、执行命令 pod spec lint 验证并提交到CocoPods

wuxianlvzhoudeMacBook-Pro:Additions Allison$ pod spec lint
wuxianlvzhoudeMacBook-Pro:Additions Allison$ pod trunk push FFAdditions.podspec

到此大功告成,我们要尝试一下在终端执行 pod search FFAdditions,如果能搜到,代表你上传git的这个库,支持cocoapods了.但是我自己在操作的时候,悲催的发现执行这个 pod search FFAdditions命令的时候,出现这个错误
[!] Unable to find a pod with name, author, summary, or description matching 'FFAdditions'
这个时候只需要command+shift+G调出来前往文件夹的窗口,输入~/Library/Caches/CocoaPods/search_index.json文件将search_index.json删除,或者在终端执行rm ~/Library/Caches/CocoaPods/search_index.json
删除成功后再执行pod search,如果此时还是搜不到,
终端输入：pod setup
会出现Setting up CocoaPods master repo，稍等几十秒，最底下会输出Setup completed。说明执行pod setup成功。
如果pod search操作还是搜索失败,建议在终端多执行几次rm ~/Library/Caches/CocoaPods/search_index.json,然后再执行再执行pod search,稍等片刻就会出现你所要搜的类库了。

1.png

是不是和我们平时在GitHub上看到的一样了呢,小伙伴们,赶快动手试一下吧.?

框架的优化
上面我们已经将框架发布到cocoapods上了,但是我们在控制台搜索AFNetworking的时候发现,AFN有很多Subspecs,也就是我们可以单独导入某一个子类

-> AFNetworking (3.1.0)
   A delightful iOS and OS X networking framework.
   pod 'AFNetworking', '~> 3.1.0'
   - Homepage: https://github.com/AFNetworking/AFNetworking
   - Source:   https://github.com/AFNetworking/AFNetworking.git
   - Versions: 3.1.0, 3.0.4, 3.0.3, 3.0.2, 3.0.1, 3.0.0, 3.0.0-beta.3,
   3.0.0-beta.2, 3.0.0-beta.1, 2.6.3, 2.6.2, 2.6.1, 2.6.0, 2.5.4, 2.5.3, 2.5.2,
   2.5.1, 2.5.0, 2.4.1, 2.4.0, 2.3.1, 2.3.0, 2.2.4, 2.2.3, 2.2.2, 2.2.1, 2.2.0,
   2.1.0, 2.0.3, 2.0.2, 2.0.1, 2.0.0, 2.0.0-RC3, 2.0.0-RC2, 2.0.0-RC1, 1.3.4,
   1.3.3, 1.3.2, 1.3.1, 1.3.0, 1.2.1, 1.2.0, 1.1.0, 1.0.1, 1.0, 1.0RC3, 1.0RC2,
   1.0RC1, 0.10.1, 0.10.0, 0.9.2, 0.9.1, 0.9.0, 0.7.0, 0.5.1 [master repo]
   - Subspecs:
     - AFNetworking/Serialization (3.1.0)
     - AFNetworking/Security (3.1.0)
     - AFNetworking/Reachability (3.1.0)
     - AFNetworking/NSURLSession (3.1.0)
     - AFNetworking/UIKit (3.1.0)

其实我们也可以将我们自己的框架分成许多的子类.找到我们自己的框架,新建分类文件夹,步骤如下:

1.png

1. 使用Xcode打开YFAdditions.podspec文件

将这段话替换成下面的三句 s.source_files = "YFAdditions", "Additions//.{h,m}"*

s.subspec 'NSArray' do |n|
n.source_files = "YFAdditions", "Additions/NSArray/*/.{h,m}"
end

s.subspec 'NSAttributedString' do |att|
att.source_files = "YFAdditions", "Additions/NSAttributedString/*/.{h,m}"
end

s.subspec 'Runtime' do |r|
r.source_files = "YFAdditions", "Additions/Runtime/*/.{h,m}"
end

2. 验证spec文件

wuxianlvzhoudeMacBook-Pro:Additions Allison$ pod spec lint

 -> YFAdditions (1.0.1)

Analyzed 1 podspec.

YFAdditions.podspec passed validation.

3.打tag

wuxianlvzhoudeMacBook-Pro:TEST Allison$ git tag 'v1.0.2'

4.把框架推送到git上

wuxianlvzhoudeMacBook-Pro:Additions Allison$ pod trunk push
//出现一下界面代表成功
Validating podspec
 -> YFAdditions (1.0.1)

Updating spec repo `master`
....
----------------------------------------------------------------------------
 ?  Congrats

 ?  YFAdditions (1.0.1) successfully published
 ?  August 7th, 01:44
 ?  https://cocoapods.org/pods/YFAdditions
 ?  Tell your friends!
--------------------------------------------------------------------------------

4.在控制台搜索YFAdditions,出现以下信息代表成功

-> YFAdditions (1.0.1)
   YFAdditions框架
   pod 'YFAdditions', '~> 1.0.1'
   - Homepage: https://github.com/AllisonWangJiaoJiao/YFAdditions
   - Source:   https://github.com/AllisonWangJiaoJiao/YFAdditions.git
   - Versions: 1.0.1, 1.0.0 [master repo]
   - Subspecs:
     - YFAdditions/NSArray (1.0.1)
     - YFAdditions/NSAttributedString (1.0.1)
     - YFAdditions/Runtime (1.0.1)

5.安装你自己的库里面的某个分类,例如我需要 pod 'YFAdditions/NSArray', '~> 1.0.1'库,然后在终端执行pod install命令
注:这是可能会出现如下的error信息

[!] Error installing YFAdditions
[!] /usr/local/bin/git clone https://github.com/AllisonWangJiaoJiao/YFAdditions.git /var/folders/25/frh3dbts1mx9121vthcxqfrm0000gn/T/d20170807-14910-1fgegha --template= --single-branch --depth 1 --branch 1.0.1

Cloning into '/var/folders/25/frh3dbts1mx9121vthcxqfrm0000gn/T/d20170807-14910-1fgegha'...
warning: Could not find remote branch 1.0.1 to clone.
fatal: Remote branch 1.0.1 not found in upstream origin

这里是个隐藏很深的bug,因为你打tag的时候没有加"v"所报了这个错,当然如果你使用sourcetree操作的,可能并不会出现(不晓得什么原因),这里只需要重新打下tag,然后在推送到git,再次pod install即可

2.png

如果框架中有多个Subspecs,但是你仅仅需要其中的某几个,可以分别写也可以用统一的写法(两种写法效果相同):
方法一:
pod 'YFAdditions/NSArray'
pod 'YFAdditions/NSAttributedString'
方法二:
pod 'YFAdditions/NSArray', :subspecs => ['NSArray','NSAttributedString']