CocoaPods 私有库配置

前情提要

看了好多网上的CocoaPods私有库配置,看的是一知半解,写的都不是很详细,还是需要自己实际操作。实践是检验真理的唯一标准。在这里,我把最正确最详细的步骤展示给大家。因为私有库的配置对项目模块化具有很大的作用,具体有多大的好处和作用,可能会在文章的最后也可能后续文章会说到,现在开始我们的私有库配置,也是我将项目模块化的第一步。
官方文档 中文翻译

第一步 创建一个私有的仓库

也就是创建本地repo

首先在你的服务器上创建一个仓库。可以是在Github上或者是你自己的服务器如下

$ cd /opt/git
$ mkdir Specs.git
$ cd Specs.git
$ git init --bare

第二步 添加你的私有库到你的CocoaPods中

使用你服务器上的仓库的URL,添加你的仓库使用:

$ pod repo add Repo_Name SOURCE_URL

Repo_Name:你自己取得私有库的名字
SOURCE_URL:是你第一步创建私有库的URL地址

成功后,你可以额检查是否成功安装,通过

$ cd ~/.cocoapods/repos/REPO_NAME
$ pod repo lint .
验证成功如图

第三步 创建我们的私有库中的自定义Library

通过CocoaPods为我们提供的模板,可以自动创建一个项目,供我们创建自定义Lib

pod lib create MyLibrary

MyLibrary:是自定义Lib的名字,自取

可以使用自己的模板,因为这句命令其实是缩写,其完整应该是 pod lib create MyLibrary --template-url= https://github.com/cocoapods/pod-template,可以把=后面的URL替换成你自己的模板URL,不过我想几乎没人会用自己的模板吧(应该不会打脸吧,反正我用的是默认的)。

然后会问你一些问题来完成默认的配置。第一个问题是邮箱:

What is your email?
 > XXXX@163.com

然后接下来的一系列问题

XXXXXX$ pod lib create QGGImagePicker
Cloning `https://github.com/CocoaPods/pod-template.git` into `QGGImagePicker`.
Configuring QGGImagePicker template.
------------------------------
To get you started we need to ask a few questions, this should only take a minute.
If this is your first time we recommend running through with the guide: 
 - http://guides.cocoapods.org/making/using-pod-lib-create.html
 ( hold cmd and double click links to open in a browser. )
What language do you want to use?? [ ObjC / Swift ]
 > ObjC
Would you like to include a demo application with your library? [ Yes / No ]
 > Yes
Which testing frameworks will you use? [ Specta / Kiwi / None ]
 > Specta
Would you like to do view based testing? [ Yes / No ]
 > Yes
What is your class prefix?
 > QGG

第一个问题是你用的什么语言,不多说了。
第二个问题是问你要不要包含一个Demo,来测试你的Library。有了这个demo后,你可以用pod try MyLib获取到能测试你Library的Demo。
第三个问题是让你选择一个测试的framework,保证你的library的稳定性。官方推荐Specta。
第四个问题是问你是否要基于视图的测试。
第五个问题,让你所有的Class加上一个前缀。

直接回车会选择选项中带下划线也就是默认项。

然后将你的Lib代码放入到模板项目中,文件路径参照下图:

文件路径参照图

非常重要的一点

先声明我是这样操作的,网上并没有看到接下来的操作,都非常跳跃,说的很少。

我将项目复制出来,是打开项目,将里面的文件夹复制出来,如下图:

复制这些文件

!!!!注意:不是在最外层将整个项目文件夹复制出来,因为是用模板自动生成出来的,所以细心的同学会发现这个项目中有自动生成的.git、.gitignore隐藏文件!!!!

隐藏文件见此图

我一开始的时候直接在github上建了个Lib的Repository,然后直接check out 到本地,然后将模板自动生成项目到Lib的工作目录,发现根本没发现文件有修改,没东西上传到github。所以问题出在了通过模板自动生成的项目对应提交的git目录也指向了生成时的模板URL。我开始还费解怎么没法上传修改后的代码,搞了半天问题出在这,坑死爹了!!!

恩,发现问题后就感觉如履平地。然后按照我上面所说的复制出来文件到check out出来的目录,然后就能上传代码到git了,注意打个tag,原因看下面一段,

你会在项目里看到一个后缀名为.podspec的文件,这个文件很重要,这是Lib的Pod配置文件。打开,很多工具可以打开,我用的是Sublime Text。打开大致是这样的内容

Pod::Spec.new do |s|
  s.name             = 'MyLibrary'
  s.version          = '0.1.0'
  s.summary          = 'Test of MyLibrary.'
  s.description      = <<-DESC
TODO: Add long description of the pod here.
                       DESC

  s.homepage         = 'https://github.com/jiabibi888/MyLibrary'

  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'jiabibi888' => 'zhangjiabi9149@163.com' }
  s.source           = { :git => 'https://github.com/jiabibi888/MyLibrary.git', :tag => s.version.to_s }

  s.ios.deployment_target = '8.0'

  s.source_files = 'MyLibrary/Classes/**/*'
  
end

默认出来就是这样,配置文件基本已经没问题了,不用自己再参照官方语法写了。接下来解释为什么要打一个tag,你会看到第二个参数s.version = '0.1.0',这个版本你可以修改,是用来标注你Lib版本的。以tag=0.1.0为例,然后往下看 s.source = { :git => 'https://github.com/jiabibi888/MyLibrary.git', :tag => s.version.to_s },它会通过tag去取资源,所以你需要打一个tab,不然获取不到代码资源。

就像上面说的配置文件基本已经没问题,你只要注意看下s.homepage = 'https://github.com/jiabibi888/MyLibrary'和s.source = { :git => 'https://github.com/jiabibi888/MyLibrary.git', :tag => s.version.to_s }中的URL是否正确,即可。可用pod lib lint 和 pod spec lint来验证你的podspec文件是否正确。两个指令的不同点在于pod lib lint不用访问网路,而pod spec lint检查外部repo和相关标签。

下面是是用pod spec lint命令来验证的具体情况:

$ pod spec lint

 -> MyLibrary (0.1.0)

Analyzed 1 podspec.

MyLibrary.podspec passed validation.

好,到这一步,你的Lib创建已经成功。

第四步 添加你的Podspec到你的仓库

确定你已经给你的代码资源打上tag和版本,然后运行

$ pod repo push REPO_NAME SPEC_NAME.podspec

成功以后是这样的情况:

$ pod repo push TestSpec MyLibrary.podspec

Validating spec
 -> MyLibrary (0.1.0)

Updating the `TestSpec' repo

Already up-to-date.

Adding the spec to the `TestSpec' repo

 - [Add] MyLibrary (0.1.0)

Pushing the `TestSpec' repo

To https://github.com/XXXX/TestSpec.git
   a63caee..dd11098  master -> master

Congratulations!!!

自此,一个你自定义的Lib成功加入到了你的私有库中。

可以将私有库中的.podspec文件转成.json

$ pod ipc spec MyLibrary.podspec >> MyLibrary.podspec.json

支持CocoaPods公开库

https://github.com/CocoaPods/Specs.git 下fork一份

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

推荐阅读更多精彩内容