结合公司需要,参考网上分享者的文章和自己的实际操作,记录下模块化开发的过程,以免自己忘记,也希望能帮助到需要的人。
1、创建 私有Spec Repo
所谓Spec Repo
,就是Pods
的索引。一旦在podfile
中设置source
为某个私有repo的git地址,在进行pod update
的时候就会去这个repo
中进行检索,如果检索到对应的pod
,会读取该Pod
的podspec
从而进行安装。
一个Spec Repo
的目录结构如下:
为了便于管理码云私有库,可把创建的模块库 归纳于组织下,码云创建组织如下图:
之后我们在组织内新建一个相应的Repo
地址,之后添加repo
到本地。
使用命令创建本地spec
库
pod repo add [Private Repo Name] [码云git HTTPS clone URL]
pod repo add HCocaPodsSpecsManager https://gitee.com/modularized_management/HCocaPodsSpecsManager.git
成功后可以进入~/.cocoapods/repos
目录下查看HCocaPodsSpecsManager
这个目录了。
2、创建Pod项目工程文件
这里建议通过CocoPods
的官方命令来进行Pod
项目的创建,以测试项目HStarTools
为例:
现在本地创建好文件夹(文件名可随意起,自己使用方便即可,不过最好规范),用于存放 Pod项目工程文件,下面以我创建的为例进行后续操作
然后在终端cd 到该目录下:
使用命令创建Pod项目工程文件 pod lib create HStarTools
,然后等待终端反应,不出意外会出现下面几个问题:
之后会自动打开项目。
然后就是去新建好的项目里尽情的玩耍吧~~~
此时记得将所有更改放到Classes文件夹之下,然后在Example文件下执行 pod update
,则可发现新的文件已经出现在项目工程的pods文件夹之下了。
此时classes 的文件如下:
之后要做的就是把库同步到Git上去了。这时候需要去组织中建立一个对应的仓库,例如:
名称和 第二步创建的项目名称 保持一致。
点击创建。
Sourcetree 管理私有库文件操作如下:
为了方便以后上传文件(漏传、误操作等),用Sourcetree 管理本地仓库文件
然后将这些文件拷贝到,刚刚创建的本地仓库路径中,如下图
进入SourceTree 上传项目文件
上传成功后,然后打开本地仓库的项目修改 HStarTools.podspec
文件
修改如下:不明白的字段请参考官方文档
然后就是在终端输入验证命令,确保该Podspec
有效:
pod spec lint
第一次验证都会报错误的,而如图的错误就是说:远程仓库没有创建版本标签tag
添加tag:
git tag
git tag 0.1.0
git push --tags
创建好版本后,再次验证:
3、向Spec Repo提交podspec
提交命令:pod repo push HCocaPodsSpecsManager HStarTools.podspec
成功后输入命令 pod search HStarTools
就可以搜索到你创建的私有库咯~
如何使用
我们可以在想要使用的项目中的Podfile
里加入如下代码:
pod 'HStarTools','~> 0.1.0'
即可。
当然,由于我们的是私有CocoaPods
库,因此最好告诉系统这个库的source
在哪里,因此在Podfile
文件上部也请加上Spec Repo的git地址
source 'https://gitlab.com/xxx.git'
#第三方库的远程索引库 也必须添加,不然其他三方库找不到
source 'https://github.com/CocoaPods/Specs.git'
查看本地索引库,输入命令 pod repo
4、版本迭代和更新
只需要正常提交版本到 git 仓库, 并且一定要打 tag 标记,然后更改 .podspec 中的 version 和 其他需要修改的信息 然后再次验证,通过之后提交即可~
再次感谢各位大佬们的分享!