CocoaPods学习系列2——使自己的项目支持CocoaPods管理

该篇记录使自己的项目支持CocoaPods管理。

要达到这一目的，需要如下步骤：

1.将自己的项目提交到github，添加开源协议license

2.添加podspec文件

3.验证podspec，成功后提交到github

4.注册CocoaPods的trunk账号

5.将podspec文件提交到trunk

接下来，以我的一个开源组件ALWTitleTabBar为例，逐步记录：

1.将自己的项目提交到github，添加开源协议license

该步骤的操作，如果有不清楚的，可参考我之前的git使用介绍的文章。

2.添加podspec文件

该步骤是核心操作。

使用终端cd到与类库根目录同级的目录。创建podspec文件后，应该类似如下文件结构：

ALWTitleTabBar目录下仅有类库资源及文件。

如果还想提供demo，在这个同级目录下创建demo的专用文件夹即可。但不建议加入CocoaPods管理。

开始创建podspec文件：

在终端依次输入：

pod spec create ALWTitleTabBar

vi ALWTitleTabBar.podspec

即可创建成功并进入编辑状态(或者直接一步到位，输入： vim ALWTitleTabBar.podspec)

编辑podspec文件是最重要也稍微麻烦的操作，因为该文件需要配置一系列参数，然后才能使类库发布的各个版本被正确依赖使用。

完整的配置说明，可查阅podspec的配置指南：https://guides.cocoapods.org/syntax/podspec.html#specification

在此，只展示使用的部分：

Pod::Spec.new do |s|
s.name         = 'ALWTitleTabBar'
s.version      = '1.0.0'
s.license      = { :type => 'MIT' }
s.homepage     = 'https://github.com/ALongWay/ALWTitleTabBar'
s.authors      = { 'ALongWay' => '370381830@qq.com' }
s.platform     = :ios, '7.0'
s.summary      = 'A configurable and brief title tab bar.'
s.source       = { :git => 'https://github.com/ALongWay/ALWTitleTabBar.git', :tag => '1.0.0' }
s.source_files = 'ALWTitleTabBar/**/*.{h,m}'
s.frameworks   = 'UIKit', 'Foundation'
end

大多配置都可以自说明，特别注意source_files参数，value内容的ALWTitleTabBar指的就是与podspec文件同级的文件夹。

然后点击ESC键，在终端输入：

:wq

就可以保存退出了。

3.验证podspec，成功后提交到github

编辑完成后，需要编译类库和验证podspec文件。

输入：

pod lib lint ALWTitleTabBar.podspec

等待验证结果，如果失败了，需要一直修改到验证通过。

在这个示例组件中，如果将ALWTitleTabBarConfiguration.h中的UIKit引用移动到ALWTitleTabBar，重新验证，将提示前者中的UIColor等类型无效。

如果验证通过，就可以将podspec文件提交到github了。

在此，需要注意tag的提交。因为podspec文件中有对应的version，所以要保证github上希望被依赖的类库版本号，即用tag标记的发布版本号，与当前即将发布的podspec文件的version一致。

这个tag可以在github的该项目首页——》release栏里去设置，也可以在终端或者客户端提交时候设置。

4.注册CocoaPods的trunk账号

上一步已经验证好了podspec，最终需要发布到CocoaPods的trunk中，才能被搜索到和依赖使用。

所以，如果没有注册过trunk账号，需要先注册，在终端输入：

pod trunk register 370381830@qq.com ALongWay

也就是注册邮箱和用户名

注册成功后，可以查看信息，输入：

pod trunk me

当然，trunk还有其他指令，可以输入pod trunk --help查看更多。

5.将podspec文件提交到trunk

最后一步了。

保证cd到podspec文件所在目录，在终端输入：

pod trunk push

应该是可以等到成功的提示。

至此，已经使自己的项目支持了CocoaPods管理。

在终端输入：

pod search ALWTitleTabBar

可以看到如下输出：

补充一点：

搜索完成以后，需要退出，先点击ESC键，之后不管显不显示内容，直接输入：

:wq

则自动退出。