0
点赞
收藏
分享

微信扫一扫

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

也可以去官网搜索

  1. 更新框架版本

当你需要更新你的工具库时,你需要:

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

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

总结

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

举报

相关推荐

0 条评论