使用CocoaPods构建自己的公有库

类似于 AFNetworking、SDWebImage,我们也可以利用 CocoaPods 建立一个自己的公开库。

第一步 注册 Trunk

CocoaPods Trunk is an authentication and CocoaPods API service. To publish new or updated libraries to CocoaPods for public release you will need to be registered with Trunk and have a valid Trunk session on your current device.

CocoaPods Trunk is available starting with CocoaPods 0.33.

想要发布一个自己库,需要注册 Trunk,且 CocoaPods 版本在0.33及以上。

We recommend including a description with your session to give some context when you list your sessions later. For example:

$ pod trunk register orta@cocoapods.org 'Orta Therox' --description='macbook air'

开始注册:

$ pod trunk register email(自己的邮箱) 'name(昵称)' --description='macbook pro(随便写点)'

按下回车,注册完成!此时你的邮箱会受到一封邮件,打开邮件里面有个链接,需要点击确认一下

接下来输入以下命令,查看注册信息:

$ pod trunk me

第二步 创建项目

There are only a few differences between a CocoaPod and a generic open source library. The most important ones, aside from the actual source, are the .podspec and LICENSE.

使用CocoaPods构建公开库需要 .podspecLICENSE两个文件。

1、github上创建一个项目 VJUtils ,并添加 LICENSE(通常选择MIT类型) 文件,然后 clone 到本地。

image

将我们准备开源的文件放入刚刚创建的 VJUtils 项目中,如图:

image

其中 VJUtils 文件夹是准备开源的文件, VJUtils.podspec 文件下文会提到。

2、在工程根目录中初始化一个 .podspec 描述文件
输入命令:

$ pod spec create VJUtils.podspec

就会出现上图中 VJUtils.podspec 描述文件,打开文件并修改描述信息如下图:

image

参数说明:

  • s.name:库名,和.podspec名字保持一致。
  • s.versin:版本号。
  • s.ios.deployment_target:支持最低版本。
  • s.summary:简介
  • s.homepage:项目主页地址
  • s.license:许可证
  • s.author:作者
  • s.source:项目的地址
  • s.source_files:需要包含的源文件
  • s.requires_arc:是否支持ARC

其它:

  • s.social_media_url:社交网址,你的podspec发布成功后会@你

  • s.dependency:依赖库,不能依赖未发布的库,例如:

    s.dependency 'AFNetworking'

未涉及到的请看官方文档

第三步 上传项目到 GitHub,并打上 tag

1、上传到 GitHub

git add .
git commit -m '1.0.0 release'
git push

2、打上 tag

git tag 1.0.0
git push origin 1.0.0

tag 的版本号要和 .podspec 中的版本号保持一致。

第四步 验证 .podspec 文件

两种方式验证:

第一种:$ pod lib lint

第二种:$ pod spec lint VJUtils.podspec --verbose

  • verbose:输出详细信息

我使用的第二种,输出结果如下:

image

验证成功!如果验证出错,请看文章末尾。

两种方式验证的不同之处:

The difference between them is that pod lib lint does not access the network, whereas pod spec lint checks the external repo and associated tag.

pod lib lint 是只从本地验证你的 pod 能否通过验证.

pod spec lint 是从本地和远程验证你的 pod 能否通过验证.

第五步 发布

输入:

$ pod trunk push VJUtils.podspec

会输出一段很长的描述,然后会看到如图成功提示:

image

最后一步!验证!

首先删除 ~/Library/Caches/CocoaPods目录下的 search_index.json 文件。

然后执行搜索

$ pod search VJUtils

就会出现你要搜索的库了!公有库的创建到此结束。

以上步骤中可能出现的错误

1、出现

ERROR | [iOS] unknown: Encountered an unknown error (Could not find a ios simulator (valid values: com.apple.coresimulator.simruntime.ios-12-2, com.apple.coresimulator.simruntime.tvos-12-2, com.apple.coresimulator.simruntime.watchos-5-2). Ensure that Xcode -> Window -> Devices has at least one ios simulator listed or otherwise add one.) during validation.

升级CocoaPods:

$ sudo gem install cocoapods

2、出现

warning: inexact rename detection was skipped due to too many files.
warning: you may want to set your diff.renameLimit variable to at least 29913 and retry the command.

输入以下命令:

$ git config merge.renameLimit 999999
$ git config --unset merge.renameLimit

3、出现

[!] There was an error pushing a new version to trunk: execution expired

执行:

$ pod trunk push VJUtils.podspec

若还是报这条错误,那就多试几次;

参考资料

CocoaPods官网 https://guides.cocoapods.org/making/index.html

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

推荐阅读更多精彩内容