将集成的开源代码上传到Cocoapods管理
2017-03-29 本文已影响51人
Manba_小洛
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 提交即可~
