需求:在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
//www.greatytc.com/p/4b63dfbd8be7
//www.greatytc.com/p/1e5927eeb341
http://blog.csdn.net/andanlan/article/details/50515434