上一篇文章整理了我用SVN創(chuàng)建私有庫的過程竿滨,本文將整理一下有關(guān)podSpec文件的相關(guān)知識(shí)佳恬。
podSpec中spec的全稱是“Specification”,說明書的意思于游。顧名思義毁葱,這是用來描述你這個(gè)私有pod的說明信息的。
podSpec是cocoapods的一種文件格式贰剥,有一套自己的語法倾剿,我們可以到cocoapods官網(wǎng)進(jìn)行詳細(xì)了解(https://guides.cocoapods.org/syntax/podspec.html)。
創(chuàng)建podSpec很簡(jiǎn)單蚌成,只要?jiǎng)?chuàng)建一個(gè)以.podSpec為后綴的文件即可前痘,或者直接拷貝別人的進(jìn)行修改也可以。
它的創(chuàng)建命令是:$pod spec create TestFile
podspec文件的常用配置字段介紹
Pod::Spec.new do|s|
框架名字:框架名字一定要寫對(duì)笑陈,pod search "框架名"就是搜的這個(gè)
s.name= "yoowei"
框架版本號(hào)
? s.version????? = "1.0.0"
框架簡(jiǎn)介
? s.summary????? = "yoowei框架"
框架的主頁
? s.homepage???? = "https://git.oschina.net/yoowei"
框架遵守的開源協(xié)議
? s.license????? = 'MIT'
框架的作者
s.author?????? = { "yoowei" => "yoowei@126.com" }
框架的資源路徑:路徑可以指向遠(yuǎn)端代碼庫,也可以指向本地項(xiàng)目葵袭,例如:
? ? ? ? ? ? ? ? ? ? ?1.指向遠(yuǎn)端代碼庫:?{ :git => "git@git.oschina.net:yoowei/yoowei.git", :tag => "1.0.0" }
? ? ? ? ? ? ? ? ? ? ?2.指向本地項(xiàng)目: ? ?{ :path => 'yoowei', }
? s.source?????? = { :git => "git@git.oschina.net:yoowei/yoowei.git", :tag => "1.0.0" }
框架被其他工程引入時(shí)涵妥,會(huì)導(dǎo)入yoowei目錄下的.h和.m文件
? s.source_files = 'yoowei/**/*.{h,m}'
框架被其他工程引入時(shí),會(huì)導(dǎo)入yoowei/resource目錄下的資源文件
s.resources=?{
????'yoowei'=>?['yoowei/resource/**/*.{storyboard,xcassets,xib,png']
??}
框架依賴的framework
? s.framework??? = 'CoreData'
框架依賴的其他第三方庫
s.dependency 'MagicalRecord', :git => 'https://github.com/iiiyu/MagicalRecord.git', :tag => 'sumiGridDiary2.1'
? s.dependency 'MBProgressHUD'
框架是否需要支持ARC
? s.requires_arc = true
框架支持的最低平臺(tái)版本
s.platform???? = :ios,?'7.0'
框架公開的頭文件
?s.public_header_files?=?'yoowei/**/*.h'
end
大型項(xiàng)目模塊化管理
隨著iOS APP越來越復(fù)雜,功能越來越多蓬网,對(duì)于iOS項(xiàng)目的工程化要求也越來越高了窒所,對(duì)于復(fù)雜的APP一般都需要對(duì)項(xiàng)目進(jìn)行模塊化管理。
模塊化有幾個(gè)方式:
1. 目錄結(jié)構(gòu)管理:這是最原始的方式帆锋,僅僅通過目錄結(jié)構(gòu)實(shí)現(xiàn)代碼層次的清晰化吵取。但本質(zhì)上并沒有解決代碼之間的依賴混亂的情況,模塊化劃分也非常不清晰锯厢。
2. 子工程:通過子工程可以實(shí)現(xiàn)代碼依賴管理和模塊化皮官,但是需要引入復(fù)雜的設(shè)置,不利于管理实辑。
3. 靜態(tài)庫:將依賴代碼打包成為靜態(tài)庫.a捺氢,不過由于不能看到源碼,調(diào)試不方便剪撬。
自從有了CocoaPods摄乒,可以使用它來管理私有庫,從而實(shí)現(xiàn)了代碼模塊化管理残黑。例如下圖所示:
CocoaPods私有庫
1. 創(chuàng)建私有的Specs git庫
例如在github上面創(chuàng)建一個(gè)空的git庫:https://github.com/xxx/MySpecs
將這個(gè)git庫加入到CocoaPods庫的列表中:
pod repo add MySpecs git@github.com:xxx/MySpecs.git
此時(shí)可以檢查下本地的pod repo
<br class="Apple-interchange-newline">$ pod repo list<br><br>MySpecs
- Type: git (master)- URL: git@github.com:xxx/MySpecs.git
- Path: /Users/xxx/.cocoapods/repos/mySpecs
master
- Type: git (master)
- URL:? git@github.com:CocoaPods/Specs.git
- Path: /Users/xxx/.cocoapods/repos/master
確定私有庫的Specs已經(jīng)加到本地pod repo中馍佑。?
2.在私有庫項(xiàng)目中創(chuàng)建podspec文件
在私有庫項(xiàng)目中的根目錄,創(chuàng)建對(duì)應(yīng)的podspec文件梨水,里面會(huì)描述這個(gè)庫的基本信息拭荤。
PodSpec規(guī)范可以查看:https://guides.cocoapods.org/syntax/podspec.html
Pod::Spec.newdo|s|
??s.name="PodName"
??s.version????? =?"0.0.1"
??s.summary????? =?"A short description of PodName."
??s.homepage???? =?"http://github.com/xxx/PodName"
??s.license????? = {?:type=>?"MIT",?:text=> <<-LICENSE
????Copyright ??2016年 xxx. All rights reserved.
????LICENSE
?????}
??s.author?????? = {?""=>?""}
??s.source?????? = {?:git=>?"git@github.com:xxx/PodName.git",?:tag=>?"0.0.1"}
??s.source_files =?"**/*.{h,m,mm,c}"
??s.frameworks?? =?"Foundation",?"QuartzCore",?"UIKit",?"WebKit"
??s.libraries??? =?"z"
??s.dependency?'AFNetworking'
??s.ios.deployment_target =?'6.0'
end
resource: 可以指定資源文件,建議使用bundle以避免資源文件產(chǎn)生沖突冰木。
frameworks: 指定這個(gè)pod依賴的系統(tǒng)framework
libraries: 指定這個(gè)pod依賴的系統(tǒng)動(dòng)態(tài)庫穷劈。注意使用的名字:比如需要引用"libz.dylib", 那么這里只需要寫"z"
無論原始項(xiàng)目的目錄結(jié)構(gòu)或者group結(jié)構(gòu),默認(rèn)的pod里面的代碼都會(huì)平鋪在根目錄里面
如果需要增加目錄層次結(jié)構(gòu)踊沸,則需要使用subspec歇终,詳細(xì)使用規(guī)范:https://guides.cocoapods.org/syntax/podspec.html#subspec
注意:SubSpecs之間不能存在相互依賴關(guān)系,只能單向依賴
3. 驗(yàn)證私有庫的合法性
pod lib lint --sources='git@github.com:xxx/MySpecs.git'--verbose --use-libraries --allow-warnings
sources參數(shù)可以指定私有庫的Pod Specs庫的地址逼龟。如果能夠通過评凝,說明代碼編譯沒有問題
4. 提交私有庫的版本信息
git tag -m?"first release""0.0.1"
$ git push --tags?????#推送tag到遠(yuǎn)端倉庫
5.向Spec Repo提交podspec
pod repo push MySpecs PodName.podspec --sources='git@github.com:xxx/MySpecs.git'--use-libraries --allow-warnings
這樣就完成了一個(gè)CocoaPods的私有庫的提交了,別人就可以在Podfile里面使用這個(gè)私有庫了腺律。