iOS 让自己的工具库支持 CocoaPods

前言

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 即可。

1. 注册 CocoaPods 账号

如果你没有 CocoaPods 账号，或者你在新的环境中没有连接过账号，你可以终端注册一个。

通过下面的命令来注册账号。

$ pod trunk register 邮箱地址 用户名 --description=描述信息

根据提示登录你所注册的邮件进行激活即可。激活成功就会出现下面的提示。

可通过下面的命令查看当前的 CocoaPods 账号信息。

$ pod trunk me

2. 上传 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

也可以去官网搜索。

3. 更新框架版本

当你需要更新你的工具库时，你需要：

重新发布版本 -> 修改 podspec 文件信息 -> 上传 CocoaPods

是不是异常简单呢？快去试试吧。

总结

CocoaPods 工具极大提高了我们的开发效率，我们无需花费过多精力去管理依赖库和三方库。通过 CocoaPods 我们可以方便的将自己的工具库分享给他人使用。分享工具库只需要准备三个必要条件，一份代码库，一份配置文件，一个 CocoaPods 账号，有了这些准备，我们分享自己的工具仅仅需要花几分钟的时间而已。通过 CocoaPods 工具，我们可以随心所欲的分享、使用库。