cocoapods官網:https://cocoapods.org
一、什麼是CocoaPods
每種語言發展到一個階段,就會出現相應的依賴管理工具,例如 Java 語言的 Maven,nodejs 的 npm。隨着 iOS 開發者的增多,業界也出現了爲 iOS 程序提供依賴管理的工具,它的名字叫做:CocoaPods。
CocoaPods項目的源碼 在 Github 上管理。該項目開始於 2011 年 8 月 12 日,經過多年發展,現在已經成爲 iOS 開發事實上的依賴管理標準工具。開發 iOS 項目不可避免地要使用第三方開源庫,CocoaPods 的出現使得我們可以節省設置和更新第三方開源庫的時間。
二、爲什麼要使用CocoaPods
在使用CocoaPods之前,開發項目需要用到第三方開源庫的時候,我們需要
1.把開源庫的源代碼複製到項目中
2.添加一些依賴框架和動態庫
3.設置-ObjC,-fno-objc-arc等參數
4.管理他們的更新
在使用CocoaPods後,我們只需要把用到的開源庫放到一個名爲Podfile的文件中,然後執行pod install就可以了,Cocoapods就會自動將這些第三方開源庫的源碼下載下來,並且爲我們的工程設置好響應的系統依賴和編譯參數。
三、CocoaPods的原理
CocoaPods的原理是將所有的依賴庫都放到另一個名爲Pods的項目中,然後讓主項目依賴Pods項目,這樣,源碼管理工作都從主項目移到了Pods項目中。Pods項目最終會編譯成一個名爲libPods.a的文件,主項目只需要依賴這個.a文件即可。
四、CocoaPods的安裝
CocoaPods可以方便地通過Mac自帶的RubyGems安裝。
打開Terminal(Mac電腦自帶的終端),然後按照以下提示操作即可:
1.設置ruby的軟件源
這是因爲ruby的軟件源rubygems.org因爲使用亞馬遜的雲服務,被我天朝屏蔽了,需要更新一下ruby的源,過程如下:
gem sources -l #(查看當前ruby的源)
gem sources –remove https://rubygems.org/ #(移除當前ruby的源)
gem sources -a https://ruby.taobao.org/ #(設置當前ruby的源爲我天朝的)
gem sources -l #(再次查看當前ruby的源)
如果Terminal輸出:
* CURRENT SOURCES *
就證明ruby的軟件源已經設置OK了。
2.設置gem爲最新版本
如果gem太老,可以嘗試用如下命令升級gem:
在Terminal輸入以下命令:
sudo gem update –system
升級成功後會提示: Latest version currently installed. Aborting.
3.執行安裝CocoaPods命令
注意:OS X 10.11 升級,雖然官方聲稱只是一個小的升級,但對於開發者而言,cocoapods需要重新安裝,但按照以前的安裝方式,在Terminal輸入以下命令:
sudo gem install cocoapods
如果報以下錯誤:
ERROR: While executing gem … (Errno::EPERM)
Operation not permitted - /usr/bin/xcodeproj
解決方案1:
執行下面的命令並重啓
sudo nvram boot-args=”rootless=0”
sudo reboot
重啓之後, 執行這個命令檢查
sudo gem install cocoapods -V
如果依舊有錯誤,使用第二個方案
解決方案2:
sudo gem install -n /usr/local/bin cocoapods
pod setup
還有一點需要注意,pod setup在執行時,會輸出Setting up CocoaPods master repo,但是會等待比較久的時間。這步其實是 Cocoapods 在將它的信息下載到 ~/.cocoapods目錄下,如果你等太久,可以試着 cd 到那個目錄,用du -sh *來查看下載進度。
安裝成功後,你會看到:Setup completed
五、Cocoapods的使用
隨便以一種方式新建一個名爲Podfile的文件放到你的工程根目錄下(不能寫成別的名字,也可以自己在工程根目錄裏面直接新建)
Podfile文件內容的格式應該如下:
platform :ios, ‘8.0’ #(註明你的開發平臺以及版本,’8.0’忽略不寫即爲最新版本)
pod ‘AFNetworking’, ‘~> 2.5.3’ #(‘~> 2.5.3’爲版本號,忽略不寫即爲最新版本)
pod ‘SDWebImage’, ‘~> 3.7.2’
然後在Terminal進入工程所在的根目錄(工程根目錄)中執行 :
pod install
這樣,AFNetworking和SDWebImage就已經下載完成並且設置好了編譯參數和依賴,以後使用的時候切記如下兩點:
1.從此以後需要使用Cocoapods生成的 .xcworkspace文件來打開工程,而不是使用以前的.xcodeproj文件
2.每次更改了Podfile文件,都需要重新執行一次pod update命令
查找第三方庫:
你如果不知道 cocoaPods 管理的庫中,是否有你想要的庫,那麼你可以通過 pod search 命令進行查找,以下是我用 pod search json 查找到的所有可用的庫:
可以在Terminal中輸入:
pod search AFNetworking
回車之後就可以看到和你搜索的關鍵字相關的一些庫類,如圖:
關於 Podfile.lock
當你執行pod install之後,除了 Podfile 外,CocoaPods 還會生成一個名爲Podfile.lock的文件,Podfile.lock 應該加入到版本控制裏面,不應該把這個文件加入到.gitignore中。因爲Podfile.lock會鎖定當前各依賴庫的版本,之後如果多次執行pod install 不會更改版本,要pod update纔會改Podfile.lock了。這樣多人協作的時候,可以防止第三方庫升級時造成大家各自的第三方庫版本不一致
附:如何使用CocoaPods的鏡像索引:
所有項目的Podspec文件都託管在https://github.com/CocoaPods/Specs,
第一次執行pod setup時,CocoaPods會將這些podspec索引文件更新到本地的~/.cocoapods目錄下,
這個索引文件比較大,所以第一次更新時非常慢.
友好人士在國內的服務器建立了Cocoapods索引庫的鏡像,
所以執行索引跟新操作時候會快很多.具體操作方法如下:
pod repo remove master
pod repo add master https://gitcafe.com/akuandev/Specs.git
pod repo update
這是使用gitcafe上的鏡像,將以上代碼中的 https://gitcafe.com/akuandev/Specs.git
替換成 http://git.oschina.net/akuandev/Specs.git 即可使用oschina上的鏡像。