发布自己的工具代码/框架到CocoaPods
2018-01-17 本文已影响61人
黄鱼夥夥来
-
写在前面
可能你经常会写一些自用的小工具或者框架。但是，每次新建工程都要拷贝这些东西，实在会很神烦。既然有依赖库的管理工具，那么自然要好好使用才是。
鉴于由本地链接github远端仓库并上传代码略繁琐，在此举一个简单点的例子，供参考。
-
前提条件
github 账号 (没有账号的先去自己申请一下)
梯子 (实在不知道怎么弄梯子的，去github搜官方的Lantern下载下来用)
iTerm (好用的终端)
-
在github上新建一个库
一定要注意 .gitignore 和 license 的选择。不懂的，按照图中的选择来即可。点击 Create repository 即可完成创建。
创建github仓库.png
然后，创建一个 README 文件。(此文件是为了后续写一些使用、介绍之类的具体文档)
-
打开
iTerm或者Mac自带终端将代码克隆到本地
cd Desktop
git clone 你的github仓库地址
clone github仓库代码到本地.png
-
使用
trunk新建pod
1.注册 trunk
trunk需要CocoaPods 0.33版本以上，用pod --version命令查看版本，如果版本低，需要升级：
// Pod 版本检查
pod --version
// 版本升级
sudo gem install cocoapods --pre -n /usr/local/bin cocoapods
// trunk注册
pod trunk register xxxx.shaxxxnxxxx@xxxx.com 'Shaxxxon XXxxx' --description='shaxxxnxxxxx macbook pro' --verbose
加上
--verbose可以输出详细debug信息，方便出错时查看。
trunk注册.png
2. 验证并查看信息
注册后 CocoaPods 会给你的邮箱发送验证链接，点击后就注册成功了，可以用pod trunk me命令查看自己的注册信息。
查看信息.png
3. 创建 Podspec 描述文件
// 首先，转到项目内
cd 你的项目文件直接拖过来
// 初始化.podspec文件
pod spec create 你的项目名(不加后缀)
4. 编辑 Podspec 描述文件
编辑 podspec文件.png
5. push代码到github
在验证和上传你的 podspec 文件到 trunk 之前，需要将你的源码 push 到 Github 上，tag 一个版本号并发布一个 release 版本，这样 podspec 文件中的 s.source 的值才能是准确的：
git add -A && git commit -m "Release 0.0.1."
git tag '0.0.1'
git push --tags
git push origin master
6.验证
对于编辑完的 podspec 文件，需要验证一下这个文件是否可用，如果有任何 WARNING 或者 ERROR 都是不可以的，它就不能被添加到 Spec Repo 中，不过 Xcode 的 WARNING 是可以存在的，验证需要执行命令：
pod spec lint 你的podspec文件名.podspec
// 或者 pod lib lint 命令来验证
通过的话就验证成功，失败会告诉你错误的位置，一般很详细
验证成功
验证成功.png
验证失败
验证失败.png
此处失败的解决方案：
// 你可以将你的Xcode拖进终端内，看其路径
sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
7. 上传
// 命令
pod trunk push
上传失败
上传失败.png
上传失败解决方案 ：继续上传(上传失败是网络不稳、不好的缘故)
上传成功
上传成功.png
8. 查询自己的 pod
简单点，可以在 CocoaPods官网 自己查询。
命令行查询，首先要更新自己的本地 pod 库
// 更新本地 pod 库
pod repo update
更新成功.png
查询成功.png
