前言
CocoaPods 三方库管理工具相信大家都不会陌生,开发工程中多多少少都有过接触,一方面它能够帮我们管理依赖库,三方库,另一方面,我们可以将自己的代码库提交给 CocoaPods 分享给他人,也能为自己的其他项目提供便捷的支持。那么,今天就简单介绍一下如何让自己的工具库支持 Cocoa Pods 集成。
必要条件
我们要先准备几项必要得东西。
- 代码库
可以是 Git 项目,也可以是其他如码云,Coding 等其他平台得项目。
- podspec 配置文件
这份文件用来描述你的项目信息,如项目名称、项目版本、项目地址、作者、资源文件等信息,它具有一定的语法规则,你可以通过 官方指导文件 了解更多信息。
- CocoaPods 账号
账号记录了你在 CocoaPods 上所有发布的工具库信息,该账号可以在终端使用命令进行注册,后续会提到如何进行注册。
1. 代码库
本文以 Github 项目为例。先来创建一个自己的项目。关于如何使用 Github 你可以参考其他网络文章,这里不做过多的演示。
登录到 Github 上,创建你的项目,如果已经有了项目,可以跳过这个步骤
-
创建项目
- 创建测试文件并提交到远程 Git
将创建的项目 clone
到本地,使用的工具,方式都不限。为了测试工具的使用,你可以任意创建一个工具类,内容不限,最后将该文件提交至远程 Git 。
- 发布项目
到代码库中构建 release
发布版本。你也可以在本地项目上打上 tag
推送到远程 Git,方式不限,我们只需要保证 Github 上有可以的发布版本就可以。
为你的发布版本填写一些相关信息。
2. podspec 配置文件
进入到项目文件夹。创建 podspec
文件。
我这里使用终端进行文件的创建。
$ touch yourProjectName.podspec
创建完成之后,我们来编辑这份文件。你可以在项目文件夹中找到这份文件,手动打开进行编辑即可。我这里依旧使用终端命令进行编辑。
$ vim yourProjectName.podspec
podspec
文件主要涉及到你项目名称、版本、简介、资源、平台等等信息
使用 i
进入编辑模式,编辑完成,点击 esc
,然后 shift+zz
退出编辑
该文件大体如下:
这里需要提到的就是资源文件的设置,你可以为你共享的资源文件创建一个单独的文件夹,将这些需要共享的文件都放在这个文件下。CocoaPods 会去下载你所设置的资源路径下的文件。
你可以通过 官方指导文件 了解更多关于 podspec
配置文件的语法信息。
3. 注册账号并上传 podspec
配置文件
现在我们已经发布的自己的项目,并且已经写好对应的 podspec
配置文件了,往事俱备,只欠东风。接下来,我们要把这份配置文件提交给 CocoaPods 即可。
- 注册 CocoaPods 账号
如果你没有 CocoaPods 账号,或者你在新的环境中没有连接过账号,你可以终端注册一个。
通过下面的命令来注册账号。
$ pod trunk register 邮箱地址 用户名 --description=描述信息
根据提示登录你所注册的邮件进行激活即可。激活成功就会出现下面的提示。
可通过下面的命令查看当前的 CocoaPods 账号信息。
$ pod trunk me
- 上传
podspec
配置文件
接下来,我们需要将本地的这份项目配置文件推送给 CocoaPods 服务器。
上传之前,最好先验证一下你的 podspec
文件格式是否通过校验。进入该文件所在的文件夹下,输入验证命令,无需指定文件名称即可校验 podspec
后缀的文件。
$ pod spec lint
如果发生错误,即 ERROR
提示,找到问题所在进行改正即可。
如果验证通过,输入下面命令将文件上传。
$ pod trunk push yourProjectName.podspec --allow-warnings
上传成功后,更新你本地的 repos
然后再搜索你的库。
$ pod repo update
$ pod search yourProject
如果依旧搜索不到,那么需要删除掉本地缓存的搜索索引文件,再重新执行搜索操作。
$ rm ~/Library/Caches/CocoaPods/search_index.json
$ pod search yourProject
也可以去官网搜索。
- 更新框架版本
当你需要更新你的工具库时,你需要:
重新发布版本 -> 修改 podspec
文件信息 -> 上传 CocoaPods
是不是异常简单呢?快去试试吧。
总结
CocoaPods 工具极大提高了我们的开发效率,我们无需花费过多精力去管理依赖库和三方库。通过 CocoaPods 我们可以方便的将自己的工具库分享给他人使用。分享工具库只需要准备三个必要条件,一份代码库,一份配置文件,一个 CocoaPods 账号,有了这些准备,我们分享自己的工具仅仅需要花几分钟的时间而已。通过 CocoaPods 工具,我们可以随心所欲的分享、使用库。