使用CocoaPods创建私有仓库 spec repo

1. 创建私有Spec Repo

什么是Spec Repo?它是所有的Pods的一个索引,就是一个容器,所有公开的Pods都在这个里面,它实际是一个Git仓库remote端在GitHub上,但是当你使用了Cocoapods后它会被clone到本地的~/.cocoapods/repos目录下,可以进入到这个目录看到master文件夹就是这个官方的Spec Repo了。

第一步:先在GitHub上创建一个repository


使用CocoaPods创建私有仓库 spec repo_第1张图片
创建一个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工程,进行所需编译运行,没问题我们再进行下一步操作。


使用CocoaPods创建私有仓库 spec repo_第2张图片
导入相关文件


使用CocoaPods创建私有仓库 spec repo_第3张图片
xcode中的pod目录

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操作,如果出现以下信息,说明操作不成功


使用CocoaPods创建私有仓库 spec repo_第4张图片
未添加ssh key

问题原因:

在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了。


使用CocoaPods创建私有仓库 spec repo_第5张图片
创建SHH key成功

然后将一长串SSH Key粘贴到自己的git账户上。


使用CocoaPods创建私有仓库 spec repo_第6张图片
粘贴SSH Key

然后再执行一次git push origin master操作,如果出现以下错误


使用CocoaPods创建私有仓库 spec repo_第7张图片
rejected

输入

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用户名"],点击邮箱中的链接点击之后跳转如下页面表示注册成功


使用CocoaPods创建私有仓库 spec repo_第8张图片
注册成功

然后就可以发布你的 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 版本。

你可能感兴趣的:(使用CocoaPods创建私有仓库 spec repo)