CocoaPods创建一个公开库

1. 把待公开的项目上传gitHub远程仓库。

  • 此处项目代码提交git服务器过程略,详情参考文章Git Shell命令

注:代码提交git成功后,打好我们的发布版本tag值,如:0.0.1

2. 安装CocoaPods。

3. 创建和编写.podspec文件。

  1. 创建.podspec文件命令如下:
    $ pod spec create Name
    

注:Name为创建的.podspec文件名字,一般取与工程文件相同的名字。

  1. .podspec编写

    创建的Name.podspec文件打开可看到一个默认的模版,我们可在默认模版基础上修改,也可参考gitHub上一些优秀的第三方库的.podspec文件,如:AFNetworking库的AFNetworking.podspec文件,直接复制内容然后按照自己的项目修改。
    如本人公开的一个基于FMDB封装的数据库升级库FMDBUpgradeFMDBUpgrade.podspec文件内容如下:

Pod::Spec.new do |s|
  s.name         = "FMDBUpgrade"
  s.version      = "1.0.1"
  s.summary      = "Upgrade database extension class based on FMDB."
  s.homepage     = "https://github.com/yangyongzheng/FMDBUpgrade"
  s.license      = "MIT"
  s.author       = { "yangyongzheng" => "youngyongzheng@qq.com" }
  s.source       = { :git => "https://github.com/yangyongzheng/FMDBUpgrade.git", :tag => "#{s.version}" }
  s.requires_arc = true
  s.platform     = :ios, "8.0"
  s.source_files  = "UpgradeManager/FMDBUpgradeHeader.h"
  s.public_header_files = "UpgradeManager/FMDBUpgradeHeader.h"

  s.subspec "UpgradeManager" do |ss|
    ss.source_files = "UpgradeManager"
    ss.public_header_files = "UpgradeManager/*+Upgrade.h"
  end

  s.dependency "FMDB"

end

指定的源码路径以.podsepc文件所在文件夹开始推算,具体路径以具体项目库源码路径为准。

4. podspec文件校验

校验分为本地校验和远程仓库校验,校验之前要先设置好版本相对应的tag值

  1. 本地校验命令如下:
# 本地校验命令
$ pod lib lint
# 拼接了其他参数的本地校验命令
$ pod lib lint --allow-warnings --use-libraries --verbose

注:根据校验错误提示,自己按需求在$ pod lib lint后面拼接--allow-warnings--use-libraries—verbose等选项。

  • 具体使用可运行$ pod lib lint --help查看。
校验.png
  • 校验成功如下图所示:
本地校验成功.png

DatabaseManager passed validation.表示通过校验。其中有一个警告- WARN | url: There was a problem validating the URL http://twitter.com/yangyongzheng.,因为校验时我允许有警告所以可校验通过(pod lib lint命令默认是不允许有警告的)。

  1. 远程仓库源码校验
# 远程仓库校验
$ pod spec lint
# 允许有警告、使用静态库,打印校验日志命令
$ pod spec lint --allow-warnings --use-libraries --verbose
  • 校验拼接选项根本地校验一样,按自己需求拼接在$ pod spec lint后面。
  • 校验成功时如下图所示:
远程校验成功.png

5. 提交到官方检索库

上面第4步.podspec文件校验成功后,就可提交到官方检索库了。

  • 提交之前先注册提交账号,命令如下:
$ pod trunk register email@example.com 'Your Name' --description='Personal Laptop'

注册成功后,注册的邮箱会收到一份邮件,进入邮箱点击下邮件中的验证地址验证下就注册成功了,接下来就可以提交了...

  • 注册成功后提交的命令如下:
# If `PATH` is not provided, defaults to the current directory.
$ pod trunk push [PATH]
# 拼接选项和第4步校验拼接的选项要一致
$ pod trunk push --allow-warnings --use-libraries --verbose

注意:$ pod trunk push后面拼接的选项要和第4步$ pod spec lint校验拼接的选项一致。

6. 开始使用

上叙第5步提交成功后,就可以开始在项目中使用我们公开的库了。

  • 首先我们需要更新本地索引库:pod setup
  • setup完成后,执行pod search FMDBUpgrade

  • 如果搜索不到结果,删除search_index.json文件

    1. pod setup成功后会生成~/Library/Caches/CocoaPods/search_index.json文件。
    2. 终端输入rm ~/Library/Caches/CocoaPods/search_index.json删除检索文件。
    3. 删除成功后再执行pod search FMDBUpgrade就可以找到了。
  • 在项目的Podfile文件中加上:pod 'FMDBUpgrade',运行pod install --verbose --no-repo-update,至此大功告成。

7.更新维护

更新代码后,更新tag和podspec描述文件中版本,重新走一遍步骤4、5、6即可使用啦。

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

推荐阅读更多精彩内容