iOS CocoaPods私有库

级别： ★★☆☆☆
标签：「iOS」「CocoaPods」「私有库」
作者： 忆思梦
审校： QiShare团队

先说下CocoaPods拉取开源库的原理：

CocoaPods 有一个开源的索引仓库Specs，仓库存放着所有开源库的各个版本的.podspec文件，.podspec文件包含中记录着源码的地址。首次使用CocoaPods时，会将这个文件库克隆到本地~/.cocoapods/repos/master。

1. 在Podfile目录下执行 pod install 命令，会从本地的索引库查找该库的.podsepc，如果本地不存在会从远程拉取最新的索引库。
2. 根据索引库中查到的.podspec文件内容，获取源码地址。
3. 从源码地址拉取对应版本的代码。

使用是可以发现，首次导入一个开源库时速度较慢，之后再导入时会很快。是因为CocoaPods在本地会有一个缓存目录，存放开源库的源码，首次下载后，再次导入该库时，会直接从本地复制过去。

查看缓存列表使用pod cache list,缓存路径为~/Library/Caches/CocoaPods/Pods/。

私有仓库

私有库的创建

由于CocoaPods的索引仓库是开源的，所有人都可以访问。公司的项目如果也想使用CocoaPods管理源码，而不开放源码的话，我们可以通过创建私有仓库来模拟官方的Specs仓库。

步骤：

1. 在私有git上创建一个索引仓库，例：YSMSpecs，用于存放索引文件。

2. 将远程索引库添加到本地，pod repo add YSMSpecs YSMSpecs_source_url。使用pod repo可以查看本地的索引仓库列表。

   $ pod repo add YSMSpecs https://github.com/yisimeng/YSMSpecs.git
   $ pod repo
   
   master   // 公有索引仓库
   - Type: git (master)
   - URL:  https://github.com/CocoaPods/Specs.git
   - Path: /Users/duanzengguang/.cocoapods/repos/master
   YSMSpecs  //私有索引仓库
   - Type: git (master)
   - URL:  https://github.com/yisimeng/YSMSpecs.git
   - Path: /Users/duanzengguang/.cocoapods/repos/YSMSpecs
   

3. 本地创建我们的源码工程，可以使用pod lib create YSMKit，创建一个模板工程。

4. 在模板工程里进行开发并替换 ReplaceMe 文件，修改.podspec文件(版本号，源码地址)，推送到远程源码仓库，打tag，提交。源码仓库部署完成。

5. CocoaPods不允许有Podspecs lints错误，所以需要进行Podspecs lints（翻译不好，会检查语法错误）验证。这里可以使用pod lib lint或者pod spec lint,区别在于前者不会联网，而后者还会检查外部的仓库和相关的标签。

   $ pod lib lint
   -> YSMKit (0.1.0)
   YSMKit passed validation.
   

6. 检查没有错误之后，推送.podspec文件到本地的索引仓库，本地索引仓库会自动push到远程索引仓库。pod repo push YSMSpecs YSMKit.podspec，这一步会自动进行pod spec lint联网检查。索引库部分完成。

   $ pod repo push YSMSpecs YSMKit.podspec
   Validating spec
    -> YSMKit (0.1.0)
   Updating the `YSMSpecs' repo
   Already up to date.
   Adding the spec to the `YSMSpecs' repo
    - [Add] YSMKit (0.1.0)
   Pushing the `YSMSpecs' repo   // 会自动推送到远程仓库
   
   $ pod search YSMKit
   -> YSMKit (0.1.0)
      YSMKit is my kit
      pod 'YSMKit', '~> 0.1.0'
      - Versions: 0.1.0 [YSMSpecs repo]
   

到这里私有仓库是搞完了。

第6步如果使用pod trunk push YSMKit.podspec，会将索引库推送到官方的Specs仓库中。

私有库的使用

1. 在宿主工程的Podifle文件中引入私有库：pod 'YSMKit'
2. 在文件的最上方添加索引库地址

source 'https://github.com/yisimeng/YSMSpecs.git'
source 'https://github.com/CocoaPods/Specs.git'

然后执行 pod install，就可以使用了。

注意： 如果用到了其他开源库的话，一定要加上官方Specs地址，否则只会去查找私有索引库。

私有库的维护

后续需要更新维护仓库代码的流程：

1. 在源码工程修改代码之后，修改.podspec文件版本号，把源码提交，打上tag，推送到远程仓库。
2. 把.podspec文件提交到本地的私有索引库中（会自动帮我们提交到远程索引库）。
3. 回到宿主工程，修改Podfile中的版本，执行pod install（不行就pod update）。

注意事项

1. 在podfile文件中 增加inhibit_all_warnings!，这样pod的工程不会显示任何警告。
2. 切记：swift中需要设置好访问权限！！!
3. 新引入一些库之后执行pod install，会报错Build Settings，例如：引入Swift库之后经常会报的“swift version”的错误，需要去修改Build Setting，其实可以在Podfile中的post_install中修改。

post_install do |installer|
    installer.pods_project.targets.each do |target|
        target.build_configurations.each do |config|
            config.build_settings['SWIFT_VERSION'] = '3.2'
        end
    end
end

pre_install：编译之前可以添加修改（还没想到可以做哪些事情）。

---

小编微信：可加并拉入《QiShare技术交流群》。

关注我们的途径有：
QiShare(简书)
QiShare(掘金)
QiShare(知乎)
QiShare(GitHub)
QiShare(CocoaChina)
QiShare(StackOverflow)
QiShare(微信公众号)

推荐文章：
iOS 签名机制
iOS 扫描二维码/条形码
iOS 了解Xcode Bitcode
iOS 重绘之drawRect
奇舞周刊