最新Mac OS X 10.12.1 安裝cocoapods及使用詳解，10.12.1cocoapods

最新Mac OS X 10.12.1 安裝cocoapods及使用詳解，10.12.1cocoapods

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 ***

https://ruby.taobao.org/

就證明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上的鏡像。