整理自:
CocoaPods詳解之----進階篇
一购笆、Podfile.lock文件
在開始使用CocoaPods,執(zhí)行完pod install
之后,會生成一個Podfile.lock
文件悟衩。這個文件看起來跟我們關系不大规个,實際上絕對不應該忽略它。
該文件用于保存已經安裝的Pods依賴庫的版本枚冗,通過CocoaPods安裝了SBJson、AFNetworking、Reachability
三個Pods依賴庫以后對應的Podfile.lock
文件內容為:
PODS:
- AFNetworking (2.1.0):
- AFNetworking/NSURLConnection
- AFNetworking/NSURLSession
- AFNetworking/Reachability
- AFNetworking/Security
- AFNetworking/Serialization
- AFNetworking/UIKit
- AFNetworking/NSURLConnection (2.1.0):
- AFNetworking/Reachability
- AFNetworking/Security
- AFNetworking/Serialization
- AFNetworking/NSURLSession (2.1.0):
- AFNetworking/NSURLConnection
- AFNetworking/Reachability (2.1.0)
- AFNetworking/Security (2.1.0)
- AFNetworking/Serialization (2.1.0)
- AFNetworking/UIKit (2.1.0):
- AFNetworking/NSURLConnection
- Reachability (3.0.0)
- SBJson (4.0.0)
DEPENDENCIES:
- AFNetworking (~> 2.0)
- Reachability (~> 3.0.0)
- SBJson (~> 4.0.0)
SPEC CHECKSUMS:
AFNetworking: c7d7901a83f631414c7eda1737261f696101a5cd
Reachability: 500bd76bf6cd8ff2c6fb715fc5f44ef6e4c024f2
SBJson: f3c686806e8e36ab89e020189ac582ba26ec4220
COCOAPODS: 0.29.0
Podfile.lock文件最大得用處在于多人開發(fā)居灯。對于沒有在Podfile中指定Pods依賴庫版本的寫法其屏,如下:
pod 'SBJson'
該句話用于獲取當前SBJson這個Pods依賴庫的最新版本川背。
當團隊中的某個人執(zhí)行完pod install
命令后膨更,生成的Podfile.lock
文件就記錄下了當時最新Pods依賴庫的版本练般,這時團隊中的其它人check
下來這份包含Podfile.lock
文件的工程以后,再去執(zhí)行pod install
命令時,獲取下來的Pods依賴庫的版本就和最開始用戶獲取到的版本一致迫悠。
如果沒有Podfile.lock
文件,后續(xù)所有用戶執(zhí)行pod install命令都會獲取最新版本的SBJson,這就有可能造成同一個團隊使用的依賴庫版本不一致感混,這對團隊協(xié)作來說絕對是個災難婆跑!
在這種情況下,如果團隊想使用當前最新版本的SBJson依賴庫庭呜,有兩種方案:
更改Podfile滑进,使其指向最新版本的SBJson依賴庫犀忱;
執(zhí)行
pod update
命令;
鑒于Podfile.lock
文件對團隊協(xié)作如此重要扶关,我們需要將它添加到版本管理中阴汇。
二、Podfile文件
對于普通用戶來說节槐,使用CocoaPods我們打交道最多的就是Podfile
文件搀庶。CocoaPods是用ruby實現的,因此Podfile文件的語法就是ruby的語法铜异。接著從以下幾個方面來介紹Podfile
:
1哥倔、Podfile
文件存放位置
通常情況下我們都推薦Podfile
文件都放在工程根目錄,如下圖所示:
事實上Podfile
文件可以放在任意一個目錄下熙掺,需要做的是在Podfile
中指定工程的路徑,和原來相比咕宿,Podfile
文件就在最開始的位置增加了一行币绩,具體內容如下:
xcodeproj "/Users/wangzz/Desktop/CocoaPodsTest/CocoaPodsTest.xcodeproj"
platform :ios
pod 'Reachability', '~> 3.0.0'
pod 'SBJson', '~> 4.0.0'
platform :ios, '7.0'
pod 'AFNetworking', '~> 2.0'
指定路徑使用的是xcodeproj
關鍵字。
此后府阀,進入Podfile
文件所在路徑缆镣,執(zhí)行pod install
命令就會和之前一樣下載這些Pods依賴庫,而且生成的相關文件都放在了Podfile所在目錄下面
试浙,如下圖:
和之前一樣董瞻,我們仍然需要使用這里生成的workspace文件打開工程。
2田巴、Podfile和target
Podfile
本質上是用來描述Xcode工程中的targets
用的钠糊。如果我們不顯式指定Podfile
對應的target,CocoaPods會創(chuàng)建一個名稱為default的隱式target壹哺,會和我們工程中的第一個target相對應抄伍。換句話說,如果在Podfile中沒有指定target管宵,那么只有工程里的第一個target能夠使用Podfile中描述的Pods依賴庫
截珍。
如果想在一個Podfile
中同時描述project
中的多個target
,根據需求的不同箩朴,可以有不同的實現方式岗喉。為了說明問題,在原來的工程中再創(chuàng)建一個名稱為Second的target炸庞,現在的project中包含的target有:
I 多個target中使用相同的Pods依賴庫
比如钱床,名稱為CocoaPodsTest
的target和Second
的target都需要使用Reachability
、SBJson
埠居、AFNetworking
三個Pods依賴庫诞丽,可以使用link_with
關鍵字來實現鲸拥,將Podfile
寫成如下方式:
link_with 'CocoaPodsTest', 'Second'
platform :ios
pod 'Reachability', '~> 3.0.0'
pod 'SBJson', '~> 4.0.0'
platform :ios, '7.0'
pod 'AFNetworking', '~> 2.0'
這種寫法就實現了CocoaPodsTest和Second兩個target共用相同的Pods依賴庫。
II 不同的target使用完全不同的Pods依賴庫
CocoaPodsTest
這個target使用的是Reachability
僧免、SBJson
刑赶、AFNetworking
三個依賴庫,但Second
這個target只需要使用OpenUDID
這一個依賴庫懂衩,這時可以使用target
關鍵字撞叨,Podfile
的描述方式如下:
target :'CocoaPodsTest' do
platform :ios
pod 'Reachability', '~> 3.0.0'
pod 'SBJson', '~> 4.0.0'
platform :ios, '7.0'
pod 'AFNetworking', '~> 2.0'
end
target :'Second' do
pod 'OpenUDID', '~> 1.0.0'
end
其中,do/end
作為開始和結束標識符浊洞。
3牵敷、使用Podfile管理Pods依賴庫版本
再引入依賴庫時,需要顯示或隱式注明引用的依賴庫版本法希,具體寫法和表示含義如下:
pod 'AFNetworking' //不顯式指定依賴庫版本枷餐,表示每次都獲取最新版本
pod 'AFNetworking', '2.0' //只使用2.0版本
pod 'AFNetworking', '> 2.0' //使用高于2.0的版本
pod 'AFNetworking', '>= 2.0' //使用大于或等于2.0的版本
pod 'AFNetworking', '< 2.0' //使用小于2.0的版本
pod 'AFNetworking', '<= 2.0' //使用小于或等于2.0的版本
pod 'AFNetworking', '~> 0.1.2' //使用大于等于0.1.2但小于0.2的版本
pod 'AFNetworking', '~>0.1' //使用大于等于0.1但小于1.0的版本
pod 'AFNetworking', '~>0' //高于0的版本,寫這個限制和什么都不寫是一個效果苫亦,都表示使用最新版本
三毛肋、CocoaPods常用命令
1、pod install
根據Podfile
文件指定的內容屋剑,安裝依賴庫润匙,如果有Podfile.lock
文件而且對應的Podfile
文件未被修改,則會根據Podfile.lock
文件指定的版本安裝唉匾。
每次更新了Podfile
文件時孕讳,都需要重新執(zhí)行該命令,以便重新安裝Pods依賴庫巍膘。
2厂财、pod update
若果Podfile
中指定的依賴庫版本不是寫死的,當對應的依賴庫有了更新峡懈,無論有沒有Podfile.lock
文件都會去獲取Podfile
文件描述的允許獲取到的最新依賴庫版本蟀苛。
3、pod search
命令格式為:
$ pod search OpenUDID
后面的OpenUDID為參數逮诲。
從命令的名稱不難看出帜平,該命令是用來按名稱搜索可用的Pods依賴庫,執(zhí)行結果如下:
-> OpenUDID (1.0.0)
Open source initiative for a universal and persistent UDID solution for iOS.
pod 'OpenUDID', '~> 1.0.0'
- Homepage: http://OpenUDID.org
- Source: https://github.com/ylechelle/OpenUDID.git
- Versions: 1.0.0 [master repo]
這里我們搜到了一條可用數據梅鹦,里面描述了OpenUDID庫的簡要信息裆甩。其實我們真正需要的是上述結果中的第三行:
pod 'OpenUDID', '~> 1.0.0'
不難看出,這是我們需要添加到Podfile文件中的齐唆。
有了這條命令嗤栓,就可以方便、迅速地找到需要的Pods依賴庫。
4茉帅、pod setup
命令格式為:
$ pod setup
執(zhí)行完了以后會打舆缎稹:
Setting up CocoaPods master repo
Updating 7cd4668..f3d3ced
Fast-forward
接下來還會打印很多更新信息。
這條命令用于跟新本地電腦上的保存的Pods依賴庫tree堪澎。由于每天有很多人會創(chuàng)建或者更新Pods依賴庫擂错,這條命令執(zhí)行的時候會相當慢,還請耐心等待樱蛤。我們需要經常執(zhí)行這條命令钮呀,否則有新的Pods依賴庫的時候執(zhí)行pod search
命令是搜不出來的。