本文使用trunk方式发布代码到CocoaPods，在发布过程中碰到了不少坑，浪费了很多时间，也收获了经验和成功的喜悦。
网上看的教程大部分只集中在某些方面如pod trunk命令使用，或podspec文件的详细介绍，并没有对从提交GitHub到发布CocoaPods整个流程作描述，以至于在发布过程中只将自己写的组件（Class文件）上传到GitHub，然后以Class文件发布到CocoaPods的时候提示各种各样的错误而无法解决。最后通过对比CocoaPods的已发布项目，观察其中的异同，终于成功发布。
本文将以XLPhotoBrowser组件（a component of photo browser on iOS）为演示组件，详细描述将XLPhotoBrowser组件发布到CocoaPods的过程，记录其中的坑和心得体会，也让每个开发者都能方便快捷地使用访XLPhotoBrowser组件。
在发布自己的组件时，需用组件名称替换XLPhotoBrowser
本文着重点在发布第三方库的步骤，并对各步骤的注重事项做标记，写点心得体会，同时也是记录发布的流程和注意点，免得忘记。
发布代码到CocoaPods，主要的步骤如下：
上图列出了主要步骤，分析如下：
1、发布GitHub项目
此时发布的项目应该是能正常运行的完整XCode工程，其中包含了要发布的组件。
CocoaPods都托管在GitHub上(官方链接为：https://github.com/CocoaPods ),所有的Pods库也都依赖GitHub，因此第一步需要创建自己的GitHub仓库，将Pods库的demo工程上传到仓库。
1.1、创建GitHub仓库
经常提交代码的应该都知道如何在GitHub官网（官网地址：https://github.com ）新建仓库，特别注意的是：选择一个许可证；
1.2、git clone 克隆远程库到本地，在文件夹下创建XCode demo工程，将自己的组件放到单独的文件夹；
1.3、让demo跑起来，达到预期完整功能；
1.4、提交demo工程到GitHub；
$ git push origin master
2、发布到CocoaPods
已经提交代码到GitHub以后，就能着手发布到CocoaPods了。以下是CocoaPods的步骤：
2.1、注册trunk，
$ pod trunk register eloy@example.com 'Eloy Durán’ #注册，会发带验证链接的邮件到邮箱地址，名称无法修改
$ pod trunk me #可查询注册信息。
注意：邮箱是GitHub上的邮箱，名称随意但是无法修改。命令执行完后邮箱会收到带有验证链接的邮件，打开链接就能完成trunk注册流程。
2.2、生成podspec文件
$ pod spec create XLPhotoBrowser
会在当前目录下生成XLPhotoBrowser.podspec文件，里面有非常多的注释，大部分都是无用的。建议删除内容，直接使用其它成功提交的podspec文件修改。
2.3、打tag
$ git tag 1.0.1 #给源代码打版本标签，与podspec文件中version一致即可
$ git push --tag
2.4、 验证podspec文件是否合法
$ pod lib lint #需要验证一下，以便提前发现问题。
2.5、更新GitHub仓库
$ git add . #将当前目录下所有文件和子目录的修改记录到Git索引中
$ git status #列出当前目录下被修改还未提交的状态
$ git commit -m ‘first commit’ #提交被add的改动
$ git push origin master #push代码到Git
2.6、发布到CocoaPods
$ pod trunk push XLPhotoBrowser.podspec
验证podspec是否合法，上传pod spec文件到CocoaPods，并将podspec文件转成json格式
当终端出现类似以下输出时，代表已经提交成功，等待审核即可。我的第1次提交审核了十几分钟。
- Log messages:
- December 5th, 20:46: Push for `XLPhotoBrowser 1.0.0' initiated.
- December 5th, 20:46: Push for `XLPhotoBrowser 1.0.0' has been pushed
3、搜索CocoaPods第三方库
两种方法：
方法一：使用$ pod setup命令更新本地pod依赖树，再使用$ pod search XLPhotoBrowser命令搜索；
方法二：官网查询（官网地址： https://cocoapods.org/?q=XLPhotoBrowser ）
4.使用该第三方库（CocoaPods使用操作）
</br>
5.坑与解决方案：
在整个过程中碰到不少坑，整理如下：
5.1.新建的GitHub仓库没有选择许可证。没法，只能删了重新建。
5.2.没有建demo工程并上传到GitHub。只传了Class文件，这个时候验证podspec是通不过的。
会报如下错误：
-> XLPhotoBrowser (1.0.0)
- ERROR | [iOS] xcodebuild: Returned an unsuccessful exit code. You can use `--verbose` for more information.
5.3.swift版本不对
[!] The validator for Swift projects uses Swift 2.3 by default, if you are using a different version of swift you can use a `.swift-version` file to set the version for your Pod. For example to use Swift 3.0, run:
`echo "3.0" > .swift-version`.
使用echo "3.0" > .swift-version命令即可。
5.4.podspec文件配置不对。
之前用pod spec create XLPhotoBrowser命令生成的，大概看了下要配置的地方（看名字就知道配置的是什么）。发现太杂，太多配置用不上，就全删了用其它成功上传的podspec内容替换，再配置相关内容。
需要注意的是s.source_files参数，如果配置为s.source_files = '/*.{h,m}’，会报错：
- ERROR | File Patterns: File patterns must be relative and cannot start with a slash (source_files).
其它可能的报错：
-> XLPhotoBrowser (1.0.0)
- ERROR | [iOS] file patterns: The `source_files` pattern did not match any file.
此处，直接使用 s.source_files = 'XLPhotoBrowser/**/*.{h,m}’即可
5.5.如果依赖了其它CocoaPods第三方库
请使用s.dependency配置，如 s.dependency "SDWebImage", "~> 3.7.1"
配参过程中可参考以下附录内容，或查看链接：
https://github.com/xiaoL0204/XLPhotoBrowser/blob/master/XLPhotoBrowser.podspec
5.6.忘记打tag
报错如下，使用git tag 1.0.0命令即可
Validating podspec
-> XLPhotoBrowser (1.0.0)
- ERROR | [iOS] unknown: Encountered an unknown error ([!] /Applications/Xcode.app/Contents/Developer/usr/bin/git clone https://github.com/xiaoL0204/XLPhotoBrowser.git /var/folders/w1/95fypdq96l92t55frcn0yhyh0000gn/T/d20161206-1790-put1kd --template= --single-branch --depth 1 --branch 1.0.0
Cloning into '/var/folders/w1/95fypdq96l92t55frcn0yhyh0000gn/T/d20161206-1790-put1kd'...
warning: Could not find remote branch 1.0.0 to clone.
fatal: Remote branch 1.0.0 not found in upstream origin
) during validation.
[!] The spec did not pass validation, due to 1 error.
附录
1.XLPhotoBrowser.podspec文件内容为：
Pod::Spec.new do |s|
s.name = 'XLPhotoBrowser'
s.version = '1.0.1'
s.summary = 'a component of photo browser on iOS'
s.homepage = 'https://github.com/xiaoL0204/XLPhotoBrowser'
s.description = <<-DESC
It is a component for ios photo browser,written by Objective-C.
DESC
s.license = 'MIT'
s.authors = {'xiaoL0204' => 'xiaol0204@qq.com'}
s.platform = :ios, '6.0'
s.source = {:git => 'https://github.com/xiaoL0204/XLPhotoBrowser.git', :tag => s.version}
s.source_files = 'XLPhotoBrowser/**/*.{h,m}'
s.dependency "SDWebImage", "~> 3.7.1"
s.requires_arc = true
end
</br>
2.项目、Demo地址
GitHub地址：https://github.com/xiaoL0204/XLPhotoBrowser
3.CocoaPods中如何使用该组件：
platform :ios,'7.0'
target ‘PhotoBrowserDemo' do
pod 'XLPhotoBrowser', '~>1.0.1'
end
