发布 Git 管理的代码至Cocoapods
1. 创建.podspec
文件
Git 管理的代码都会有 .git 文件。首先打开终端, cd 到与.git 同级的目录。
执行命令:
$ pod spec create <NAME>
<NAME> 替换成所要发布的项目的名称。例如
$ pod spec create RTDatabase
执行成功,终端会有途中所示提示。
2. 编辑.podspec
文件
打开文件项目文件目录,找到 *.podspec
文件,双击打开。如果打不开,选择Xcode
或者 Sublime Text
打开。第一次打开会有一百多行,看起来很吓人。先把注释(.podspec
中以#
开头的是注释)删除。
-> 大概留着么多东西就行了,需要的可以再添加进来。
Pod::Spec.new do |s|
s.name = "RTDatabase" # 要发布项目的名称,要与.podspec同名
s.version = "0.0.1" # 版本号
s.summary = "A short description of RTDatabase." # 项目概括
s.description = <<-DESC
DESC # 项目描述。可以没有,但有这一项就要有内容。
s.homepage = "http://EXAMPLE/RTDatabase" # 个人主页
s.author = { "ENUUI" => "ENUUI_C@163.com" } # 作者,以及联系方式。
s.license = "MIT" # 发布的证书,不知道证书可以去了解一下。
# s.requires_arc = true # 是否是arc的
# s.platform = :ios # 运行环境
# s.ios.deployment_target = "5.0" # 运行环境,与所支持的系统版本
# s.osx.deployment_target = "10.7"
# s.watchos.deployment_target = "2.0"
# s.tvos.deployment_target = "9.0"
s.source = { :git => "http://EXAMPLE/RTDatabase.git", :tag => "#{s.version}" }
# 项目源文件目录
s.source_files = "Classes/**/*.{h,m}"
# s.public_header_files = "Classes/**/*.h" # public头文件目录
# s.dependency "JSONKit", "~> 1.4" # 依赖的第三方
# s.ios.frameworks = 'MobileCoreServices', 'CoreGraphics' # 依赖的系统库
end
这样以来就一目了然了,稍稍有点英语基础,就能看出来每一项的含义是什么。
s.source = { :git => "http://EXAMPLE/RTDatabase.git", :tag => "#{s.version}" }
- 其中
http://EXAMPLE/RTDatabase.git
可以替换成托管代码的git网站上的git clone
用的网址,如https://github.com/FuihuiC/RTDB.git
;
也可替换成项目的.git
目录,如/Users/ENUUI/Desktop/Codes/OptiDB/RTDB/.git
。#{s.version}
则一项建议就不要该了,这个的意思是,项目资源的release
版本与.podspec
中的s.version
项中的版本号相同。
s.source_files = "Classes/**/*.{h,m}"
s.public_header_files = "Classes/**/*.h"
这两项非常类似。刚开始的时候这个目录还是很容易出问题的。
- 目录起始要与
.podspec
所在的目录同级;- 其中的
*
代表任意长度的任意的任意字符;{h,m}
中填写文件后缀,出了h,m
,还有swift
等,多项以,
隔开;s.public_header_files = "Classes/**/*.h"
这一项只会声明公开的头文件,不会按照路径去加载。所以要保证这一项中的头文件都已经在s.source_files
加载,或者单独加载。比如
s.source_files = 'RTDatabase/core/RT*.{h,m}'
.这句的意思是:RTDatabase/core/
路径下,所有以RT开头的.h
和.m
文件。
检测本地pod是否通过。
- 执行命令:
$ pod lib lint <NAME>.podspec --allow-warnings
<NAME>
替换成自己的.podspec
文件的名字,不保留尖括号。
3. 创建release
版本
(1) Git 托管网站创建release
版本
所有的 Git 托管网站都差不太多,以 GitHub 为例。
- 首先,确保代码都已经提交完成。点击release。
- 然后,点击
Draft a new release
。
- 在新建
release
界面,图示1位置填写索要创建release
的版本号。可以选择分支,起个标题,填写当前版本的描述。其中,版本号是必填的。填写完成后,点击Publish release
,新的release
就创建好了。
创建完成后,一定要
git pull
一下,将新版信息pull
到本地。
(2)本地创建release
- 打开终端,
cd
到.git
所在目录,执行命令:
// <version>位置填写要创建的 tag 的版本号。没有尖括号。
$ git tag -a <version> -m '<message>'
- 如果要提交到 Git 服务器,执行下命令:
// <version> 填写要提交的 tag 的版本号。没有尖括号。
$ git push origin <version>
- 删除本地 tag
$ git tag -d <version> //删除本地tag
- 删除远程tag
$ git push origin <version> //删除远程tag
// 或者
$ git push origin --delete tag <version> //删除远程tag
4. 发布
- 首先,检测文件的有效性,执行命令:
$ pod spec lint --allow-warnings
执行结果显示*.podspec passed validation
(一般是绿色的)时成功。
- 发布到cocoapods,执行命令:
$ pod trunk push <NAME>.podspec --allow-warnings
这个过程可能会慢一些,耐心等待就可以了。当出现一些彩色的小图案,并有Tell your friends!
字样的时候,说明已经成功了。
5. 问题
- 路径问题。在添加资源的时候,路径一定要写清楚,不能错点。
- 代码错误。代码有问题是传不上去的。
- 没有把 Git 服务器上的
release
拉到本地。
6.示例
文中提到的代码 RTDatabase
RTDatabase 的 .podspec