最近公司的项目因为功能较多,复杂度较高,所以打算使用组件化方案去解耦业务,当然组件化方案的考虑有很多,不过这里我们只谈用CocoaPods去管理组件这一块.
在决定使用CocoaPods去管理组件之前,我的思路历程是这样的↓
- 我们为什么使用CocoaPods去管理组件呢?
- 我们为什么要创建Pod私有库呢?
- 我们在用 cocoaPods 去管理组件,还会遇到一个问题,那就是需不需要把我们的组件封装成framework?
1. 我们为什么使用CocoaPods去管理组件呢?
CocoaPods组件化开发好处:
- 在CocoaPods中可以通过podfile很好的配置各个组件，包括组件的增加和删除，以及控制某个组件的版本.使用CocoaPods的原因，很大程度是为了解决大型项目中，代码管理工具merge代码导致的冲突.并且可以通过配置podfile文件，轻松配置项目.
- 每个组件都是一个独立app，可以独立开发、测试，使得业务组件更加独立，所有组件可以并行开发.下层为上层提供能满足需求的底层库，保证上层业务层可以正常开发.
2. 我们为什么要创建Pod私有库呢?
众所周知, CocoaPods 有两种库,公开库和私有库,公开库是所有人都可以通过 pod 把你的代码集成到自己的项目,而私有库只是可以内部人员自己使用,而我们并没有打算把自己的组件给别人用,所以我们要用Pod私有库
3. 我们在用 cocoaPods 去管理组件,还会遇到一个问题,那就是需不需要把我们的组件封装成framework?
封装成framework有如下好处:
- 保证在开发过程中,其他的开发人员肯能会修改我的组件代码.
在多人开发的情况下,我不能保证其他开发人员不去修改我的组件代码,如果我更新了我的组件代码,那工程在升级组件之后,程序必然会出现问题,如果我封装成了framework,只在. h 文件中暴露出调用接口的话,是最安全的.
- 如果以后我们的组件要公布出去,又不想开源代码,只要创建一个Pod公开库就可以.
在封装成framework的情况下,调用者是看不见接口的内部实现的,保证了代码的安全性
封装成framework有如下坏处:
- 不方便调试,是封装成framework最不方便的地方,出现一个小 bug, 我都需要在本地调试成功之后,打包成framework,然后去更新我的 pod 私有库.这个过程是很麻烦的,无形增加了开发成本.
封装成framework的利弊都说完了,大家可以根据自己的实际情况进行选择.
创建Pod私有库
言归正传,当我们要创建Pod私有库时,都需要做什么?
创建工程创建Pod所对应的podspec文件创建私有的Spec Repo本地测试podspec文件是否可用向私有的Spec Repo中提交podspec测试Spec Repo中的的 podspec 是否可用私有库关联trunk 账号
1. 创建工程
因为 github 的私有库是付费的,所以我使用码云的私有仓库.
创建完才想起来截图,所以就变成这样了,大家将就看一下吧
正常添加 License 这里我选择的是 MIT License
把你的组件代码上传到仓库
我的目录结构是这样的
2. 创建Pod所对应的podspec文件
切换到项目目录下
cd ~/Desktop/foundationcategaries
生成.podspec文件
$ pod spec create FoundationCategaries
FoundationCategaries替换成自己私有库的名字,就像SDWebImage.
执行完这句换之后,你就多了一个FoundationCategaries.podspec文件
用 Sublime Text或其他工具 打开FoundationCategaries.podspec文件,修改为一下样式,注意修改完成后,不要有注释信息.
Pod::Spec.new do |s|
s.name = "FoundationCategaries"
s.version = "0.1"
s.summary = "Just Testing."
s.description = <<-DESC
Testing Private Podspec.
* Markdown format.
* Don't worry about the indent, we strip it!
DESC
s.homepage = "https://git.oschina.net/baozhatou"
s.license = "MIT"
s.author = { "Sean" => "xxxx@xxx.com" }
s.source = { :git => "https://git.oschina.net/xxx/foundationcategaries.git", :tag => "0.1" }
s.platform = :ios, '8.0'
s.requires_arc = true
s.source_files = 'FoundationCategories/FoundationCategories/*.{h,m}', 'FoundationCategories/FoundationCategories/*.{h,m}'
s.frameworks = 'Foundation'
end
修改完成后,把你的代码和FoundationCategaries.podspec文件提交码云的仓库.
3. 创建私有的Spec Repo
打开你cocopods 仓库
open ~/.cocoapods/repos/
现在的目录结构是这样的
pod repo add FoundationCategories http://git.oschina.net/xxx/foundationcategaries
执行成功后你会发现当前目录下多了一个FoundationCategories的文件夹
切换到FoundationCategories路径下
cd ~/.cocoapods/repos/FoundationCategories/
测试本地库是否正确
pod lib lint
测试后,发现问题,就去修改,错误信息一般提示的很明显,成功后会提示如下:
4. 本地测试podspec文件是否可用
我们可以创建一个新的项目，在这个项目的Podfile文件中直接指定刚才创建编辑好的podspec文件，看是否可用。 在Podfile中我们可以这样编辑
platform :ios, '8.0'
pod 'FoundationCategaries', :podspec => '~/.cocoapods/repos/FoundationCategories/FoundationCategaries.podspec' # 指定podspec文件
然后执行pod install命令安装依赖
我这里遇到个错误,如下
fatal: Remote branch 0.1 not found in upstream origin
这个错误就是没有找到码云仓库找到我的tag 0.1,所以出错.因为我们在FoundationCategaries.podspec文件里面指定了tag 0.1
s.source = { :git => "https://git.oschina.net/xxx/foundationcategaries.git", :tag => "0.1" }
cocopods去我们的仓库找,却没有找到,所以会报错
那我们就去打一个0.1的 tag,让cocopods找到就可以了
然后执行pod install命令安装依赖
安装成功.
5. 向私有的Spec Repo中提交podspec
提交之前需要注册Cocoapods账号,如果有请忽略此步骤
pod trunk register xxx@xxx.com ‘snoopy’ --description='write for blog'
注册成功,会给你发一封验证邮件.
打开邮件验证一下就好,如果发现自己没有收到邮件,去垃圾邮件里面找一下,可能被拦截了.
验证之后,执行pod trunk me,验证一下是否注册成功.
成功后,切换到FoundationCategories目录下
cd ~/.cocoapods/repos/FoundationCategories/
向私有的Spec Repo中提交podspec
pod repo push FoundationCategories FoundationCategaries.podspec #前面是本地Repo名字 后面是podspec名字
完成之后这个组件库就添加到我们的私有Spec Repo中了.
查找一下
pod search FoundationCategaries
ok
6. 测试Spec Repo中的的 podspec 是否可用
新建工程测试一下
在 Podfile 文件中添加FoundationCategaries
pod 'FoundationCategaries', '~> 0.1'
完成之后,说明Spec Repo中的的 podspec 可用
7. 私有库关联trunk 账号
以上建立了本地私有库,如果更换设备,还想使用,就要给私有库关联 trunk 账号,关联以后,我们以后就可以通过账号管理和维护我们的私有库了
pod trunk push
这样表示关联成功
这时候我们看看我们的 trunk账户信息
👌,关联完毕.
关于 trunk 的其他操作大家可以访问trunk文档,里面的内容很详细.
这篇文章我们就讲到这里,关于更新维护podspec我们会在下一篇文章详细介绍.
