为什么要进行代码抽离
很多公司不止有一个产品,当项目达到两个及以上的时候,就需要考虑代码的共用(理想情况下)。由于我们公司特殊情况(懒),原来做项目的时候没有考虑这么多,由于公司新项目与原来的项目有大量功能相似,当时我们就采用了创建新分支的形式创建了新项目,导致代码耦合性非常强,平常开发中遇到很多问题,比如:
-
有些代码可能这个项目需要,那个项目不需要
-
分支切换太过频繁
-
创建了大量分支
-
在这个分支上开发的时候,测试需要另一个项目的包,需要来回切换
-
。。。。等等
先看下我们原来的代码结构,确实感觉很头疼:
综上所述,代码抽离迫在眉睫。。。。
1、创建私有Spec Repo
Spec Repo其实类似一个容器,里面装着所有的公开的Pods,当使用Cocoapods后,他就会被clone到本地的~/.cocoapods/repos目录下:
因此我们也需要创建一个私有的Spec Repo,因为是公司项目,所以我们搞一个私有库,这次是我单独的练习,GitHub上创建私有库是收费的,所以这次我采用了免费的Git服务,我用的是Coding,首先需要在coding上创建一个自己的git仓库,创建完成之后,在终端下执行如下命令
1 |
|
成功的话就会在~/.cocoapods/repos目录下看到ZJTestSpecs文件夹了,第一步完成,这一步通常只需要执行一次
2、创建Pod项目的文件
首先cd到你想创建项目的文件夹执行如下操作
记住一定要创建一个单独的名字,否则以后pod search <私有库>会找到Github上跟你重名的项目
1 |
|
之后会出现下列问题:
接下来就是在你的ZJPodPrivateTest文件夹下添加自己的内容,将自己的模块部分放在ZJPodPrivateTest/Classes下,然后cd到Example文件夹下执行pod update命令,之后打开项目,就能在Development Pods/ZJPodPrivateTest文件夹下看到自己添加的组件了,之后需要将项目推送到远端仓库,同样需要先自己去git服务商哪里创建一个私有仓库,然后cd到ZJPodPrivateTest目录,执行如下操作:
1 2 3 4 5 |
|
这个时候执行push操作会报如下错误:
提示你需要先pull下代码,这一步不能直接pull,需要执行如下命令:
1 |
|
有可能会出现冲突,解决冲突之后push代码:
1 |
|
因为podspec文件获取版本控制的项目需要tag号,所以还要搭上一个tag
1 2 |
|
做完这些之后开始编辑podspec文件,填上对应的信息。
编辑完之后,执行如下命令,验证是否有效,不能有error或者warning:
1 |
|
当看到
就说明验证通过
3、本地测试podspec文件
自己可以创建一个新项目,在Podfile中指定自己编辑好的podspec文件,如下:(两种方式填写一种就行)
1 2 |
|
然后执行pod install命令安装,然后打开项目发现库文件已经被加载到Pods子项目中了,不过没有在Pods目录下,而是在Development Pods/ZJPodPrivateTest目录下,因为是本地测试项目,没有吧podspec文件添加到Spec Repo中的缘故
确认无误后,就可以提交podspec到Spec Repo中了
4、提交podspec
提交很简单,只需要一个命令:
1 |
|
没有错误之后,就可以在~/.cocoapods/repos/ZJTestSpecs目录下看到自己的私有库了,同时我们远程的Spec Repo也有一次提交,已经被自动push上去了
可以用pod search ZJPodPrivateTest查看自己的库了
*一定要记住自己的创建的私有库一定不要跟Github上的第三方库重名,否则会搜不到,我博客里面有的是ZJPodPrivateTest有的是ZJPodTest,就是因为ZJPodTest跟Github上的一个第三方库重名了,才会又重新建了ZJPodPrivateTest,按照我博客操作的时候ZJPodPrivateTest和ZJPodTest可以认为是同一个仓库,有的截图了,有的忘了,有不明白的,可以问我!!!
至此,自己的私有库就算制作好了
5、使用制作好的Pod
在Podfile文件中,内容如下:
1 2 3 4 5 6 7 8 9 |
|
至此就算大功告成了
6、更新维护podspec
遇到的坑
错误一
pod lib lint 验证的时候一直报这个错,原因是私有库中添加了动态库或者静态库,解决方案:
1 |
|
--use-libraries:表示使用静态库或者是framework,这里主要是解决当我们依赖一些framework库后校验提示找不到库的时候用到。
错误二
pod lib lint的时候一直有一些警告,可以忽略掉这些警告:
1 |
|
--allow-warnings:表示允许警告
保险起见可以使用:
1 |
|
错误三
pod lib lint验证通过,但是repo push的时候却一直报错,又忘截图了,大概是这样的:
1 |
|
我之所以报这个错,是因为,修改了自己的私有库,打了tag,podspec文件对应的s.version忘了修改了,解决方案:
重新发一个release版的,打上tag之后,修改podspec文件对应的s.version,重新pod repo push
温馨提示:如果你在pod lib lint的时候用到了--use-libraries或者--allow-warnings,那么在pod repo push的时候也要加上这些指令!!!例如:
1 |
|
总结
创建私有库的时候,尽管我参考的这篇文章已经写得十分详细,但是还是有一个过时的操作,很导致操作错误,尤其是在本地仓库push到远程仓库那里出现问题,同时创建私有库不能和GitHub上存在的第三方库重名也是我摸索很久发现的,希望看到这篇文章的同学能够少走弯路
本文来源:http://www.cocoachina.com/ios/20180516/23394.html (如有侵权,请联系删除)