将开源项目代码发布到CocoaPods上

最近公司同时进行两个项目的开发,而这两个项目有一些共同的文件,比如:聊天消息管理类,第三方登陆分享管理类等等。如果其中一个项目的文件修改了,就需要把修改的东西复制一份到另一个项目中,这样每次都很麻烦。就想到了用CocoaPods来管理,类似 AFNetworking,SDWebImage。那怎么将代码发布到CocoaPods上面,通过CocoaPods来管理呢?

1、在Github创建一个项目并将项目clone到本地

网上有很多如何创建的博客,不知道的可以自行搜索。实在太多了,这个给出一个参考图:
Github

2、在该项目下创建一个podspec文件

1、创建podspec文件方法很多,我用的是终端创建的,cd到文件下,vim 文件名:例如:vim SXMScrollExtendTest,之后,会在该文件下,有一个SXMScrollExtendTest这个文件,在修改它的后缀为.podspec 就可以了。用同样的方式创建 LICENSE和README.md文件。


.podspec文件

2、修改.podspec文件
这个需要下载一个Sublime软件(别的编译器也可以)。然后用Sublime打开.podspec文件。我的.podspec文件内容如下:

Pod::Spec.new do |s|
s.name  = "SXMScrollExtendTest"
s.version = "1.0.0"
s.license = "MIT"
s.summary = "轮播图."
s.description  = <<-DESC
   Help developer to quickly intergrate variety of payment methods
DESC
s.homepage = "https://github.com/SXMmeng230/SXMscrollExtendTest"
s.authors = { "sunxm" => "SXMmeng230@163.com" }
s.source = { :git => "https://github.com/SXMmeng230/SXMscrollExtendTest.git", :tag => "1.0.0"}
s.requires_arc = true
s.ios.deployment_target = "8.0"
s.source_files = "SXMScrollExtendTest", "*.{h,m}"
end

重点解释:
s.name 是你的项目名
s.version 是你项目的版本号
s.summary 是简单的描述
s.homepage 是你这个项目的Github地址
s.authors 是作者和邮箱
s.source 是项目地址url
s.requires_arc 是否要求arc
s.ios.deployment_target 最低要求的系统版本
s.source_files 你项目文件名和里面的内容
s.dependency:依赖的项目,如有多个,则写多行
s.frameworks:表示需要的框架,如'Foundation',多个框架之间以英文逗号分隔。
3、验证.podspec文件的有效性
验证podspec的有效性,检查修复语法或者逻辑错误。使用命令:

pod lib lint SXMScrollExtendTest.podspec --verbose

其中 SXMScrollExtendTest.podspec换成自己的.podspec文件,要与上面的s.name一致。

运行终端后,居然报错:
图片

(1)、对于第一错误,是因为s.name 要写成你上传到cocoapods上文件的名称,而不是你xcode新建项目的名称

(2)、第二个是警告,可以用忽略警告的验证方式(--allow-warnings),如:

pod lib lint SXMScrollExtendTest.podspec  --allow-warnings

(3)、第三个错误,我的xcode没有安装Command Line Tools导致的,在xcode的安装下即可:
图2

再运行终端: 验证车成功后会提示xxx.podspec passed validation.,如
图3

3、添加项目代码到GitHub

开源许可LICENSE和podspec都做好之后,将项目push到你的远程代码仓库。

git add .
git commit -m"fix"
git push -u origin master

发布开源项目到cocoapods上去需要添加版本号,用git tag添加版本号。

git tag '1.0.0'

将本地添加的tag同步到远程代码仓库:

git push --tags

4、注册trunk账号

使用pod trunk register注册账号:

pod trunk register <SXMmeng230@163.com> <sunxm> --description='项目注册'

SXMmeng230@163.com:自己的邮箱
sunxm:名字
description:描述
注册好了之后,用pod trunk me验证注册信息.

pod trunk me

5、万事俱备,开始发布代码到cocoapods

1、使用命令:

pod trunk push xxx.podspec --verbose

上面的xxx表示项目名,要和s.name保持一致.
需要注意的是,若存在警告,则不能通过有效性验证,导致发布失败!

我们可以加上允许警告的选项(--allow-warnings)如:

pod trunk push xxx.podspec --allow-warnings

命令执行完后,会更新master repo会有点慢。


图4

出现这个,OK 成功了。
2、验证是否可以
使用命令 pod search 如下:

 pod search SXMScrollExtendTest

等等,怎么运行错误了?
图5

不是成功了吗?怎么失败了?没事 可以运行下面命令:

rm ~/Library/Caches/CocoaPods/search_index.json

再次运行pod search 命令,如下

图6

一切OK,完美!!!
注:CocoaPods官方有一个Specs仓库:传送门。可以下载下来用

©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容