将集成的开源代码上传到Cocoapods管理

1.前期工作

• 拥有github帐号(若没有，前往github.com注册即可)
• 事先将code准备好，如果是.a或者framework动静态库，就需要将库提前编译好，并且将 模拟器 和 真机 的库进行合并(lipo -create 路径1 路径2 -output 合并文件路径)，这样才能让所集成的app 集成一个库进而支持更多的 架构。否则第一是在上传检测podspec时会有警告，二是对于封装性来考虑的话就是支持不够，导致没人会愿意使用。
• 说明：这里我们以 framework 静态库为例。

2.准备工作和配置相关信息

• 在github上创建工程
• 

  新建工程.png

• 打开终端将远程仓库克隆到本地

  
  
  

  clone仓库.png
• 在git仓库目录下创建.podspec配置文件(名称和工程名保持一致)

$ cd XXXFramework
$ pod spec create XXXFramework  

• 将已经准备好的 framework 添加到git目录下，然后执行命令提交

$ git add .  // 提交所有添加的文件
$ git commit -m "描述信息" // 提交修改
$ git tag '1.0.0'  // 为当前版本标记tag, 这个是一定要做的!!! 因为pod需要根据版本号确定引用
$ git push --tags // 提交当前标记的tag
$ git push origin master // push修改到远程仓库，git push 也可以

• 使用终端或者Sublime编辑XXXFramework.podspec文件进行信息配置

Pod::Spec.new do |s|
  s.name             = "XXXFramework"
  s.version          = "1.0.0"  // 这个一定要与当前版本的tag相对应
  s.summary          = "这里写简介信息"
  s.description      = <<-DESC
 这里写描述信息，并且尽量保证比简介信息要更多更全面，否则后面验证会有警告(虽然警告没有影响，但是我们尽量做到验证的时候没有警告)。
                       DESC
  s.homepage         = "github的项目地址"
  s.license          = 'MIT'
  s.author           = { "github的帐号" => "github帐号对应的邮箱" }
  s.source           = { :git => "github上面的对应工程的git地址(例如：https://github.com/xxxx/XXXFramework.git)", :tag => s.version }
  s.platform     = :ios
  s.ios.deployment_target = '8.0'
  # s.osx.deployment_target = '10.7'
  s.requires_arc = true

  #s.source_files = 'WZMarqueeView/*'
  # s.resources = 'Assets'

  # s.ios.exclude_files = 'Classes/osx'
  # s.osx.exclude_files = 'Classes/ios'
  # s.public_header_files = 'Classes/**/*.h'
  s.vendored_frameworks = "RoyFramework.framework" 
  s.frameworks = "Foundation", "UIKit"
end

ps: 这里面用不到的可以直接注释掉(#).这里对可能用到的配置进行说明

s.name  // 导入pod后的目录名
s.version // 当前版本号
s.license // 类型，这里直接填写MIT
s.author // 用户信息
s.source // 所引用的代码源地址
s.platform // 适用平台
s.ios.deployment_target // 最低的系统版本
s.requires_arc // 是否要求arc
s.prefix_header_file // 预编译头文件路径，将该文件的内容插入到pod的pch文件中
===重点====
s.source_files   // 将上传的代码文件，路径从.podspec开始，如果是开源的.h .m 文件，就需要写成路径/*.{h,.m}, 例如"Classes/**/*.{h,m}
s.resources // 资源文件，图片或者xib文件
s.vendored_frameworks // 本地最后自己打包的frameworks
s.frameworks // 指定需要使用的系统frameworks, 例如：UIKit, Foundation
s.preserve_paths // 本地自己导入的.a库
s.dependency //指定依赖，如果依赖的库不存在或者依赖库的版本不符合要求将会报错
s.libraries // 指定导入的库，比如sqlite3
s.weak_frameworkds // 弱链接，比如说一个项目同时兼容iOS和iOS7, 但某一个framework只有在iOS7上有，这时如果使用强连接，那么在iOS7上运行就会crash, 使用weak_frameworks可以便面这种情况

通配符说明

a{bb,bc}def.{h,m}表示四个文件abbdef.h abbdef.m abcdef.h abcdef.m
*.{h,m,mm}表示所有的.h .m .mm文件
Class/**/*.{h,m}表示Class目录下的所有.h .m文件

3.验证编写的 podspec 文件

• 使用命令来验证编写的podspec文件是否正确

$ pod spec lint
如果出现--allow-warnings的警告那么执行下面这句消除警告
$ pod spec lint --allow-warnings
如果出现错误信息，则按照提示进行修改
-> XXXFramework (1.0.0)  
XXXFramework passed validation.  
出现上面这个显示，则表示通过了验证，就可以进行下一步的操作

4.通过 trunk 上传 spec 到 cocoapods

• 查看当前终端的git帐号是否已经注册trunk

$ pod trunk me
// 如果现实帐号信息则表示已经注册过就可以直接push 面的操作：例如
 - Name:     xxx
  - Email:    [email protected]
  - Since:    March 27th, 04:39
  - Pods:
    - xxxxxx
  - Sessions:
    - March 27th, 04:39 - August 2nd, 04:55. IP: 116.228.209.98
// 否则就需要注册trunk帐号
$ pod trunk register [email protected] '名字' --verbose
// 然后收到邮件之后点击进入邮件中的链接出现 ACE, YOU'RE SET UP 就表示注册成功

• 执行 trunk push 操作提交至 cocoapods

$ pod trunk push XXXFramework.podspec

• 等待审核，出现如下信息

  
  
  

  审核通过，发布成功

5.验证

• pod repo update // 更新cocoapods本地索引
• pod search XXXFramework // 成功之后即可搜索到
• 若出现报错信息
  [!] Unable to find a pod with name, author, summary, or description matching XXXFramework
  则需要将之前的搜索索引删除：

rm ~/Library/Caches/CocoaPods/search_index.json

重新搜索从远程拉取索引文件：

pod search XXXFramework

6.版本迭代和更新

• 只需要正常提交版本到 github 仓库, 并且一定要打 tag 标记，然后更改 .podspec 中的 version 和 其他需要修改的信息 然后再次验证，通过之后使用 trunk 提交即可~