在GitHub上分享自己的第三方框架以供pod使用

一、在GitHub上创建项目

1.在GitHub上创建一个项目，包括开源协议。
2.先clone到本地，放入第三方框架，然后push。

二、在GitHub上创建Tag

我们可以创建一个tag来指向软件开发中的一个关键时期，比如版本号更新的时候可以建一个“v2.0”、“v3.1”之类的标签，这样在以后回顾的时候会比较方便。tag的使用很简单，主要操作有：查看、创建、删除、验证、上传。

1、查看

列出所有tag：
git tag 这样列出的tag是按字母排序的，和创建时间没关系。
如果只是想查看某些tag的话，可以加限定：git tag -l v1.* 这样就只会列出1.几的版本。

2、创建

git tag -a v1.0 -m 'first version' -m后面带的就是注释信息，这样在日后查看的时候会很有用，这种是普通tag。
还有一种有签名的tag：git tag -s v1.0 -m 'first version' 前提是你有GPG私钥，把上面的a换成s就行了。
除了可以为当前的进度添加tag，我们还可以为以前的commit添加tag：

1. 首先查看以前的commit: git log --oneline
2. 假如有这样一个commit：8a5cbc2 updated readme
3. 这样为他添加tag: git tag -a v1.18a5cbc2

3、删除

git tag -d v1.0
本地删除好像不会同步到GitHub上，可以在GitHub项目里直接删除。

4、验证

如果你有GPG私钥的话就可以验证tag：git tag -v v1.0

5、上传

我们在执行git push的时候，tag是不会上传到服务器的，比如现在的github，创建tag后git push，在github网页上是看不到tag的，为了共享这些tag，你必须这样：上传所有tag：git push origin --tags 上传某个tag：git push origin v1.0

三、创建 .podspec 文件进行配置

在工程根目录中初始化一个Podspec文件：pod spec create UMessage_1.5.0a.podspec
Podspec文件内容：

Pod::Spec.new do |s| 
  s.name         = "UMessage_1.5.0a"
  s.version      = "1.5.0a"
  s.summary      = "无IDFA版本"
  s.description  = <<-DESC
                   U-Push 友盟官方 SDK
                   DESC
  s.homepage     = "https://github.com/ZhugeZhan/UMessage_1.5.0a"
  s.license      = { :type => "MIT", :file => "LICENSE" }
  s.author       = { "ZhugeZhan" => "[e-mail]" }
  s.platform     = :ios, "8.0"
  s.source       = { :git => "https://github.com/ZhugeZhan/UMessage_1.5.0a.git", :tag => "#{s.version}" }
  s.source_files = "UMessage_Sdk_1.5.0a", "UMessage_Sdk_1.5.0a/**/*.{h,m}"
  s.vendored_libraries = 'UMessage_Sdk_1.5.0a/**/*.a'
  s.framework   = "UserNotifications"
  s.library     = "z"
end

说明：
s.name是我们库的名称（和Podspec文件名一致）
s.version是库原代码版本号
s.summary是对我们库的一个简单的介绍
s.homepage声明库的主页
s.license是所采用的授权版本
s.author是库的作者
s.platform是我们库所支持的软件平台，这在我们最后提交进行编译时有用
s.source声明原代码的地址
s.source_files声明了我们库的源代码的位置（从项目根目录文件夹下开始）
目录的层级关系一定要跟代码库的保持一致。这里前一部分可以不用的，因为我这里后一部分的HUPhotoBrowser/*与前面是一致的，这个指定的目录下的文件都会进行编译。.{h,m}是一个类似正则表达式的字符串，表示匹配所有以.h和.m为扩展名的文件。
s.source声明原代码的地址
s.source_files声明了我们库的源代码的位置（从项目根目录文件夹下开始）
目录的层级关系一定要跟代码库的保持一致。这里前一部分可以不用的，因为我这里后一部分的HUPhotoBrowser/*与前面是一致的，这个指定的目录下的文件都会进行编译。.{h,m}是一个类似正则表达式的字符串，表示匹配所有以.h和.m为扩展名的文件。
s.resourcs声明如果该目录下还有一些资源文件（如图片等），这些文件并不需要进行编译。
s.vendored_libraries声明了所需要的静态库文件（框架里面自带的）
s.library声明了所依赖的系统静态库文件（多个s.libraries = "A", "B"）
s.framework 声明了所依赖的核心库 （多个s.frameworks = "A", "B"）
s.dependency 我们开发的库中也可能还依赖第三方库，例如JSONKit，那么，就可以做如下声明: s.dependency "JSONKit", "~> 1.4"
如果有多个需要填写多个 s.dependency

编辑完podspec文件后，需要验证一下这个文件是否可用，如果有任何WARNING或者ERROR都是不可以的，它就不能被添加到Spec Repo中，不过xcode的WARNING是可以存在的，验证需要执行命令：pod spec lint UMessage_1.5.0a.podspec
注：不建议尝试。如果框架只使用静态库需要加上--use-libraries，但是这会导致 use_frameworks! 不能把框架用pod导入项目，使用swift的人也无法使用。

四、发布到 Cocoapods 进行管理

1、注册Trunk（第一次需要注册）
pod trunk register [e-mail] 'ZhugeZhan' --description='macbook air'
大家在注册时需要替换成自己的邮箱和用户名，一切顺利的话就会收到一份邮件，点击邮件中的链接后验证一下。
邮件验证完成之后pod trunk me
当然，如果你的pod是由多人维护的，你也可以添加其他维护者:
pod trunk add-owner ARAnalytics [e-mail]

2、Trunk push
pod trunk push 命令会首先验证你本地的podspec文件(是否有错误)，之后会上传spec文件到trunk，最后会将你上传的podspec文件转换为需要的json文件。在包含有.podspec目录下执行命令：pod trunk push

如果你能看的上面的结果说明上传成功了。

3、pod search 没有结果

先执行 pod setup
执行完之后，可以根据下面截图的步骤:打开地址，点击SeePodspec，然后在本地的~/.cocoapods/repos/master/Specs目录下 看到转换之后的json文件。

然后执行 rm ~/Library/Caches/CocoaPods/search_index.json
这样再pod search 就会先更新search_index.json文件，就能找到结果了。
至此我们整个制作自己的开源库的过程就完成了，以后有新版本需要在GitHub上创建新的tag，然后修改podspec文件（s.version一定要改）就行了，然后重新执行pod trunk push命令。

五、怎么删除提交到cocoapods上的框架？

pod trunk delete AFNetwroing 3.0.1 来删除指定版本的pods （未验证）

六、参考文章：

《如何发布自己的开源框架到CocoaPods》http://www.cocoachina.com/ios...
《如何使用Cocoapods管理自己github上的项目，并让其支持pod》http://www.jianshu.com/p/f146...
《GitHub创建Tag》 http://caibaojian.com/github-...