CocoaPods 远程私有库
前言
随着iOS APP越来越复杂，功能越来越多，对于iOS项目的工程化要求也越来越高了，对于复杂的APP一般都需要对项目进行模块化管理，由此引出了iOS组件化开发。
iOS组件化开发很重要的一个技术点：CocoaPods私有库的搭建。
私有库由两部分构成项目工程仓库和索引仓库。
文章较长，先列一下操作步骤
一、创建一个私有的索引库（spec repo）的远程库。
二、创建一个私有的存放项目工程的远程库。
三、创建索引库（spec repo）。
四、创建项目工程，并上传到远程私有仓库。
五、向私有的索引库（spec repo）远程库提交索引（podspec）。
六、使用自己创建的私有库。
七、版本更新。
八、.podspec文件说明。
详细步骤
(注：github创建私有项目是收费的，所以这里选择免费的“码云”）
一、创建一个私有的索引库（spec repo）的远程库。
1.创建索引远程库存放本地索引。
image.png
二、创建一个私有的存放项目工程的远程库。
image.png
三、创建索引库（spec repo）。
前往文件夹 ~/.cocoapods/repos，打开终端，在终端切换到当前目录下，然后进行pod repo add操作，在终端输入:
pod repo add CZSpec https://gitee.com/__/czspec.git
注：https://gitee.com/__/czspec.git是刚创建好的索引库（spec Repo）的私有远程库地址。
image.png
pod repo add操作后会clone远程索引库到 ~/.cocoapods/repos文件夹下
image.png
四、创建项目工程，并上传到远程私有仓库。
创建本地pod所需的项目工程文件，在终端，cd切换到某个目录下，这里我选择的是桌面上文件夹Test目录下的，然后执行
pod lib create CZProject
image.png
超时了多执行几次命令就好了
pod lib create CZProject
image.png
image.png
然后进入到CZProject里面找到Classes中的"ReplaceMe.m"文件删除，然后将自己所需要的文件放到这里目录下
image.png
接下来最重要的一步，也是很容易忽略的一步，不然提交后检查会出现很多问题。
具体步骤：
（1）cd 到Example文件下，然后pod install下，更新Example项目的pod。
image.png
(2）打开example中的项目，找到项目中的podspec文件,更改spec。
image.png
修改完成后,cd 到CZProject目录下，然后验证本地podspec文件有效性，终端命令如下
pod lib lint CZProject.podspec
image.png
报了个警告提示用--allow-warnings 忽略,再次执行命令
pod lib lint CZProject.podspec --allow-warnings
本地项目上传到远程仓库中,将本地项目与远程仓库相关联，使用终端命令：
git remote add origin 远程仓库地址
然后将本地项目推送到远端
git push origin master
image.png
push到远程的时候出现这种问题,然后先pull ,出现下面问题（即拒绝合并不相关的历史，确实本地新加的内容还从未和线上连接过）
之后输入如下命令（即告诉允许合并不相关的历史内容）:
git pull origin master --allow-unrelated-histories
image.png
解决冲突后上传到远程仓库
image.png
这样远程仓库就有我们本地的项目了
image.png
image.png
五、向私有的索引库（spec repo）远程库提交索引（podspec）。
首先需要给CZProject 打标签，打的标签值要与podspec文件中的版本号一致
image.png
image.png
然后进行.podspec文件本地和远程有效性的验证，终端命令如下：
pod spec lint CZProject.podspec
image.png
同样报了个警告，再次执行命令,忽略警告
pod spec lint CZProject.podspec --allow-warnings
注意:
如果私有库中依赖私有库，则验证podspec文件的时候需要加上–sources参数，否则会出现找不到你依赖的私有库，示例：
pod spec lint yourProjectName.podspec -- sources='git@xxx.xxx.xxx.xxx:/yourProjectName.git,https://github.com/CocoaPods/Specs
向私有的索引库（spec Repo）远程仓库中提交podspec
使用命令把私有库添加到私有远程库中。
pod repo push CZSpec CZProject.podspec --verbose --allow-warnings
image.png
前往文件夹 ~/.cocoapods/repos去查看CZSpec目录下的文件如下:
image.png
之后，可以通过终端命令查看第三方框架仓库源，命令如下：
pod repo
image.png
到此，创建私有库成功了。
六、使用自己创建的私有库。
创建一个新的工程，在podfile 使用source 指定：
image.png
然后跳转到项目目录，执行终端命令pod install，之后就可以使用了。
image.png
image.png
七、版本更新。
找到工程库打开CZProject.xcworkspace
1.修改.podspec文件中的版本号
s.version = '0.1.1' //修改0.1.1版本，不能是之前的版本，要不提交不成功
2.项目上传到远程仓库
$ git add .
$ git commit -m “XX”
$ git push
3.打tag并上传
$ git tag '0.1.1'
$ git push --tags
4.验证pod并提交到pod
$ pod spec lint CZProject.podspec --allow-warnings //远程本地pod验证
$ pod repo push CZSpec CZProject.podspec --verbose --allow-warnings //提交pod CZSpec 是之前生成的本地库名 CZProject.podspec 工程索引文件
八、.podspec文件说明。
Pod::Spec.new do |s|
# 项目的名称
s.name = 'CZProject'
# 项目的版本号,通过项目git的tag标签进行对应,这里的标签代表的版本
s.version = '0.1.0'
# 项目简单的描述信息
s.summary = 'A short description of CZProject.'
# 项目的详细描述信息,注意,这里的文字的长度,一定要比上面的s.summary长,不然会认为格式不合格
s.description = <<-DESC
TODO: Add long description of the pod here.
DESC
# 项目的网页主页信息,这里可以直接写自己的远程仓库的主页的地址
s.homepage = 'https://www.baidu.com'
# 截图
# s.screenshots = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
# 开源协议
s.license = { :type => 'MIT', :file => 'LICENSE' }
# 作者信息
s.author = { 'chaozai' => '164125801@qq.com' }
# 项目地址,这里不支持ssh的地址,验证不通过,只支持HTTP和HTTPS,最好使用HTTPS
s.source = { :git => 'https://gitee.com/___/czproject', :tag => s.version.to_s }
# 多媒体介绍地址
# s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'
# 支持的平台及版本
s.ios.deployment_target = '9.0'
# 代码源文件地址,**/*表示Classes目录及其子目录下所有文件,如果有多个目录下则用逗号分开,如果需要在项目中分组显示,这里也要做相应的设置
s.source_files = 'CZProject/Classes/**/*'
# 资源文件地址
# s.resource_bundles = {
# 'CZProject' => ['CZProject/Assets/*.png']
# }
# 公开头文件地址
# s.public_header_files = 'Pod/Classes/**/*.h'
# 所需的framework,多个用逗号隔开
# s.frameworks = 'UIKit', 'MapKit'
# 依赖关系,该项目所依赖的其他,当在加载的时候也会一块把相关的依赖的库加载下来,如果有多个需要填写多个
# s.dependency 'AFNetworking', '~> 2.3'
end
