在Gitlab上搭建了一个cocoapods私有库

需求:在Gitlab上搭建了一个cocoapods私有库,希望通过这个工具来管理自己公司或个人封装的的SDK、framework和第三方依赖。

一、pod使用方法(目前包含:TestQRCodeSDK(v1.0),TestAnalyticsSDK(v1.0),TestNetKit (v1.0),TestUIKit (1.0), TestCategory(1.0.4)):

//CocoaPods master地址 source 'https://github.com/CocoaPods/Specs.git' //自己创建的私有库地址 source 'http://masuyanGitlab.com/mobile_iOS/TestRpecsRepo.git' target 'targetName' do pod 'TestQRCodeSDK', '~> 1.0' pod 'TestAnalyticsSDK', '~> 1.0' pod 'TestNetKit', '~> 1.0' pod 'TestUIKit', '~> 1.0' pod 'TestCategory', '~> 1.0.0' end

二、Cocoapods创建私有仓库

整体先说明一下创建一个私有的podspec包括如下那么几个步骤:
1.创建并设置一个私有的Spec Repo。
2.创建Pod的所需要的项目工程文件,并且有可访问的项目版本控制地址。
3.创建Pod所对应的podspec文件。
4.本地测试配置好的podspec文件是否可用。
5.向私有的Spec Repo中提交podspec。
6.在个人项目中的Podfile中增加刚刚制作的好的Pod并使用。
更新维护podspec。

1、创建私有Spec Repo(已经创建了,就不需要创建,仅供了解)

为什么需要创建Spec Repo?

官方的Spec Repo:Spec Repo是所有的Pods的一个索引,就是一个容器,所有公开的Pods都在这个里面,它实际是一个Git仓库remote端在GitHub上,但是当你使用了Cocoapods后它会被clone到本地的~/.cocoapods/repos目录下,可以进入到这个目录看到master文件夹就是这个官方的Spec Repo了。
因此我们需要创建一个类似于master的私有Spec Repo,如果已经创建过了,就可以直接向里面添加组件,不要重复创建。

创建Spec Repo步骤:

1.在远端Git仓库创建Repo项目;
2.添加到本地~/.cocoapods/repos中,在本地终端执行:
$ cd /Users/masuyan/.cocoapods/repos $ pod repo add [Private Repo Name] [GitHub HTTPS clone URL]

2、创建Pod工具库项目工程

如果是有现有的组件项目,并且在Git的版本管理下,那么这一步就算完成了,可以直接进行下一步了。 新组件可以按以下操作:
新建pod项目:
$ pod lib create [podLibraryName] Configuring podLibraryName 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](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 ] None Would you like to do view based testing? [ Yes / No ] No What is your class prefix? Test

3、创建、修改podspec文件

pod命令生成的项目下有个podLibraryName.podspec配置文件,大致内容如下:
s.name = 'TestQRCodeSDK' //名称 s.version = '1.0' //版本号,对应组件项目的tag s.summary = '二维码扫描sdk’ //简短介绍,下面是详细介绍 s.homepage = 'http://masuyanGitlab.com/mobile_iOS/TestQRCodeSDK' //主页,这里要填写可以访问到的地址,不然验证不通过 s.source = { :git => 'http://masuyanGitlab.com/mobile_iOS/TestQRCodeSDK.git', :tag => s.version.to_s } //项目地址,对应的组件项目的tag,这里不支持ssh的地址,验证不通过,只支持HTTP和HTTPS,最好使用HTTPS s.ios.deployment_target = '8.0' //支持的平台及版本 s.source_files = 'TestQRCodeSDK/Classes/**/*' //代码源文件地址,**/*表示Classes目录及其子目录下所有文件,如果有多个目录下则用逗号分开,如果需要在项目中分组显示,这里也要做相应的设置 s.resource_bundles = {'TestQRCodeSDK' => ['TestQRCodeSDK/Assets/*']} //资源文件地址 s.public_header_files = 'Pod/Classes/**/*.h' //公开头文件地址 s.frameworks = 'AssetsLibrary', 'CoreGraphics' //所需的framework,多个用逗号隔开 s.dependency 'AFNetworking', '~> 2.3' //依赖关系,该项目所依赖的其他库,如果有多个需要填写多个s.dependency 上传至Git仓库,并打上tag(代码和podspec文件修改完成后): $ git add .$ git commit -m '提交到本地分支'//关联远程仓库$ git remote add origin [远程仓库url]//提交代码到远程仓库$ git pull origin master$ git push origin master//打tag$ git tag -m "first release" "1.0"$ git push --tags

4、验证podspec文件

首先验证代码是否能正确引用,进入Example文件夹,$ pod install,然后在代码中引用相关头文件进行编译,没问题后进行下一步。
验证podspec,在podspec同目录下执行以下代码:
$ pod lib lint
出现任何WARNING或者ERROR都会不通过,但如果是WARNING或NOTE可以设置忽略:
$ pod lib lint --allow-warnings

5、上传到私有库Private Repo

注意:此处的Private Repo Name为mobile_ios-testRpecsrepo

$ pod repo push [Private Repo Name] [podLibraryName.podspec]
出现WARNING或NOTE导致的验证失败,可以设置忽略:
$ pod repo push [Private Repo Name] [podLibraryName.podspec] --allow-warnings
验证:$ pod search [podLibraryName]

6、个人项目中的Podfile配置

添加source源,即私有库Private Repo的Git地址,例如:
source '[http://masuyanGitlab.com/mobile_iOS/TestRpecsRepo.git](http://masuyanGitlab.com/mobile_iOS/TestRpecsRepo.git)' target 'test' do pod 'TestQRCodeSDK' end

7、更新维护podspec

在更新组件项目代码后,重新PUSH到远端并打上相应的Tag,编辑podsepc-->验证podsepc—>上传到私有库,对应3、4、5操作。
相关资料和问题解答:
http://www.cocoachina.com/ios/20150228/11206.html
http://www.jianshu.com/p/4b63dfbd8be7
http://www.jianshu.com/p/1e5927eeb341
http://blog.csdn.net/andanlan/article/details/50515434

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

推荐阅读更多精彩内容