使用Cocoapods创建私有库
五一之后，公司要求对代码进行整理，同时进行代码管理、自动化打包等标准化流程，这些东西一直是我想搞的，这次有了公司的支持，操作起来也更顺利了，代码管理、自动化打包会找时间写一篇博客。
这次主要记录利用Cocoapods将多个项目中共用的代码抽离出私有库，方便其他项目的引用，也算是组件化的第一步吧。抽离出私有库的时候，参考了很多的博客，遇到了很多的问题，主要参考了这篇博客。
为什么要进行代码抽离
很多公司不止有一个产品，当项目达到两个及以上的时候，就需要考虑代码的共用（理想情况下）。由于我们公司特殊情况（懒），原来做项目的时候没有考虑这么多，由于公司新项目与原来的项目有大量功能相似，当时我们就采用了创建新分支的形式创建了新项目，导致代码耦合性非常强，平常开发中遇到很多问题，比如：
有些代码可能这个项目需要，那个项目不需要
分支切换太过频繁
创建了大量分支
在这个分支上开发的时候，测试需要另一个项目的包，需要来回切换
。。。。等等
先看下我们原来的代码结构，确实感觉很头疼：
综上所述，代码抽离迫在眉睫。。。。
1、创建私有Spec Repo
Spec Repo其实类似一个容器，里面装着所有的公开的Pods,当使用Cocoapods后，他就会被clone到本地的~/.cocoapods/repos目录下：
因此我们也需要创建一个私有的Spec Repo，因为是公司项目，所以我们搞一个私有库，这次是我单独的练习，GitHub上创建私有库是收费的，所以这次我采用了免费的Git服务，我用的是Coding，首先需要在coding上创建一个自己的git仓库，创建完成之后，在终端下执行如下命令
pod repo add ZJTestSpecs https://coding.net/u/cenzhijun/p/ZJTestSpecs/git
成功的话就会在~/.cocoapods/repos目录下看到ZJTestSpecs文件夹了，第一步完成，这一步通常只需要执行一次
2、创建Pod项目的文件
首先cd到你想创建项目的文件夹执行如下操作
记住一定要创建一个单独的名字，否则以后pod search <私有库>会找到Github上跟你重名的项目
pod lib create ZJPodPrivateTest
之后会出现下列问题：
接下来就是在你的ZJPodPrivateTest文件夹下添加自己的内容，将自己的模块部分放在ZJPodPrivateTest/Classes下，然后cd到Example文件夹下执行pod update命令，之后打开项目，就能在Development Pods/ZJPodPrivateTest文件夹下看到自己添加的组件了，之后需要将项目推送到远端仓库，同样需要先自己去git服务商哪里创建一个私有仓库，然后cd到ZJPodPrivateTest目录，执行如下操作：
git add -A git commit -a -m "init library" git remote add origin https://git.coding.net/cenzhijun/ZJPodPrivateTest.git git push origin master
这个时候执行push操作会报如下错误：
提示你需要先pull下代码，这一步不能直接pull,需要执行如下命令：
git pull origin master --allow-unrelated-histories
有可能会出现冲突，解决冲突之后push代码：
git push origin master
因为podspec文件获取版本控制的项目需要tag号，所以还要搭上一个tag
git tag -m "first release" 0.1.0 git push --tags #推送tag到远端仓库
做完这些之后开始编辑podspec文件，填上对应的信息。
编辑完之后，执行如下命令，验证是否有效，不能有error或者warning：
pod lib lint
当看到
就说明验证通过
3、本地测试podspec文件
自己可以创建一个新项目，在Podfile中指定自己编辑好的podspec文件，如下：（两种方式填写一种就行）
pod 'ZJPodPrivateTest', :path => '~/Desktop/ZJPodPrivateTest' # 指定路径 # pod 'PodTestLibrary', :podspec => '~/Desktop/ZJPodPrivateTest/ZJPodPrivateTest.podspec' # 指定podspec文件
然后执行pod install命令安装，然后打开项目发现库文件已经被加载到Pods子项目中了，不过没有在Pods目录下，而是在Development Pods/ZJPodPrivateTest目录下，因为是本地测试项目，没有吧podspec文件添加到Spec Repo中的缘故
确认无误后，就可以提交podspec到Spec Repo中了
4、提交podspec
提交很简单，只需要一个命令：
pod repo push ZJTestSpecs ZJPodPrivateTest.podspec #前面是本地Repo名字 后面是podspec名字
没有错误之后，就可以在~/.cocoapods/repos/ZJTestSpecs目录下看到自己的私有库了，同时我们远程的Spec Repo也有一次提交，已经被自动push上去了
可以用pod search ZJPodPrivateTest查看自己的库了
*一定要记住自己的创建的私有库一定不要跟Github上的第三方库重名，否则会搜不到，我博客里面有的是ZJPodPrivateTest有的是ZJPodTest，就是因为ZJPodTest跟Github上的一个第三方库重名了，才会又重新建了ZJPodPrivateTest，按照我博客操作的时候ZJPodPrivateTest和ZJPodTest可以认为是同一个仓库，有的截图了，有的忘了，有不明白的，可以问我！！！
至此，自己的私有库就算制作好了
5、使用制作好的Pod
在Podfile文件中，内容如下：
source 'https://github.com/CocoaPods/Specs.git' # 官方库 source 'https://git.coding.net/cenzhijun/ZJTestSpecs.git' # 私有库 platform :ios, '8.0' target 'TargetName' do pod 'AFNetworking', '~> 3.0' pod 'ZJPodPrivateTest', '0.1.0' #自己的私有库 end
至此就算大功告成了
6、更新维护podspec
遇到的坑
错误一
pod lib lint 验证的时候一直报这个错，原因是私有库中添加了动态库或者静态库，解决方案：
pod lib lint --use-libraries
--use-libraries：表示使用静态库或者是framework，这里主要是解决当我们依赖一些framework库后校验提示找不到库的时候用到。
错误二
pod lib lint的时候一直有一些警告，可以忽略掉这些警告：
pod lib lint --allow-warnings
--allow-warnings：表示允许警告
保险起见可以使用：
pod lib lint --use-libraries --allow-warnings
错误三
pod lib lint验证通过，但是repo push的时候却一直报错，又忘截图了，大概是这样的：
xcodebuild: Returned an unsuccessful exit code. You can use `--verbose` for more information
我之所以报这个错，是因为，修改了自己的私有库，打了tag，podspec文件对应的s.version忘了修改了，解决方案：
重新发一个release版的，打上tag之后，修改podspec文件对应的s.version，重新pod repo push
温馨提示：如果你在pod lib lint的时候用到了--use-libraries或者--allow-warnings，那么在pod repo push的时候也要加上这些指令！！！例如：
pod repo push ZJTestSpecs ZJEncryptPodTest.podspec --use-libraries --allow-warnings
总结
创建私有库的时候，尽管我参考的这篇文章已经写得十分详细，但是还是有一个过时的操作，很导致操作错误，尤其是在本地仓库push到远程仓库那里出现问题，同时创建私有库不能和GitHub上存在的第三方库重名也是我摸索很久发现的，希望看到这篇文章的同学能够少走弯路
作者：czj_warrior
链接：https://www.jianshu.com/p/d92a987203b1
正文到此结束
热门推荐
相关文章
近期评论
-
文章和留言都翻到11页了 没有OOM
-
-
朋友，翻页到11页，及以后，会出现OOM，无法访问
-
-
搞个gitee的项目
-
-
版本号是多少，你可以下载哪个代码仓库，jdk选1.8 直接跑就行
-
-
-
Loading...
![[HBLOG]公众号](https://www.liuhaihua.cn/img/qrcode_gzh.jpg)
