Cocoapods公有库与私有库

导语

Cocoapods是iOS开发中一款优秀的包管理工具，由于其使用起来简单、高效，得到了广泛的使用。为什么要使用Cocoapods来管理第三方库呢？Cocoapods背后的原理是什么呢？如何制作出属于自己的私有库？如何制作属于自己的公有库呢？

为什么要使用Cocoapods来管理第三方库呢？

• 传统使用第三方库的劣势

  1. 使用一个第三方SDK，需要在工程里面添加一堆配置，少添加一步配置就会报一大堆错误。这个时候为了排查少了哪一个步骤，只能从头开始重做一遍，太浪费时间和精力。有些配置还不好配置，就更使人烦躁郁闷了。
  2. 如果使用的第三方SDK有比较重要的更新，想使用最新的SDK只能到官方下载最新的SDK，重新导入到自己的项目工程中。
  3. 如果公司有多个项目，每一个工程都这样配置一遍，这是多么痛苦的领悟呀。

• 使用Cocoapods管理第三方库的优势
  我们看下使用Cocoapods是如何管理一个第三方库的？在Podfile里面写入这些内容：
  platform :ios, '8.0'
  use_frameworks!

  target 'MyApp' do
    pod 'AFNetworking'
    pod 'ORStackView'
    pod 'SwiftyJSON'
  end‘
  

上面做完之后，只需要在命令终端敲入以下命令即可完成安装：
$ pod install
是不是很简单，只需要敲入pod install命令，就能完成各种繁琐的配置，如果第三方库有更新，只需要敲入以下命令即可完成更新：
$ pod update --no-repo-update #--no-repo-update忽略本地repo更新，这个会在下面做解释的。

• Cocoapods私有库带来的好处
  至此我们已经大概了解了一下使用Cocoapods管理第三方库的优势，但是我们会发现这些都是公有的库。如果公司内部实现一些私有的组件，不对外公开，而有想在不同项目中使用，改怎么办呢？使用Cocoapods制作私有库就完美的解决了这个问题。下图就是使用私有库带给我们的好处：

Cocoapods-01.png

通过图我们也可以看到，相同的代码只需要维护一份即可，遵循了软件的设计原则，don't repeat.

Cocoapods原理

关于具体的原理，可以参考Objc上的这篇文章：http://objccn.io/issue-6-4/
Cocoapods是如何实现查找第三方库呢？我自己是这样理解的，如下图：

Cocoapods-02.png

从图中，可以看到通过.podspec可以找到我们想要的第三方库，那么.spec是什么呢？如下：

Pod::Spec.new do |s|
   s.name         = "CategoryComponents" #名称
   s.version      = "0.0.2" #版本号
   s.summary      = "bruce CategoryComponents." #描述

   s.homepage     = "https://coding.net/u/Bruce_ChenQi/p/DDNPrivatePods" #描述页面
   s.license      = "MIT" #版权声明
   s.author       = { "guoshimeihua" => "cqdeyouxiang@163.com" } #作者信息

   s.platform     = :ios, "7.0" #使用平台
   s.source       = { :git => "https://git.coding.net/Bruce_ChenQi/DDNPrivatePods.git", :tag => "0.0.2" } #源码地址

   s.source_files  = "Classes", "Classes/**/*.{h,m}" #源码文件
   s.frameworks = "CoreGraphics", "CoreFoundation", "Foundation", "UIKit" #依赖的framework
   s.requires_arc = true #是否支持ARC
end

至此，我们明白了查找到第三方库背后的原理。但是，具体如何进行搜索的呢？

先解释一个概念，什么是Spec Repo？它是所有的Pods的一个索引，也就是一个容器（集合），所有公开的Pods都在这个里面。实际上就是一个Git仓库remote端，当你使用了Cocoapods，这个仓库会被clone到本地的~/.cocoapods/repos目录下，进入到这个文件下可以看到master文件夹，就是官方的Spec Repo了。当你pod search的时候就在master这个文件下面查找的。

如何制作出属于自己的私有库？

1. 先创建出一个私有仓库，大家可以在coding上创建一个私有库（免费的）。

2. 先cd到你要创建私有库的目录下面，然后把刚才创建的私有库从remote端clone到本地，clone完成后，如下图:

   
   Cocoapods-03.png
   

   MyPods是我创建出来的文件夹，MyPrivatePods是从remote端clone到本地的。

3. 在MyPrivatePods文件目录下，创建一个Classes文件，用来存放源码文件。创建完成如下：

   
   CocoaPods-04.png

4. 在MyPrivatePods目录下创建.podspec文件，先在终端cd到该目录下，然后输入以下命令：

   pod spec create BruceCategoryComponents
   

其中BruceCategoryComponents是我自己起的spec_name，可以根据自己的需要改成自己想要的名字。创建完成后如下图：

Cocoapods-05.png

5. 然后用Xcode打开.podspec文件，进行编辑，怎么进行编辑可以参考Cocoapods原理那部分，有提到的。编辑完成后，在终端可以输入

   pod lib lint
   

编辑成功后，会出现以下提示的：

Cocoapods-06.png

否则的话，根据终端提示的错误信息，进行修改，直到验证成功。

6. 为了测试的方便，我们在MyPrivatePods目录下创建一个demo工程，这样方便以后对私有库进行维护更新与测试，创建完成后如下图：

   
   Cocoapods-07.png
   

   把Classes源文件拷贝到demo工程里面，这样方便其他人也对该私有库进行维护，添加新的功能。

7. 往coding上提交刚才的修改，并打上tag标签。一定要记得打上tag标签，且与刚才编辑.podspec里面写的版本号一致。

   
   Cocoapods-08.png

8. 创建属于自己的私有库中心，为什么要创建自己的私有库，可以参照Cocoapods原理部分讲的。敲入以下命令即可：

   pod repo add BrucePods https://git.coding.net/Bruce_ChenQi/MyPrivatePods.git
   

创建成功后，可以进入~/.cocoapods/repos目录下可以看到BrucePods文件。如下图：

Cocoapods-09.png

9. 下面就是把BruceCategoryComponents.podspec添加到私有库中心，如下：

   pod repo push BrucePods BruceCategoryComponents.podspec
   

添加成功后，如下图：

Cocoapods-10.png

可以进入到BrucePods目录下查看一下现在的文件目录结构：

Cocoapods-11.png

10. 这个时候，就可以通过pod search命令搜索到刚才创建的私有库了。如下所示：

    
    Cocoapods-12.png

到这个步骤我们的私有库就制作完成了。来测试一下，我们的私有库是否能够正常使用。我们创建一个新的工程，在Podfile文件中，写入以下内容：

target 'BruceDemo' do
   platform :ios, '7.0'
   pod 'BruceCategoryComponents'
end

然后运行pod install --no-repo-update命令，但是结果却如下：

Cocoapods-13.png
这是为什么呢？因为需要指明仓库的来源才可以的。添加以下两句话就可以了。
公有仓库
source 'https://github.com/CocoaPods/Specs.git'
私有仓库
source 'https://git.coding.net/Bruce_ChenQi/MyPrivatePods.git'

11. 私有库的升级、分支
    在对私有库进行升级维护的时候，测试没有问题后，只需要重新编辑.podspec文件，修改相应的版本号，再次执行下面命令即可：

    pod repo push BrucePods BruceCategoryComponents.podspec
    

想创建分支的话，只需对subspec进行设置即可。

12. 删除私有库
    如果想要删除私有库，需要分两步，第一步删除coding上创建的私有库。第二部，到~/.cocoapods/repos目录下，通过以下命令行即可删除：

    rm -rf BrucePods
    

13. 其他项目组成员如何使用私有库
    首先在coding上面给其他成员添加相应的权限。另外，在其电脑上执行以下命令即可：
    pod repo add BrucePods https://git.coding.net/Bruce_ChenQi/MyPrivatePods.git

如何制作属于自己的公有库呢？

公有库的制作和私有库的制作很多都是相同的，唯一不同的就是把.podspec文件提交到公有仓库里面了。以前Cocoapods组件的提交方式是通过pull request进行的，现在改成trunk自动化的提交方式。Trunk自动化提交有下面几个步骤：

1. 首次使用trunk的时候，需要注册自己的电脑：
   // pod trunk register [E-mail] [User Name]
   $ pod trunk register cqdeyouxiang@163.com "bruce"

2. 执行完成之后，会受到一封验证邮件，按邮件提示完成验证即可。
   注册流程完成之后，可以使用
   pod trunk me
   验证一下自己是否注册成功，成功后，会看到一下输出的：

   
   Cocoapods-14.png
3. 接下来重复制作私有库1-7步骤，注意此时应该在github上创建一个公有的仓库，其他不变。
   1-7步骤做完之后，执行提交命令，如下：
   pod trunk push BRCategoryComponents.podspec
   只需要这一条命令，组件就被推送到Cocoapods的主仓库中了。
4. 可以通过pod search来搜索刚才自己创建的公有组件，如下图：

Cocoapods-15.png

总结

希望这篇文章能帮助大家可以创建出自己的私有库和公有库，文章有什么错误的地方，欢迎大家指正。
我的联系方式：cqdeyouxiang@163.com 微信号：BruceGuoShi

mine_wx.png

参考文章

http://blog.wtlucky.com/blog/2015/02/26/create-private-podspec/
http://foggry.com/blog/2016/03/23/cocoapods-xiang-jie-zhi-geng-xin-pian/
https://blog.cnbluebox.com/blog/2014/03/31/cocoapodsdai-ma-guan-li/

国士梅花

欢迎大家关注国士梅花，技术路上与你陪伴。

guoshimeihua.jpg