iOS安裝CocoaPods詳細過程

一、簡介

• 什么是CocoaPods

CocoaPods是OS X和iOS下的一個第三類庫管理工具，通過CocoaPods工具我們可以為項目添加被稱為“Pods”的依賴庫（這些類庫必須是CocoaPods本身所支持的），並且可以輕松管理其版本。

• CocoaPods的好處

1、在引入第三方庫時它可以自動為我們完成各種各樣的配置，包括配置編譯階段、連接器選項、甚至是ARC環境下的-fno-objc-arc配置等。
2、使用CocoaPods可以很方便地查找新的第三方庫，這些類庫是比較“標准的”，而不是網上隨便找到的，這樣可以讓我們找到真正好用的類庫。

Cocoapods.jpg

二、Cocoapods安裝步驟

注意：在終端輸入命令時，取$后面部分輸入

1、升級Ruby環境

終端輸入：$ gem update --system

此時會出現

沒權限升級Ruby的提示

這是因為你沒有權限去升級Ruby

這時應該輸入：$ sudo gem update --system

此時會出現

輸入密碼

接下來輸入密碼，注意：輸入密碼的時候沒有任何反應，光標也不會移動，你盡管輸入就是了，輸完了直接回車。
等一會如果出現

升級Ruby成功

恭喜你，升級Ruby成功了。

2、更換Ruby鏡像

首先移除現有的Ruby鏡像

終端輸入：$ gem sources --remove https://rubygems.org/

然后添加國內最新鏡像源（淘寶的Ruby鏡像已經不更新了）

終端輸入：$ gem sources -a https://gems.ruby-china.org/

執行完畢之后輸入gem sources -l來查看當前鏡像

終端輸入：$ gem sources -l

如果結果是
*** CURRENT SOURCES ***
https://gems.ruby-china.org/
說明添加成功，否則繼續執行$ gem source -a https://gems.ruby-china.org/來添加

3、安裝CocoaPods

接下來開始安裝

終端輸入：$ sudo gem install cocoapods

如果出現這個

安裝錯誤提示

說明沒有權限，需要輸入

終端輸入：$ sudo gem install -n /usr/local/bin cocoapods

安裝成功如下：

安裝成功

到這之后再執行pod setup（PS：這個過程是漫長的，要有耐心）

終端輸入：$ pod setup

然后你會看到出現了Setting up CocoaPods master repo，卡住不動了，說明Cocoapods在將它的信息下載到 ~/.cocoapods里。
你可以command+n新建一個終端窗口，執行cd ~/.cocoapods/進入到該文件夾下，然后執行du -sh *來查看文件大小，每隔幾分鍾查看一次，這個目錄最終大小是900多M（我的是930M）
當出現Setup completed的時候說明已經完成了。

哈哈，太不容易了，終於走到這一步了，終於安裝完成了，那么到底能不能用呢？咱們接着往下看！
注意：以上所有的步驟都是為這台電腦配置CocoaPods環境，以下才是真正的把CocoaPods安裝到你的工程里面。

4、CocoaPods的使用

1、首先我們來搜索一下三方庫

終端輸入：$ pod search AFNetworking

這時有可能出現

搜索不到的提示

這是因為之前pod search的時候生成了緩存文件search_index.json
執行 rm ~/Library/Caches/CocoaPods/search_index.json來刪除該文件
然后再次輸入 pod search AFNetworking進行搜索
這時會提示 Creating search index for spec repo 'master'..
等待一會將會出現搜索結果如下：

AFNetworking搜索結果

出現這個了就說明搜索成功了，看一下上圖中的這一句：
pod 'AFNetworking', '~> 3.1.0'
這句話一會我們要用到，這是CocoaPods添加三方庫的關鍵字段
然后退出這個界面（這一步只是驗證一下cocoapods有沒有安裝成功，能不能搜索到你想要的三方庫），直接按"q"就退出去了。

如果搜索到的版本不是最新的，請查看iOS解決CocoaPods搜索不到最新版SDK的問題

2、在工程中創建一個Podfile文件

要想在你的工程中創建Podfile文件，必須先要進到該工程目錄下

終端輸入：$ cd /Users/liyang/Desktop/CocoaPodsTest
//這是我電腦上的路徑，你輸入你自己項目的路徑或直接拖拽也行

進來之后就創建

終端輸入：$ touch Podfile

然后你在你的工程目錄下可以看到多了一個Podfile文件

3、編輯你想導入的第三方庫的名稱及版本

使用vim編輯Podfile文件

終端輸入：$ vim Podfile

進入如下界面：

編輯Podfile文件

進來之后緊接着按鍵盤上的英文'i'鍵
下面的"Podsfile" 0L, 0C將變成-- INSERT --
然后就可以編輯文字了，輸入以下文字

platform :ios, '7.0'
target 'MyApp' do
pod 'AFNetworking', '~> 3.1.0'
end

解釋一下
platform :ios, '7.0'代表當前AFNetworking支持的iOS最低版本是iOS 7.0,
'MyApp'就是你自己的工程名字，
pod 'AFNetworking', '~> 3.1.0'代表要下載的AFNetworking版本是3.1.0及以上版本，還可以去掉后面的'~> 3.1.0'，直接寫pod 'AFNetworking'，這樣代表下載的AFNetworking是最新版。

編輯完之后成如下樣子：

編輯完成

此時該退出去了，怎么退出去呢？跟着我做，先按左上角的esc鍵，再按：鍵，再輸入wq，點擊回車，就保存並退出去了。

這時候，你會發現你的項目目錄中名字為Podfile的文件的內容就是你剛剛輸入的內容。

4、把該庫下載到Xcode中

終端輸入：$ pod install

這就開始下載了，需要一段時間，出現如下界面就說明安裝好了

安裝成功

這個時候關閉所有的Xcode窗口，再次打開工程目錄會看到多了一個后綴名為.xcworkspace文件。

工程目錄

以后打開工程就雙擊這個文件打開了，而不再是打開.xcodeproj文件。
進入工程后引入頭文件不再是#import "AFNetworking.h"，而是#import <AFNetworking.h>

作者：my_楊哥
鏈接：http://www.jianshu.com/p/9e4e36ba8574
來源：簡書
著作權歸作者所有。商業轉載請聯系作者獲得授權，非商業轉載請注明出處。