发布开源库至CocoaPods(iOS)

概述

CocoaPods是当前iOS开发最流行的版本依赖工具，使用CocoaPds对项目进行依赖管理会为开发者节省不少的时间。相信很多开发者都尝试过通过CocoaPods管理自己的项目。但是如何将自己的项目发布到CocoaPods呢？其他开发者又如何通过CocoaPods搜索到你发布到CocoaPods的项目呢？接下来我们介绍如何通过trunk的方式将自己的代码发布至CocoaPds，以及发布过程中可能遇到的各种问题。

安装CocoaPods

如果你本地已经安装好了Ruby环境，那么下载和安装CocoaPods将十分简单。在Terminal(终端)中输入一下命令：

sudo gem install cocoapods

若OSX版本在10.11以上，请用一下方法安装：

sudo gem install -n /usr/local/bin cocoapods

在Terminal(终端)敲入命令后，很长时间没有任何反应，这可能是由于CocoaPods在国内是被墙了，所以我们需要更换源，我们把源切换至ruby-china来访问CocoaPods。步骤如下：

sudo gem update --system（如果gem为老版本则可执行此命令升级）

sudo gem sources --remove https://rubygems.org/

sudo gem sources -a http://gems.ruby-china.org/

验证你的ruby镜像有且仅有ruby-china。使用如下命令查看：

sudo gem sources -l

如果在终端中出现下面文字才表明你上面的命令是成功的：

*** CURRENT SOURCES ***

https://gems.ruby-china.org/

此时我们在重新执行上述给出的安装CocoaPods的命令即可。

安装本地库：

pod setup

需要注意，执行上述命令时会输出：Setting up CocoaPods master repo。执行时可能会等待比较长的时间，因为CocoaPods将它的信息下载到~/.cocoapods下，如果你想查看下载进度可切换至该目录下用du -sh *来查看当前的下载进度。

创建 Pod 库依赖的文件

1. podspec文件

podspec文件是Pod库的描述文件，每个Pod库必须有且仅有一个这样的文件。文件名需要与我们将要创建的 Pod 库的名称一致。

创建podspec文件

切换至工程目录下，执行：

pod spec create “podname”

创建完成后，在你的工程目录下就会出现对应的文件("podname.podspec")。(为了方便阅读我将所有的注释和不需要的选项都删除了)

podspec文件的简要说明

2. pod验证

如果podspec文件已经完成，我们需要验证podspec文件。

2.1 验证podspec文件

set the new version to 0.0.1

set the new tag to 0.0.1

pod lib lint

如果podspec文件验证通过，Terminal(终端)会显示：“your pod name” passed validation。

2.2 将新建的文件添加到git管理并打上tag推送到远端代码仓库上。

git add -A && git commit -m "Release 0.0.1."

git tag '0.0.1'

git push --tags

git push origin master

使用trunk push podspec文件

以上工作都就绪后，我们就可以将 Pod 提交给 CocoaPods 了，CocoaPods 使用 trunk 服务让我们来提交 Pod。

 1. 注册 Trunk

pod trunk register 邮箱  '用户名' --description='描述信息' --verbose

2. 查看注册的pod信息：

pod trunk me

3. 同过Trunk发布你的pod

pod trunk push podname.podspec

发布成功之后，你可以运行pod setup来更新你的 Pod 依赖库后，再使用pod search “podname”命令来搜索您刚放发布的pod。

4. 添加其它维护者(如果您的pod是由多人维护，您可以添加其他的维护者)

pod trunk add-owner ARAnalytics [email protected]