私有库的是随着公司在多个项目开展的时候,把一些常用的工具类制作成pod,方便在多个项目中使用,避免了来回拖入代码造成的时间浪费。iOS组件化实现基本基于cocoapods,如何使用cocoapods创建自己的组件库,是实现组件化的第一要素。
创建一个远程私有库,需要一个私有库,需要一个索引库:
私有库:用于真正存放组件代码
索引库:存放spec文件,用于所引导代码的位置
索引库和私有库的关系可以简单理解就像指针和对象关系,指针就是索引库,对象就是私有库
以码云“gitee”为例:
一、创建私有库的索引库——(如XXPrivateSpec)
1、首先在终端命令行 pod repo 查看本地索引库,可以查看只有一个Master索引库,默认情况下是只有一个master仓库,我们常用的SDWebImage,AFNetWoking等的本地索引就在这个仓库中。
master
- Type: git (master)
- URL: https://github.com/CocoaPods/Specs.git
2、添加一个自己的索引库 首先在gitee上创建一个新的项目命名XXPrivateSpec
3、添加自己的本地远程索引库 后面的地址就是远端工程的“克隆/下载"地址
pod repo add XXPrivateSpec https://gitee.com/XXX/XXPrivateSpec.git
4、可以Command+shif+G 到$ ~/.cocoapods/repos 下查看自己的本地仓库路径,添加完以后可以通过pod repo命令查看,本地会多一个你刚才添加的镜像库,如果想要移除刚才添加的镜像库,执行pod repo --remove XXXPrivateSpec命令就可以了。
5、说明:该仓库下只放各组件索引文件,不存放组件代码(组件代码需要重新创建组件工程)
二、创建自己的组件库工程(本地和远端的仓库podspec)
1、码云托管平台上,在Gitee上创建一存放基础组件的工程XXXComponent(工程创建和上一步类似)
2、快速创建一个模板工程用于编辑自己的基础组件
cd /Users/XXX/Desktop/PrivateLib
终端命令输入:
pod lib create 组件库名
接下来会输入一系列的东西,根据提示输入,账户密码等的如下图:
3、以上信息完成以后,Xcode会自动打开创建好的模板工程,在这里可以把自己编的本地组件文件替换工程中的Replace.m文件
4、终端 cd 命令行 切换到Example文件路径下,执行pod install命令
出现pod installation complete!那么本地私有库就完成,工程中就能看到导入的组件库文件,然后可以编辑修改组件库
5、最后就是将本地的组件库地址提交到远端组件库工程XXXComponent上(注意此处不是索引库,切莫弄混淆了)
5.1 切换到本地组件库工程目录下,执行下面三条命令(这里就将模板文件上传到了远端)
cd /Users/XXX/Desktop/PrivateLib/FoundationExtention/XXXComponent
git remote add origin https://gitee.com/XXX/XXXComponent.git
git push -u origin master
5.1 修改模板工程中的podspec文件, 打开Xcode工程,找到.podspec
s.version 版本号初次使用不需要修改
s.summary 一段简介描述(可以修改为自己想要的)
s.homepage = '工程主页地址'
s.source = '项目仓库地址,不是索引库地址'
5.2 修改完这些主要信息之后,可以用 pod lib lint --allow-warnings校验本地podspec文件是否正确,如有error则需要逐条修改
5.3 保存本地仓库代码修改,打上tag标签,推送到远程仓库,使用如下命令行
git add .
git commit -m '初始化' (-m 后面是对本次提交信息的描述)
git push -u origin master
5.4 校验远端podspec文件是否正确,终端输入 pod spec lint --allow-warnings
当输出XXXComponent.podspec passed validation. 说明远端校验通过
如果出现了警告,可以尝试将s.homepage的文件地址删掉一级尝试
5.5 给版本打一个标签
git tag 0.1.0
git push --tags
小结:
1)打分支这一步很重要,直接决定下面的步骤是否能够继续,当我们有版本更新的时候就要更改版本号
2)这里默认是0.1.0,一定要与之前我们在Xcode中看到的s.version号一致!
5.6 最后一步建立关联,将podspec文件关联到远端私有索引库XXXPrivateSpec.pod repo push XXPrivateSpec XXXComponent.podspec--allow-warnings
注意:注意:提交后,依然会验证 podspec文件,验证通过后 会自动上传到在远程spec索引库。通过这一步我们就同步好了远程和本地索引库
5.7修改基础工程进行版本迭代,本质上修改XXXComponent项目。并且修改是修改podspec文件tag(s.version),打标签。并切将podspec文件推送到远端私有索引库。即重复5.3~5.5 把文件修改推送到远端。
最后还要进行组件库与远端索引库的关联:
即:pod repo push XXPrivateSpec XXXComponent.podspec--allow-warnings
三、创建新工程,使用自己的私有库
cd 到新工程目录
pod init 这里需要
当我们在使用自己创建的私有库时,Podfile文件,要引用我们之前第一步创建的索引仓库地址,也就是指针仓库地址
下面是Podfile
source 'https://github.com/CocoaPods/Specs.git'
source 'https://gitee.com/XXX/XXPrivateSpec.git'
# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'
target 'TestP1' do
# Uncomment the next line if you're using Swift or would like to use dynamic frameworks
use_frameworks!
pod 'XXXComponent', '~> 0.1.0'
end
然后 pod install 就可以了