CocoaPods建立私有倉庫
CocoaPods
是iOS下的第三方包管理工具呛哟,有些不想開源的陈瘦,或者復(fù)用的代碼墓拜,我們可以創(chuàng)建一個私有倉庫,通過CocoaPods來管理它們刘陶。
如何創(chuàng)建一個私有庫胳赌?
- 給模塊項(xiàng)目打一個tag
因?yàn)榕渲胮od信息的時候可以用tag指定版本號
打tag
git tag -m "New tag" '0.1'
把tag推到遠(yuǎn)程倉庫
git push --tags
- 拉取項(xiàng)目(私有倉)到pods管理目錄下
先在托管倉庫(github,Coding等)創(chuàng)建一個私有倉(一個文件夾)
這里我用的Coding托管的項(xiàng)目匙隔,至于為什么不用github(Coding私有庫是免費(fèi)的疑苫,墻內(nèi)環(huán)境下訪問速度超快,而且是中文的??)
pod repo add [私有項(xiàng)目名(repo庫)] [clone地址]
$ pod repo add NNASpec https://git.coding.net/Leben-NNA/NNASpec.git
拉取完項(xiàng)目纷责,會默認(rèn)存在~/.cocoapods/repos這個目錄下面捍掺,這里面有個master文件夾存的是緩存到本地的開源庫的pods的.podspec.json格式配置信息,跟master同級你就會發(fā)現(xiàn)NNASpec(拉取的repo倉)的文件夾
~/.cocoapods/repos 大致目錄結(jié)構(gòu)
├── repos
└── NNASpec
└── [VERSION]
└── [SPEC_NAME].podspec
- 到要上傳文件的項(xiàng)目里創(chuàng)建podspec配置文件
這里要先到項(xiàng)目里(最好是readme再膳,license文件同級)
創(chuàng)建podspec文件
$ pod spec create NNATree
podspec創(chuàng)建也可以使用一個叫CocoaPods的Xcode插件生成
創(chuàng)建好podspec文件以后挺勿,打開編輯會發(fā)現(xiàn)里面有很多參數(shù)需要配置,有很多注釋信息說明參數(shù)作用
這里就舉個栗子:(下面是我填寫的配置信息)
注意:復(fù)制的時候刪除后面的注釋信息
Pod::Spec.new do |s|
s.name = "NNATree" # 這里要跟上面創(chuàng)建的spec文件名一致
s.version = "0.1" # 這里使用之前的tag
s.summary = "Create a tree by tableview."
s.homepage = "https://git.coding.net/Leben-NNA/NNAMultilevelTree.git"
s.license = "MIT"
s.author = { "Leben NNA" => "leben.nna@gmail.com" }
s.platform = :ios, "7.0"
s.ios.deployment_target = "7.0"
s.source = { :git => "https://git.coding.net/Leben-NNA/NNAMultilevelTree.git", :tag => "0.1" } # 這里使用之前的tag
s.source_files = 'MultilevelTree/*.{h,m}'
s.framework = "UIKit"
s.requires_arc = true
# s.dependency "AFNetworking", "~> 2.2.4"
end
一些參數(shù)的注釋:
name: 導(dǎo)入pod后的目錄名
version: 當(dāng)前版本號
deployment_target: 配置的target
prefix_header_file: 預(yù)編譯頭文件路徑喂柒,將該文件的內(nèi)容插入到Pod的pch文件內(nèi)
source: 來源的具體路徑不瓶,是http鏈接還是本地路徑
requires_arc: 是否需要arc
source_files: 指定該目錄下包含哪些文件
其他可選參數(shù)還包括:
dependency: 指定依賴,如果依賴的庫不存在或者依賴庫的版本不符合要求將會報(bào)錯
libraries: 指定導(dǎo)入的庫胳喷,比如sqlite3
frameworks: 指定導(dǎo)入的framework
weak_frameworks: 弱鏈接湃番,比如說一個項(xiàng)目同時兼容iOS6和iOS7,但某一個framework只在iOS7上有吭露,這時候如果用強(qiáng)鏈接吠撮,那么在iOS7上運(yùn)行就會crash,使用weak_frameworks可以避免這種情況。
通配符說明:
a{bb,bc}def.{h,m}表示四個文件abbdef.h abbdef.m abcdef.h abcdef.m
*.{h,m,mm}表示所有的.h .m .mm文件
Class/**/*.{h,m}表示Class目錄下的所有.h .m文件
4. 測試下podspec配置文件是否有錯誤
$ pod lib lint // 驗(yàn)證是否有合格
$ pod spec lint // 這個也可以驗(yàn)證
- 提交代碼
# 提交代碼
git commit -a -m "PodTest 0.1"
# 將本地的master分支推送到遠(yuǎn)程倉庫
git push origin master
- 創(chuàng)建一個trunk賬號(用于上傳到公共庫Cocoapods)
$ sudo gem install cocoapods // 先更新下Cocoapods版本
$ pod trunk register 郵箱 '昵稱' --verbose // 填寫賬號信息泥兰,注冊完要去郵箱點(diǎn)一個驗(yàn)證郵件(郵箱最好和git的郵箱保持一致)
$ pod trunk me // 驗(yàn)證完成后可以查看賬號信息
- 提交podspec到私有庫
# pod repo push [repo倉名] [podspec文件名]
$ pod repo push NNASpec NNATree.podspec
完成之后這個私有庫就添加到我們的私有Spec Repo中弄屡,可以進(jìn)入到~/.cocoapods/repos目錄下查看
同時遠(yuǎn)端倉里也完成了推送
順便把提交到cocoapods(公共庫)的方法也提一句吧,前面的步驟都一樣只需要用到上一步注冊了的trunk提交就可以了
# 提交podspec文件到trunk
pod trunk push NNATree.podspec
- 使用庫
Podfile中填寫
source 'https://github.com/CocoaPods/Specs.git' // 公共庫
source 'https://git.coding.net/Leben-NNA/NNASpec.git' // 私有庫
platform :ios, '7.0'
pod 'NNATree/Tree', '0.1' // 使用某一個部分
pod 'NNATree', '0.1' // 使用整個庫
然后在終端輸入賬號密碼就可以引入私有庫了
值得注意的一點(diǎn):如果添加了私有庫就需要加入source鞋诗,默認(rèn)是不需要添加的膀捷,source是用于找到倉庫的,
source公共庫和私有庫的順序會影響查找順序,假如公共庫和私有庫都有名字為AAA的輪子削彬,如果公共庫寫在前面全庸,就先在公共庫中查找,如果找到了融痛,就不會在私有庫中找壶笼。
- 刪除一個私有庫
$ pod repo remove NNASpec
這樣就從本地刪除了
當(dāng)然我們還可以通過下面的代碼添加回來
$ pod repo add NNASpec git@coding.net:Leben-NNA/NNASpec.git
- 如果想刪除私有Spec Repo下的某一個podspec,此時只需要cd到
~/.cocoapods/repos/NNASpec
目錄下雁刷,刪掉庫目錄
$ rm -Rf NNATree
然后再將git的變動push到遠(yuǎn)端倉庫即可
git add --all .
git commit -m "remove unuseful pods"
git push origin master
備注:本文抄襲自項(xiàng)目模塊化處理之Cocoapods 私有庫管理覆劈,略有刪改。