代码发布到cocoapods

发布 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

代码发布到cocoapods

发布 Git 管理的代码至Cocoapods

1. 创建.podspec文件

2. 编辑.podspec文件

3. 创建release版本

(1) Git 托管网站创建release版本

(2)本地创建release