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

96
Manba_小洛
2017.03.29 00:22* 字数 536

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:    xxxabc123@qq.com
  - 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 XXX@XXX.com '名字' --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 提交即可~
IOS