代码发布到cocoapods
2018-07-04 本文已影响0人
__ENUUI
发布 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。
点击release
- 然后，点击
Draft a new release。
点击创建新的release
- 在新建
release界面，图示1位置填写索要创建release的版本号。可以选择分支，起个标题，填写当前版本的描述。其中，版本号是必填的。填写完成后，点击Publish release,新的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
