私有库的搭建,可以方便的为我们的工程进行功能性解耦,模块化开发提供了很大的便利,根据实际项目体验下来,使用CocoaPods来进行代码的模块化,非常的实用跟方便,而且搭建私有的CocoaPods库,那么相对来说,代码的安全性也有了保障。
目前自己所在的公司,因为项目需要,也一手搭建了自己的CocoaPods的私有库,而且给多个客户端进行使用。结合实际使用体验,然后分享下过程。
这个过程可能是个人精简下来最简单的一个流程,很多细节可能都不考虑,直接流程就是
前期准备—>搭建必要内容—>创建私有库—>提交私有库—>使用私有库
搭建CocoaPods私有库前期准备2个步骤。
1、已经搭建好的私有的git服务器。
2、已经安装CocoaPods工具。
上面2个必要条件,如果不知道怎么操作,可以自行进行百度,其实比较简单的。
接下来就是一系列官网操作以及结合个人的实际操作。
1、创建pod Repo的git仓库。(创建一个git仓库,仓库命名建议Spec结尾,如这里的SZSpec)
1.1 创建好之后,地址为http://gitlab.i.sz.com/front-all/SZSpec.git
1.2 为了隐私,这个git地址只是为了方便展示用的假地址。
2、增加本地 pod spec(增加pod的资源的来源)
2.1 将git地址复制出来,
2.2 打开命令行 输入
pod repo add NoahSpec http://gitlab.i.sz.com/front-all/SZSpec.git
- 2.3 打开命令行 输入
pod repo list
可以看到你目前的pod有几个资源地址,刚刚加进去的,也能查看到。
更多pod repo命令可以自行查看
3、创建你私有库的git仓库。(创建一个git仓库,命名就可以是你的想要库的命名,这里命名SZSDK)
- 3.1将git库拉到本地你喜欢的位置,桌面,文稿,或是其他位置。
假设目前这个库的git地址为 http://gitlab.i.sz.com/front-all/SZSDK.git
4、创建库工程
- 4.1打开命令行 输入
cd 到刚刚拉下来的git仓库的文件夹位置S
pod lib create SZSDK
5、至此,你的私有库工程已经建立完毕,工程目录文件是这样的
- 5.1简单的介绍下各位文件路径的说明
Example 样例工程,你的私有库可以通过这个工程进行调试,运行。
Assets 这个文件夹主要放你私有库的资源文件,图片,xib等。
Classes 这个文件夹就是放你私有库的.h.m等代码文件。
SDSDK.podspec 这个就是你私有库的配置文件,这个后面会详细讲解。
6、打开样例工程SZSDK.xcworkspace
- 6.1工程结构如图所示,大致说明一下里面几个重要文件
SZSDK.podspec 这个就是你私有库的pod配置文件,里面每个字段的含义其实很好理解。
目前你只需修改s.version 和 s.source,
s.version = '0.1.0'
s.source = { :git => 'https://github.com/johnson/SZSDK.git', :tag => s.version.to_s }
其余字段可以不动,你也可以查询官网,了解每个字段的含义。
README.md 这个就是你私有库SZSDK.git网址首页的说明文案,用的markdown语法。
Pods工程中 SZSDK文件夹下面的ReplaceMe.m文件,是个空文件,意思很明确,叫您更换它。
这个文件夹下,你就可以自己添加你的私有库的文件夹和文件,你可以在这个里面新建内容,但是注意根据资源还是代码文件,放置到相应的文件夹内。
比如这边我新增加2个文件和1张图片。
图片资源的话,建议先放到Assets文件夹中,然后再拖入工程
7、假设SZObjc和这张图片就是你的私有库内容,那么接下来,还是修改SZSDK.podspec内容
8、私有库工程的修改到这就完全完成了。然后将SZSDK推送到git远端。并且打上Tag,Tag要跟刚刚
SZSDK.podspec中的s.version值保持一致,这里我们tag就打成0.1.0,注意这里打Tag很重要,千万不要弄错。
9、向Pod 推送你的私有库
- 9.1 打开命令行
cd 到 SZSDK.podspec的目录
- 9.2 输入
pod repo push NoahSpec SZSDK.podspec --allow-warnings --skip-import-validation --use-libraries
- 9.3这里可能会遇到git推送需要输入密码,如果你是ssh验证git的话,应该就没有这个问题。
10、推送成功后,可以到SZSpec 的git仓库查看,会有一条更新,这就证明你的私有库已经发布成功了。
11、进行使用
- 11.1 新建一个Xcode工程,或是打开你的任意工程,创建或是修改现有的podfile文件
- 11.2 进行正常的pod install,通过import便可进行你的私有库使用了。
这可能是最简单,最快速的CocoaPods私有库搭建,每步都是必须步骤,没有任何一步是多余的,按照步骤,你可以以最快的速度,创建你的私有库和进行使用,至于其中引申的东西,或是podspec中的详细设置,你可以参考官网,一边做一边学。
更多详细信息可以访问官网
https://cocoapods.org