先说下CocoaPods拉取开源库的原理:
我们知道 CocoaPods 有一个开源的索引仓库Specs,仓库存放着所有开源库的各个版本的.podspec
文件,.podspec
文件包含中记录着源码的地址。我们首次使用CocoaPods时,会将这个文件库克隆到本地~/.cocoapods/repos/master
。
- 在Podfile目录下执行
pod install
命令,会从本地的索引库查找该库的.podsepc
,如果本地不存在会从远程拉取最新的索引库。 - 根据索引库中查到的
.podspec
文件内容,获取源码地址。 - 从源码地址拉取对应版本的代码。
使用是可以发现,首次导入一个开源库时速度较慢,之后再导入时会很快。是因为CocoaPods在本地会有一个缓存目录,存放开源库的源码,首次下载后,再次导入该库时,会直接从本地复制过去。
查看缓存列表使用
pod cache list
,缓存路径为~/Library/Caches/CocoaPods/Pods/
。
私有仓库
私有库的创建
由于CocoaPods的索引仓库是开源的,所有人都可以访问。公司的项目如果也想使用CocoaPods管理源码,而不开放源码的话,我们可以通过创建私有仓库来模拟官方的Specs仓库。
步骤:
- 在私有git上创建一个索引仓库,例:YSMSpecs,用于存放索引文件。
- 将远程索引库添加到本地,
pod repo add YSMSpecs YSMSpecs_source_url
。使用pod repo
可以查看本地的索引仓库列表。 - 本地创建我们的源码工程,可以使用
pod lib create YSMKit
,创建一个模板工程。 - 在模板工程里进行开发并替换 ReplaceMe 文件,修改
.podspec
文件,推送到远程源码仓库,打tag,提交。源码仓库部署完成。 - CocoaPods不允许有Podspecs lints错误,所以需要进行Podspecs lints(翻译不好,会检查语法错误)验证。这里可以使用
pod lib lint
或者pod spec lint
,区别在于前者不会联网,而后者还会检查外部的仓库和相关的标签。 - 检查没有错误之后,推送
.podspec
文件到本地的索引仓库,本地索引仓库会自动push到远程索引仓库。pod repo push YSMSpecs YSMKit.podspec
,这一步会自动进行pod spec lint
联网检查。索引库部分完成。
第6步如果使用
pod trunk push
,会将索引库推送到官方的Specs仓库中。
到这里私有仓库是搞完了。
私有库的使用
- 在宿主工程的Podifle文件中引入私有库:
pod 'YSMKit'
- 在文件的最上方添加索引库地址
source 'https://.../YSMSpecs/git'
source 'https://github.com/CocoaPods/Specs.git'
然后执行 pod install,就可以使用了。
注意: 如果用到了其他开源库的话,一定要加上官方Specs地址,否则只会去查找私有索引库。
私有库的维护
后续需要更新维护仓库代码的流程:
- 在源码工程修改代码之后,修改
.podspec
文件版本号,把源码提交,打上tag,推送到远程仓库。 - 把
.podspec
文件提交到本地的私有索引库中(会自动帮我们提交到远程索引库)。 - 回到宿主工程,修改Podfile中的版本,执行
pod install
(不行就pod update
)。
注意事项
- 在podfile文件中 增加
inhibit_all_warnings!
,这样pod的工程不会显示任何警告。 - 切记:swift中需要设置好访问权限!!!
- 新引入一些库之后执行
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