使用CocoaPods创建私有Spec Repo管理项目公共组件(上)

随着项目和业务的发展,项目中会有很多基础功能模块和通用业务模块可以抽象出来独立成组件,这样可以为我们以后在开发新项目的时候提供共用基础组件,进行组件化编程,不需要重新造轮子,节约人力物力,节约生命,提高开发效率。因此我们就需要一个方案来合理的管理公共的组件。

Git脚本 VS CocoaPods私有仓库

1、Git脚本:就是把我们的公共组件代码单独创建一个工程仓库,然后把代码放在里面,然后在我们需要用到的地方通过Git脚本命令将代码拉取下来,最后我们手动创建一个workplace把项目关联起来。这种方法简单粗暴,但是问题很多,比如版本不好控制,并且需要很多手动操作。操作一多就容易出问题,所以不推荐使用这种方式。
2、CocoaPods私有仓库:几乎全自动化,还可以对公共组件代码进行版本控制。我们在集成的时候可以按需获取指定版本。

Spec Repo的概念理解

CocoaPods对于一名iOS开发来说再熟悉不过了,它的工作原理就是在GitHub上面有个Spec Repo,它里面包括成千上万的podspec文件索引目录。然后我们在项目集成的时候可以通过它去找到我们需要的开源代码。其实CocoaPods的Spec Repo就是一个中介。

The Specs Repo is the repository on GitHub that contains the list of all available pods. Every library has an individual folder, which contains sub folders of the available versions of that pod.

一、创建私有 Spec Repo

按照上面的理解,我们如果能自己创建一个类似CocoaPods的Spec Repo,然后把我们公共组件的podspec文件放在里面,然后集成的时候让CocoaPods帮我们集成那我们就能达到目的。

  • 1、进入./cocoapods/repos 查看已经存在的spec repo,这个时候我们能看到一个master文件夹。
cd ~/.cocoapods/repos
ls
  • 2、在私有git服务器上创建自己的spec repo,
    这一步如果大家要创建私有仓库的话,应该在自己公司的git服务器上创建;我这里为了测试方便在GitHub上面创建的一个公有仓库。创建完成后在终端执行以下命令:
 # pod repo add [Private Repo Name] [Your GitHub HTTPS clone URL]
$ pod repo add HJSpecs https://github.com/OldGhost366/HJSpecs.git
  • 3、使用第1步中的命令进入目录我们发现多了一个HJSpecs文件夹,到这里我们的私有spec repo就创建好了。
    或者我们还可以使用pod repo list命令查看,
HJSpecs
 Type: git (master)
URL:  https://github.com/OldGhost366/HJSpecs.git
Path: /Users/j/.cocoapods/repos/HJSpecs
master
Type: git (master)
URL:  https://github.com/CocoaPods/Specs.git
Path: /Users/j/.cocoapods/repos/master

二、创建pods公共组件库

这一步最简单的办法就是直接创建一个文件夹然后里面创建一个.podspec结尾的文件,这样我们的公共组件库就创建成功了。

  • 1、在这里我使用的是pod命令来创建:pod lib create HJPodTestLib 这里会询问几个问题,最好都选NO
jdeMacBook-Pro:PodSpecRepo j$ pod lib create HJPodTestLib
Cloning `https://github.com/CocoaPods/pod-template.git` into `HJPodTestLib`.
Configuring HJPodTestLib 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?? [ Swift / ObjC ]
> ObjC
Would you like to include a demo application with your library? [ Yes / No ]
 > No
Which testing frameworks will you use? [ Specta / Kiwi / None ]
 > None
Would you like to do view based testing? [ Yes / No ]
 > No
What is your class prefix?
 > HJ
  • 2、在远程git服务器创建组件仓库,并且和本地关联
git add .
git commit -s -m "Initial Commit of Library"
git remote add origin https://github.com/OldGhost366/HJPodTestLib.git          
git push origin master     
  • 3、创建tag,因为podspec文件中获取Git版本控制的项目还需要tag号,所以我们要打上一个tag,这一步一定不要忘记 不然第5步就会说找不到版本。
git tag -m "第一版" 0.1.0
git push --tags
  • 4、编写podspec文件,
    我里面标注要修改的地方一定要修改下不要用默认的,不然第5不会出警告。
Pod::Spec.new do |s|
  s.name             = 'HJPodTestLib'
  s.version          = '0.1.0'
  s.summary          = 'HJPodTestLib.'  #这里要修改下

 s.description      = <<-DESC
 description of the pod here. #这里也要修改下
                       DESC

  s.homepage         = 'https://github.com/OldGhost366/HJPodTestLib'
  # s.screenshots     = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'OldGhost366' => 'oldghost007@163.com' }
  s.source           = { :git => 'https://github.com/OldGhost366/HJPodTestLib.git', :tag => s.version.to_s }
  # s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'

  s.ios.deployment_target = '8.0'

  s.source_files = 'HJPodTestLib/Classes/**/*'
end
  • 5、验证 pod lib lint,
    ERROR和WARMING都不能有,不然不能提交。
jdeMacBook-Pro:HJPodTestLib j$ pod lib lint
 -> HJPodTestLib (0.1.0)
HJPodTestLib passed validation.
  • 6、提交podspec到私有spec repo
    这个时候需要,必须前面验证通过,不然提交会失败,因为提交过程先会进行验证。
    执行下面命令后CocoasPod自动会将podspec到本地和远程spec repo Git仓库。我们这时候可以在Git远程仓库可以看到这个podspec文件了。
pod repo push HJSpecs HJPodTestLib.podspec

三、集成测试

  • 1、搜索私有库看是否存在
pod search HJPodTestLib
-> HJPodTestLib (0.1.0)
   HJPodTestLib.
   pod 'HJPodTestLib', '~> 0.1.0'
   - Homepage: https://github.com/OldGhost366/HJSpecs.git
   - Source:   https://github.com/OldGhost366/HJPodTestLib.git
   - Versions: 0.1.0 [HJSpecs repo]
(END)
  • 2、创建项目测试
pod init

然后我们编辑Podfile文件

target 'PodTest' do
platform :ios, '8.0'
pod 'HJPodTestLib', '~> 0.1.0'
pod 'AFNetworking'
end

执行pod install

[!] Unable to find a specification for `HJPodTestLib`

这个命令之后可能会产生上面的错误,如果你没遇到最好,因为这个可能和我的Xcode(8.1)和CocoaPods(1.2.1)版本有关。网上查了下好像和Xcode8有关,但是我按里面的解决办法没有解决,因为我输入下面命令后根本没有反应。

pod spec lint --sources='https://github.com/OldGhost366/HJSpecs.git,https://github.com/CocoaPods/Specs'

最终解决办法在Podfile里面增加source指定,两个都要添加

#增加下面两个source这样pod install就不会出问题了
source 'https://github.com/OldGhost366/HJSpecs.git'
source 'https://github.com/CocoaPods/Specs.git'
target 'PodTest' do
platform :ios, '8.0'
pod 'HJPodTestLib', '~> 0.1.0'
pod 'AFNetworking'
end

通过上面的步骤我们实现了一个我们自己的CocoaPods私有spec repo。这样我们就可以通过CocoaPods来管理我们的公共组件了。
我的另外一篇-创建subspec
参考:
http://blog.wtlucky.com/blog/2015/02/26/create-private-podspec/

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

推荐阅读更多精彩内容