02.发布开源框架到CocoaPods

01.CocoaPods安装与使用

简介

该文章我会通过一个LPProgressHUD的开源框架来讲解整个发布过程。

发布开源框架到CocoaPods

1.把项目发布到Github，并且打上tag。

Git相关操作这里就不在赘述了，如果有什么问题可以参照【Git一个先进的分布式版本控制系统】

2.创建.podspec描述文件：

$ pod spec create LPProgressHUD # 初始化一个Podspec文件。注意：将LPProgressHUD替换成你自己的项目名

#注意：该命令需要在工程根目录中执行，它会生成一个LPProgressHUD.podspec文件。

3.了解.podspec文件（文件里已经有非常详细的注释了，这里就简单描述下）

Pod::Spec.new do |s|

#你的库名称
  s.name         = "LPProgressHUD"
#库原代码版本号
  s.version      = "1.0.1"
#对库的一个简单的介绍
  s.summary      = "LPProgressHUD is a Swift version of the HUD that mimics MBProgressHUD."
#声明库的主页，一般为github地址就行
  s.homepage     = "https://github.com/leo-lp/LPProgressHUD"
#采用的授权版本：一般为 MIT
  s.license      = "MIT"
#库的作者：{ "作者名" => "邮箱" }
  s.author       = { "leo-lp" => "[email protected]" }
#库所支持的软件平台，这在我们最后提交进行编译时有用。
  s.platform     = :ios, "8.0"
#声明代码的地址，也就是你github上的地址
  s.source       = { :git => "https://github.com/leo-lp/LPProgressHUD.git", :tag => "#{s.version}" }
#库的源代码的路径
  s.source_files = "LPProgressHUD/Sources/*.swift"

end

4.验证.podspec文件是否可用

$ pod spec lint LPProgressHUD.podspec

#注意：如果有任何warning或者error都是不可以的，它将不能被添加到`Spec Repo`中。如果验证通过会提示`LPProgressHUD passed validation.`

5.CocoaPods Trunk发布自己的Pods

（1）注册Trunk：

$ pod trunk register 你的邮箱 '你的用户名' --description='你的描述'

e.g.:
$ pod trunk register [email protected] 'leo-lp' --description='LPProgressHUD de description.'

成功的话就会收到一份邮件，点击邮件中的链接后验证一下，之后再到终端输入以下命令：

$ pod trunk me

#成功的话会返回以下类似字段：
  - Name:     leo-lp
  - Email:    [email protected]
  - Since:    June 16th, 3:58
  - Pods:     None
  - Sessions:
    - June 16th, 3:38 - July 22nd, 3:40. IP: 192.168.5.101

如果你的pod是由多人维护的，你也可以添加其他维护者:

$ pod trunk add-owner POD OWNER-EMAIL

e.g.:
$ pod trunk add-owner LPProgressHUD [email protected]

（2）Trunk push

$ pod trunk push

#注意：该命令会首先验证你本地的podspec文件是否有错误，如果没有错误会上传spec文件到trunk，最后会将你上传的podspec文件转换为需要的json文件。

如果报错了，仔细查看一下错误信息。如果上传成功了，到此整个制作过程就完成了。
注意：以后有新版本只需要修改工程根目录下的.podspec文件，然后重新执行pod trunk push命令。

6.补充：

如果pod trunk push成功后无法pod search到自己的库，可执行以下命令。

$ pod setup    #更新pod库

如果pod setup成功后还是无法pod search到自己的库，可执行以下命令。

$ cd ~/Library/Caches/CocoaPods/    #进入CocoaPods的缓存文件夹
$ rm search_index.json              #删除search_index.json文件
$ pod search LPProgressHUD          #执行搜索命令，并重新生成search_index.json文件