CocoaPods安裝和使用教程

Code4App 原創文章。轉載請註明出處：http://code4app.com/article/cocoapods-install-usage

文件夾

• CocoaPods是什麼？
• 怎樣下載和安裝CocoaPods？
• 怎樣使用CocoaPods？
  • 場景1：利用CocoaPods。在項目中導入AFNetworking類庫
  • 場景2：怎樣正確編譯執行一個包括CocoPods類庫的項目

CocoaPods是什麼？

當你開發iOS應用時，會經常使用到很是多第三方開源類庫，比方JSONKit，AFNetWorking等等。

可能某個類庫又用到其它類庫，因此要使用它。必須得另外下載其它類庫。而其它類庫又用到其它類庫，「子子孫孫無窮盡也」，這或許是比較特殊的狀況。

總之小編的意思就是，手動一個個去下載所需類庫十分麻煩。第二種常見狀況是，你項目中用到的類庫有更新，你必須得又一次下載新版本號，又一次增長到項目中。十分麻煩。假設能有什麼工具能解決這些惱人的問題，那將「善莫大焉」。

因此。你需要 CocoaPods。

CocoaPods應該是iOS最常用最有名的類庫管理工具了。上述兩個煩人的問題，經過cocoaPods。僅僅需要一行命令就可以全然解決，固然前提是你必須正確設置它。

重要的是，絕大部分有名的開源類庫，都支持CocoaPods。因此，做爲iOS程序猿的咱們。掌握CocoaPods的使用是不可缺乏的基本技能了。

怎樣下載和安裝CocoaPods？

在安裝CocoaPods以前，首先要在本地安裝好Ruby環境。

至於怎樣在Mac中安裝好Ruby環境，請google一下，本文再也不涉及。

假如你在本地已經安裝好Ruby環境，那麼下載和安裝CocoaPods將十分簡單，僅僅需要一行命令。

在Terminator（也就是終端）中輸入下面命令（注意，本文所有命令都是在終端中輸入並執行的。

什麼。你不知道什麼是終端？那請小編吃飯。小編告訴你）：

sudo gem install cocoapods

但是，且慢。假設你在天朝，在終端中敲入這個命令以後，會發現半天沒有不論什麼反應。

緣由無他，因爲那堵牆阻擋了cocoapods.org。（你會問，我靠，這都要牆！

是的，小編也納悶。）

但是，是的。又但是（只是是個可喜的「但是」）。

咱們可以用淘寶的Ruby鏡像來訪問cocoapods。依照如下的順序在終端中敲入依次敲入命令：

$ gem sources --remove https://rubygems.org/
//等有反應以後再敲入下面命令
$ gem sources -a http://ruby.taobao.org/

爲了驗證你的Ruby鏡像是並且僅是taobao，可以用下面命令查看：

$ gem sources -l

僅僅有在終端中出現如下文字才代表你上面的命令是成功的：

*** CURRENT SOURCES ***

http://ruby.taobao.org/

上面所有的命令完畢之時，在小編的終端上是這個的樣子：

這時候，你再次在終端中執行：

$ sudo gem install cocoapods

等上十幾秒鐘，CocoaPods就可以在你本地下載並且安裝好了。再也不需要其它設置。

敲入以上命令時。小編終端上是這個樣子的（由於太長，僅截取前面一部分）：

看到這裏，你內心會不會說，我靠！

太爽了。這麼easy就可以下載並且安裝好了！是的。小編也是這麼想的。

CocoPods就是這麼簡單。使用也十分簡單。繼續往下看吧。

怎樣使用CocoaPods？

好了，安裝好CocoPods以後。接下來就是使用它。所幸，使用CocoPods和安裝它同樣簡單，也是經過一兩行命令就可以搞定。

小編在這裏用兩種使用場景來詳細說明怎樣使用CocoaPods。

場景1：利用CocoaPods，在項目中導入AFNetworking類庫

AFNetworking類庫在GitHub地址是：https://github.com/AFNetworking/AFNetworking

爲了肯定AFNetworking是否支持CocoaPods，可以用CocoaPods的搜索功能驗證一下。在終端中輸入：

$ pod search AFNetworking

過幾秒鐘以後。你會在終端中看到關於AFNetworking類庫的一些信息。比方：

這說明，AFNetworking是支持CocoaPods。因此咱們可以利用CocoaPods將AFNetworking導入你的項目中。

首先，咱們需要在咱們的項目中增長CocoaPods的支持。

你可以尾隨小編的步驟，先利用Xcode建立一個名字CocoaPodsDemo的項目，用於下面的教程。

建立好以後，在繼續下一步以前，小編先截圖，看看項目沒有支持CocoaPods時的項目Xcode文件夾結構：

上圖等一下要跟項目支持CocoaPods以後的項目Xcode文件夾結構作對照。

你看到這裏或許會問，CocoaPods爲何能下載AFNetworking呢，而不是下載其它類庫呢？這個問題的答案是，有個文件來控制CocoaPods該下載什麼。這個文件就叫作「Podfile」（注意，必定得是這個文件名稱，而且沒有後綴）。

你建立一個Podfile文件。而後在裏面加入你需要下載的類庫，也就是告訴CocoaPods。「某某和某某和某某某，快到碗裏來。」。每個項目僅僅需要一個Podfile文件。

好吧，廢話少說。咱們先建立這個奇妙的PodFile。在終端中進入（cd命令）你項目所在文件夾，而後在當前文件夾下，利用vim建立Podfile。執行：

$ vim Podfile

而後在Podfile文件裏輸入下面文字：

platform :ios, '7.0'
pod "AFNetworking", "~> 2.0"

注意。這段文字不是小編憑空生成的。可以在AFNetworking的github頁面找到。這兩句文字的意思是。當前AFNetworking支持的iOS最高版本號是iOS 7.0, 要下載的AFNetworking版本號是2.0。

而後保存退出。

vim環境下。保存退出命令是：

:wq

這時候。你會發現你的項目文件夾中，出現一個名字爲Podfile的文件。而且文件內容就是你剛剛輸入的內容。注意，Podfile文件應該和你的project文件.xcodeproj在同一個文件夾下。

這時候，你就可以利用CocoPods下載AFNetworking類庫了。

仍是在終端中的當前項目文件夾下，執行下面命令：

$ pod install

因爲是在你的項目中導入AFNetworking，這就是爲何這個命令需要你進入你的項目所在文件夾中執行。

執行上述命令以後，小編的終端出現下面信息：

EricmatoMacBook-Pro:CocoaPodsDemo ericwang$ pod install
Analyzing dependencies
Downloading dependencies
Installing AFNetworking (2.0.2)
Generating Pods project
Integrating client project

[!] From now on use `CocoaPodsDemo.xcworkspace`.

注意最後一句話，意思是：之後打開項目就用 CocoaPodsDemo.xcworkspace 打開，而不是以前的.xcodeproj文件。

你或許會鬱悶，爲何會出現.xcodeproj文件呢。這正是你剛剛執行$ pod install命令產生的新文件。

除了這個文件，你會發現還多了另一個文件「Podfile.lock」和一個文件夾「Pods」。 點擊 CocoaPodsDemo.xcworkspace 打開以後project以後。項目Xcode文件夾結構例如如下圖：

你會驚喜地發現。AFNetwoking已經成功導入項目了（紅框部分）！

現在。你就可以開始使用AFNetworking.h啦。

可以略微測試一下，在你的項目隨意代碼文件裏輸入：

#import <AFNetworking.h>
或者
#import "AFNetworking.h"

而後編譯，看看是否出錯。

假設你嚴格依照小編上述的步驟來。是不可能出錯的啦。

至此，CocoPods的第一個應用場景講述完成。別看小編寫了這麼多，事實上過程是十分簡單的。

總結一下就是：

1. 先在項目中建立Podfile，Podfile的內容是你想導入的類庫。

   通常類庫的原做者會告訴你導入該類庫應該怎樣寫Podfile。

2. 執行命令：`$ pod install.

如下，小編繼續講述另一種使用場景。

場景2：怎樣正確編譯執行一個包括CocoPods類庫的項目

你或許之前遇到過（特別是新手iOS開發人員）這樣的狀況，好不easy在GitHub上找到一份代碼符合本身想需求，興沖沖下載下來，一編譯。傻眼了，發現有各類各樣錯誤。

一看，原來是缺失了各類其它第三方類庫。這時候莫慌，你再細緻一看，會發現你下載的代碼包括了Podfile。

沒錯。這意味着你可以用CocoaPods很是方便下載所需要的類庫。

如下，小編以代碼 UAAppReviewManager 爲例來講明怎樣正確編譯執行一個包括CocoPods類庫的項目。

UAAppReviewManager是一個可讓你方便地將提醒用戶評分的功能增長你的應用中。當你去UAAppReviewManager的GitHub地址下載這份代碼以後，打開Exampleproject（UAAppReviewManagerExample），編譯，你會發現Xcode報告一大堆錯誤，基本都是說你編譯的這份代碼找不到某某頭文件，這就意味着你要成功編譯UAAppReviewManager的Example代碼。必須先導入一些第三方類庫。同一時候你會發現在UAAppReviewManagerExample目錄如下有三個跟CocosPods相關的文件（目錄）：Podfile。Podfile.lock和Pods，例如如下圖：

用

這時候，打開終端，進入UAAppReviewManagerExample所在的文件夾，也就是和Podfile在同一文件夾下，和場景1同樣。輸入下面命令（由於已經有Podfile，因此不需要再建立Podfile）：

$ pod update

過幾秒（或許需要十幾秒。取決於你的網絡情況）以後，終端出現：

Analyzing dependencies
Fetching podspec for `UAAppReviewManager` from `../`
Downloading dependencies
Installing UAAppReviewManager (0.1.6)
Generating Pods project
Integrating client project

[!] From now on use `UAAppReviewManagerExample.xcworkspace`.

這時候。再回到UAAppReviewManagerExample目錄看一看。會看到多了一個文件UAAppReviewManagerExample.xcworkspace：

依據終端的信息提示，你之後就需用新產生的UAAppReviewManagerExample.xcworkspace來執行這個Example代碼了。

打開UAAppReviewManagerExample.xcworkspace，編譯執行，成功！

例如如下圖：

注意，這裏有個小問題。假設剛剛你不是輸入$ pod update，而是輸入$ pod install，會發現類庫導入不成功，並且終端出現如下提示：

[!] Required version (UAAppReviewManager (from `../`)) not found for `UAAppReviewManager`.
Available versions: 0.1.6

這裏的意思大概是Podfile文件過時，類庫有升級，但是Podfile沒有更改。$ pod install僅僅會依照Podfile的要求來請求類庫。假設類庫版本號號有變化，那麼將獲取失敗。

但是 $ pod update會更新所有的類庫。獲取最新版本號的類庫。

而且你會發現，假設用了 $ pod update，再用 $ pod install 就成功了。

那你或許會問，何時用 $ pod install。何時用 $ pod update 呢。我又不知道類庫有沒有新版本號。

好吧，那你每次直接用 $ pod update 算了。或者先用 $ pod install，假設不行，再用 $ pod update。

好了，小編就囉嗦到這裏吧。上述都僅僅是CocoaPods的最基本使用方法。要繼續研究CocoaPods其它高級使用方法。請點擊這裏CocoaPods Wiki。

固然，假設你認爲小編上面的敘述有問題，或者你有補充，可以發郵件給小編：admin@code4app.com 。

另，假設你想寫其餘小iOS科技類的文章，同時致信小編。