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

则自动退出。

  

原文地址:https://www.cnblogs.com/ALongWay/p/6393276.html