使用CocoaPods创建私有仓库 spec repo

1. 创建私有Spec Repo

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

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


创建一个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工程,进行所需编译运行,没问题我们再进行下一步操作。


导入相关文件


xcode中的pod目录

3.添加并提交到远端仓库

在终端继续操作

git add .     

git commit -s -m "Initial Commit of Library"

git remote add origin git@github.com:jinyuisme/test.git #添加远端仓库

git push origin master #提交到远端仓库

如果输入$ git remote add origin git@github.com:jinyuisme(github用户名)/test(项目名).git 提示出错信息:fatal: remote origin already exists.

解决办法如下:

git remote rm origin

git remote add origin git@github.com:jinyuisme/test.git

然后继续执行git push origin master操作,如果出现以下信息,说明操作不成功


未添加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了。


创建SHH key成功

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


粘贴SSH Key

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


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' => 'EX-ZHANGJINYU001@pingan.com.cn' } #作者信息

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 872455130@qq.com "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 版本。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,835评论 4 364
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,598评论 1 295
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 109,569评论 0 244
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,159评论 0 213
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,533评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,710评论 1 222
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,923评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,674评论 0 203
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,421评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,622评论 2 245
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,115评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,428评论 2 254
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,114评论 3 238
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,097评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,875评论 0 197
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,753评论 2 276
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,649评论 2 271

推荐阅读更多精彩内容