IOS-CocoaPods進階篇

1、Podfile.lock文件

上文講過，在開始使用CocoaPods，執行完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文件最大得用處在於多人開發。對於沒有在Podfile中指定Pods依賴庫版本的寫法，以下：

pod 'SBJson'

該句話用於獲取當前SBJson這個Pods依賴庫的最新版本。
當團隊中的某我的執行完pod install命令後，生成的Podfile.lock文件就記錄下了當時最新Pods依賴庫的版本，這時團隊中的其它人check下來這份包含Podfile.lock文件的工程之後，再去執行pod install命令時，獲取下來的Pods依賴庫的版本就和最開始用戶獲取到的版本一致。若是沒有Podfile.lock文件，後續全部用戶執行pod install命令都會獲取最新版本的SBJson，這就有可能形成同一個團隊使用的依賴庫版本不一致，這對團隊協做來講絕對是個災難！

在這種狀況下，若是團隊想使用當前最新版本的SBJson依賴庫，有兩種方案：

• 更改Podfile，使其指向最新版本的SBJson依賴庫；
• 執行pod update命令；

鑑於Podfile.lock文件對團隊協做如此重要，咱們須要將它添加到版本管理中。

 

2、Podfile文件

對於普通用戶來講，使用CocoaPods咱們打交道最多的就是Podfile文件。CocoaPods是用ruby實現的，所以Podfile文件的語法就是ruby的語法。接着從如下幾個方面來介紹Podfile:

一、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文件所在路徑，執行pod install命令就會和以前同樣下載這些Pods依賴庫，並且生成的相關文件都放在了Podfile所在目錄下面，以下圖：

和以前同樣，咱們仍然須要使用這裏生成的workspace文件打開工程。

 

二、Podfile和target

Podfile本質上是用來描述Xcode工程中的targets用的。若是咱們不顯式指定Podfile對應的target，CocoaPods會建立一個名稱爲default的隱式target，會和咱們工程中的第一個target相對應。換句話說，若是在Podfile中沒有指定target，那麼只有工程裏的第一個target可以使用Podfile中描述的Pods依賴庫。

若是想在一個Podfile中同時描述project中的多個target，根據需求的不一樣，能夠有不一樣的實現方式。爲了說明問題，在原來的工程中再建立一個名稱爲Second的target，如今的project中包含的target有：

①多個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依賴庫。

②不一樣的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做爲開始和結束標識符。

三、使用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的版本，寫這個限制和什麼都不寫是一個效果，都表示使用最新版本

3、CocoaPods經常使用命令

一、pod install

根據Podfile文件指定的內容，安裝依賴庫，若是有Podfile.lock文件並且對應的Podfile文件未被修改，則會根據Podfile.lock文件指定的版本安裝。

每次更新了Podfile文件時，都須要從新執行該命令，以便從新安裝Pods依賴庫。

二、pod update

若果Podfile中指定的依賴庫版本不是寫死的，當對應的依賴庫有了更新，不管有沒有Podfile.lock文件都會去獲取Podfile文件描述的容許獲取到的最新依賴庫版本。

三、pod search

命令格式爲：

$ pod search OpenUDID

後面的OpenUDID爲參數。

從命令的名稱不難看出，該命令是用來按名稱搜索可用的Pods依賴庫，執行結果以下：

-> 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依賴庫。

四、pod setup

命令格式爲：

$ pod setup

執行完了之後會打印：

Setting up CocoaPods master repo
Updating 7cd4668..f3d3ced

Fast-forward

接下來還會打印不少更新信息。

這條命令用於跟新本地電腦上的保存的Pods依賴庫tree。因爲天天有不少人會建立或者更新Pods依賴庫，這條命令執行的時候會至關慢，還請耐心等待。咱們須要常常執行這條命令，不然有新的Pods依賴庫的時候執行pod search命令是搜不出來的。

4、參考文檔

http://guides.cocoapods.org/using/index.html