1. 创建私有Spec Repo
什么是Spec Repo?它是所有的Pods的一个索引,就是一个容器,所有公开的Pods都在这个里面,它实际是一个Git仓库remote端在GitHub上,但是当你使用了Cocoapods后它会被clone到本地的~/.cocoapods/repos目录下,可以进入到这个目录看到master文件夹就是这个官方的Spec Repo了。
第一步:先在GitHub上创建一个repository
创建好之后,需要使用的是下面这个链接:
第二步:在终端输入以下命令:
# pod repo add [Private Repo Name] [GitHub HTTPS clone URL]
pod repo add test https://github.com/jinyuisme/test.git
此时如果成功的话进入到~/.cocoapods/repos目录下就可以看到test(只是个名字,会根据你设置的名称而不同) 这个目录了。至此第一步创建私有Spec Repo完成。刚开始的时候你的test应该是空的,只是多个Specs-Repo文件夹而已。
2. 创建Pod项目工程文件
我们将要使用 Pod Lib Create来创建一个工程。 就拿我创建的test为例子具体讲一下这里是如何操作的,先cd到要创建项目的目录然后执行
pod lib create test
之后会问我们几个问题,1.选择一个平台:iOS;2.所使用的语言:(根据自己实际情况选择swift?objc);3.是否需要一个例子工程:Yes;4.选择一个测试框架:Specta;5.是否基于View测试:Yes;6.类的前缀:TS。 输入完成之后会自动执行pod install命令创建项目并生成依赖。
在目录中我们可以看到刚才创建的项目,目录就不一一列举,我们需要在文件夹中添加库文件和资源,并配置podspec文件。我把需要上传的组件放入test/Classes中,然后进入Example文件夹执行pod update命令,再打开项目工程可以看到,刚刚添加的组件已经在Pods子工程下Development Pods/PodTestLibrary中了,然后编辑demo工程,进行所需编译运行,没问题我们再进行下一步操作。
3.添加并提交到远端仓库
在终端继续操作
git add .
git commit -s -m "Initial Commit of Library"
git remote add origin [email protected]:jinyuisme/test.git #添加远端仓库
git push origin master #提交到远端仓库
如果输入$ git remote add origin [email protected]:jinyuisme(github用户名)/test(项目名).git 提示出错信息:fatal: remote origin already exists.
解决办法如下:
git remote rm origin
git remote add origin [email protected]:jinyuisme/test.git
然后继续执行git push origin master操作,如果出现以下信息,说明操作不成功
问题原因:
在git上没有创建SSH Key
解决方法:
继续在终端输入以下指令
ssh-keygen -t rsa -C "username" (注:username为你git上的用户名)
三次回车,如有看到The key's randomart image is,代表你的SSH Key生成成功了。然后输入指令:
cat ~/.ssh/id_rsa.pub
ssh-rsa AAAAB 开头的一长串就是你的SSH Key了。
然后将一长串SSH Key粘贴到自己的git账户上。
然后再执行一次git push origin master操作,如果出现以下错误
输入
git push -f
然后再打上一个tag
git tag -m "first release" "0.1.0"
git push --tags #推送tag到远端仓库
4.编辑podspec文件
做完这些就可以开始编辑podspec文件了,以下就是我的podspec文件
Pod::Spec.new do |s|
s.name = 'test' #名称
s.version = '0.1.0' #版本号
s.summary = '这是一个工具类' #简短介绍
s.homepage = 'https://github.com/jinyuisme/test' #主页
s.license = { :type => 'MIT', :file => 'LICENSE' } #开源协议
s.author = { 'jinyuisme' => '[email protected]' } #作者信息
s.source = { :git => 'https://github.com/jinyuisme/test.git', :tag => s.version.to_s } #git地址
s.ios.deployment_target = '8.0' #最低支持的ios版本
s.source_files = 'test/Classes/**/*' #开源类
s.dependency 'AFNetworking', '~> 2.3' #pod第三方依赖
s.requires_arc =true #是否要求ARC
end
补充1:s.source_files常见写法
"Directory1/*"
"Directory1/Directory2/*.{h,m}"
"Directory1/**/*.h"
“*” 表示匹配所有文件
“*.{h,m}” 表示匹配所有以.h和.m结尾的文件
“**” 表示匹配所有子目录
补充2:s.source常见写法
s.source = { :git=>'https://github.com/jinyuisme/test.git', :commit=>"68defea"}
s.source = { :git=>'https://github.com/jinyuisme/test.git', :tag=>0.1.0}
s.source = { :git=>'https://github.com/jinyuisme/test.git', :tag=>s.version.to_s }
commit => "68defea" 表示将这个Pod版本与Git仓库中某个commit绑定
tag => 0.1.0 表示将这个Pod版本与Git仓库中某个版本的comit绑定
tag => s.version.to_s 表示将这个Pod版本与Git仓库中相同版本的comit绑定
5.验证podspec 有效性
编辑好.podspec文件之后最好先验证下有效性
pod spec lint test.podspec
验证过程中:
-> test (0.1.0)
验证成功:
test.podspec passed validation.
验证失败:(验证失败有很多种情况,以下进行列举)
1.只有警告
[!] The spec did not pass validation, due to 1 warning (but you can use `--allow-warnings` to ignore it). #这个最简单,也是最好处理,直接在后面拼接--allow-warnings即可,例:
pod spec lint test.podspec --allow-warnings
2.有一些错误我们不知道原因,可以在后面添加--verbose来查看
pod spec lint test.podspec --verbose
如果出现如下错误,说明第三方库中包含了.a静态库造成的。虽然并不影响Pod的使用,但是验证是无法通过的。可以通过 --use-libraries 来让验证通过。
pod spec lint test.podspec --verbose --use-libraries
这种情况下使用 --use-libraries 虽然不会出现错误(error),但是有时候会带来一些警告(waring),警告同样是无法通过验证的。这时可以用 --allow-warnings 来允许警告。
pod spec lint test.podspec --verbose --use-libraries --allow-warnings
6.发布到CocoaPods
我们使用 Trunk 服务可以方便的发布自己的Pod。CocoaPods Trunk 服务的引入,解决了很多类似的问题。每次使用 Trunk 服务发布 Pod 时都会通过 $ pod lint 验证 .podspec 是否有效。要想使用 Trunk 服务,首先需要使用如下命令注册自己的电脑。这很简单,只要你指明你的邮箱地址(spec文件中的)和名称即可。CocoaPods 会给你填写的邮箱发送验证邮件,点击邮件中的链接就可通过验证。
pod trunk register [email protected] "jinyuisme"
# pod trunk register [github 邮箱] ["github用户名"],点击邮箱中的链接点击之后跳转如下页面表示注册成功
然后就可以发布你的 Pod 了。
pod trunk push test.podspec
发布时会验证 Pod 的有效性,如果你在手动验证 Pod 时使用了 --use-libraries 或 --allow-warnings 等修饰符,那么发布的时候也应该使用相同的字段修饰,否则出现相同的报错。
pod trunk push test.podspec --use-libraries --allow-warnings
发布成功之后我们就可以使用我们添加的pod了。
由于 pod search 是搜索的本地“~/.cocoapods”,所以在其他设备上可能无法搜到。这时只需要执行 pod install 更新下 pod 仓库即可(不要加 --no-repo-update)。
7.更新pod版本
当需要更新 Pod 版本的时候,修改 .podspec 中的 s.version 为更高的版本号,并修改 s.source 中对应的 Git 版本。提交到Git,并打上对应tag。然后再次执行pod trunk push test.podspec将新的 .podspec 发布到 CocoaPods。更新完成!
为了更新更加方便,版本控制更加清晰,s.source 建议采用如下写法:
s.source = { :git => 'https://github.com/jinyuisme/test.git', :tag => s.version.to_s
这样写将 Git 的版本与 CocoaPods 的版本进行了绑定。每次提交后再给本次提交打上 tag 就完成了更新。而且在 Git 中就可以清晰的看到哪次提交对应的哪个 CocoaPods 版本。