关于创建私有Cocoapods仓库和组件化项目的资料网上已经很多了,这里我们就不再讲解。这里主要是对根据各方面资料的操作的大体流程进行记录以及重点标记一些需要注意的细节。
开始正文,这里我们将组件化项目分为两步:
- 1.生成对应的.podspec配置文件;
- 2.将.podspec配置文件push到Cocoapods私有仓库中;
1.创建pods工程 配置.podspec文件
cocoapods官方建议我们使用pods工程项目创建.podspec配置文件,因为这样可以让我们在Demo中检测.podspec文件和涉及到的class(依赖库代码文件)的代码功能是否正常。
- 创建名字为MyLibary的pods工程项目
pod lib create MyLibary
中间会要求做一些命令选择,如:是否创建Demo工程等,具体见官方手册这里我们没有选择Demo工程,生成的pods工程目录如下:
这里每次在Class中引入或更新了代码后,如果引入了Demo工程,要在Demo工程中使用的话,需要先cd到Demo工程中,进行pod update 或 pod install操作。
对应的文件夹目录如下:
- 修改.podspec配置文件
使用了上一步创建pods工程,.podspec文件就自动生成了,这一点跟网上大多数直接创建.podspec文件略有不同,请注意。
首先我们打开.podspec文件:
.podspec文件使用的Ruby语言,具体的参数含义请查看官方手册,这大部分参数已经自动配置好了,但是仍然需要特别小心。红色标注的部分代表了重点注意,其中s.homepage和s.source代码了cocoapods获取依赖库代码文件的路径,必填。
将下方创建的代码托管仓库的gitHub地址填入s.homepage 和 s.source,如图所示:
在自己公司的git上创建一个依赖库代码文件托管的仓库,.podspec会根据s.source找到这个仓库,来拉去依赖库。为了方便,这里我们选择在gitHub上建仓库讲解。但是你不能这么做,除非你想公开公司的代码文件。
- 创建名字为Components的代码托管仓库;
- 拉取仓库到本地;
# git clone [仓库地址]
- 制作完成后将需要托管的代码文件拷贝到到git托管仓库中
- �推送托管库:
cd到git托管库中- 打版本号
# set the new version to 0.1.0
# set the new tag to 0.1.0
- 验证.podspec配置文件是否正确:必须验证通过
# pod lib lint
以上两步也可在pods项目中进行。 - 本地托管git库上传到gitHub仓库
# git add -A && git commit -m "Release 0.1.0"
# git tag '0.1.0'
# git push --tags
# git push origin master
- 验证是否可以根据配置文件正确拉去依赖库
# pod spec lint
验证都通过,即表示我们的依赖库已经制作完成,接下来只要把配置文件放到我们自制的spec库中即可。
- 打版本号
2.将.podspec文件push到私有spec库中
接下来我们需要在自己服务器上建立类似Cocoapos官方的私有spec库,然后给小组成员分配管理权限。私有库的建立这里不再讲述,我建立的私有库名字叫做souFunsepec:
- 根据souFunsepec仓库初始化本地spec依赖库
# pod repo add [Private Repo Name] [git HTTPS clone URL]
# pod repo add souFunsepec http://192.168.73.186:3500/userName/souFunSepec.git
- 向spec仓库中添加.podspec配置文件
cd到.podspec文件所在目录
# pod repo push [Private Repo Name] [Private podspec Path]
# pod repo push souFunsepec ./MyLibary.podspec
推送成功我们可以到souFunsepec目录下查看
# cd ~/.cocoapods
这里我们使用pod search命令是搜索不到私有库的,因为pod search是在cocopods官方的本地specs库下进行搜索。可以使用下面的方法在podfile中直接使用。
私有仓库的使用
Podfile 文件中默认情况下已经隐式使用** source**声明了 CocoaPods 的官方仓库。但使用私有组件,需要使用 source关键字鲜显式声明组件所在仓库:
如下图:
其中,SBJson 组件是官方仓库的,FGMarqueeView 组件属于我们刚创建的私有仓库。
需要注意的是:
官方仓库的显式声明
尽管官方仓库会被隐式声明,如果同时使用了官方仓库和私有仓库,就需要同时声明二者。仓库声明顺序性
先声明的仓库具有优先权。当先后引用的两个仓库中都包含同一个组件时,会使用先引 用仓库中的,哪怕后引用的仓库中版本号更高。
当然我们也可以省略掉第2步,如果不想创建私有仓库,也可以在 Podfile 里直接引用私有组件(组件可以是本地的,也可以是托管在自家公司服务器或网上的代码托管平台上的),引用的同时还可以制定具体的 commit、branch 或者 tag,比如:
# pod 'FGMarqueeView', :git => 'https://git.coding.net/foogry/FGMarqueeView.git', :commit => 'b4dc0ffee'
文中引用了Cocoapods官方的一些介绍以及王中周的cocopods更新篇中的一些步骤,开始使用中被坑了无限次,本文是在实际操作中结合以上参考文章中较容易迷糊的地方给出了操作步骤,有不全的地方,可以移步参考文章。