最近公司同时进行两个项目的开发,而这两个项目有一些共同的文件,比如:聊天消息管理类,第三方登陆分享管理类等等。如果其中一个项目的文件修改了,就需要把修改的东西复制一份到另一个项目中,这样每次都很麻烦。就想到了用CocoaPods来管理,类似 AFNetworking,SDWebImage。那怎么将代码发布到CocoaPods上面,通过CocoaPods来管理呢?
1、在Github创建一个项目并将项目clone到本地
网上有很多如何创建的博客,不知道的可以自行搜索。实在太多了,这个给出一个参考图:2、在该项目下创建一个podspec文件
1、创建podspec文件方法很多,我用的是终端创建的,cd到文件下,vim 文件名:例如:vim SXMScrollExtendTest,之后,会在该文件下,有一个SXMScrollExtendTest这个文件,在修改它的后缀为.podspec 就可以了。用同样的方式创建 LICENSE和README.md文件。
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的安装下即可:再运行终端: 验证车成功后会提示xxx.podspec passed validation.,如
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会有点慢。
出现这个,OK 成功了。
2、验证是否可以
使用命令 pod search 如下:
pod search SXMScrollExtendTest
等等,怎么运行错误了?不是成功了吗?怎么失败了?没事 可以运行下面命令:
rm ~/Library/Caches/CocoaPods/search_index.json
再次运行pod search 命令,如下
一切OK,完美!!!
注:CocoaPods官方有一个Specs仓库:传送门。可以下载下来用