雖然網(wǎng)上關(guān)于cocoapods安裝教程多不勝數(shù),但是我在安裝的過程中還是出現(xiàn)了很多錯(cuò)誤,所以大家可以照下來步驟裝一下,我相信會(huì)很好用.

前言

在ios項(xiàng)目中使用第三方類庫可以說是非常常見的事，但是要正確地配置他們有時(shí)候是非常繁瑣的事情，幸運(yùn)的是cocoapods是一個(gè)很好的解決方案。

什么是cocoapods

cocoapods是os x和ios下的一個(gè)第三類庫管理工具，通過cocoapods工具我們可以為項(xiàng)目添加被稱為“pods”的依賴庫（這些類庫必須是cocoapods本身所支持的），并且可以輕松管理其版本。

cocoapods意義體現(xiàn)在兩個(gè)方面。第一，在引入第三方庫時(shí)它可以自動(dòng)為我們完成各種各樣的配置，包括配置編譯階段、連接器選項(xiàng)、甚至是arc環(huán)境下的-fno-objc-arc配置等。第二，使用cocoapods可以很方便地查找新的第三方庫，這些類庫是比較“標(biāo)準(zhǔn)的”，而不是網(wǎng)上隨便找到的，這樣可以讓我們找到真正好用的類庫。

接下來我們將介紹cocoapods的使用。

cocoapods的核心組件

cocoapods是用ruby寫的，并劃分成了若干個(gè)gem包。

cocoapods在解析執(zhí)行過程中最重要的幾個(gè)包的路徑分別是：cocoapods/cocoapods、 cocoapods/core和 cocoapods/xcodeproj。

cocoapods / cocoapod：這是面向用戶的組件，每當(dāng)執(zhí)行一個(gè)pod命令時(shí)，這個(gè)組件將被激活。它包括了所有實(shí)用cocoapods的功能，并且還能調(diào)用其他gem包來執(zhí)行任務(wù)。

cocoapods / core：core gem提供了與cocoapods相關(guān)的文件（主要是podfile和podspecs）的處理。

podfile：該文件用于配置項(xiàng)目所需要的第三方庫，它可以被高度定制。本文中我們主要在這里做動(dòng)作。

podspec：該文件描述了一個(gè)庫將怎樣被添加進(jìn)工程中。.podspec文件可以標(biāo)識該第三方庫所需要的源碼文件、依賴庫、編譯選項(xiàng)，以及其他第三方庫需要的配置。

cocoapods / xcodeproj：這個(gè)包負(fù)責(zé)處理工程文件，它能創(chuàng)建以及修改.xcodeproj文件和.xcworkspace文件。它也可以作為一個(gè)獨(dú)立的包使用，當(dāng)你要編寫修改項(xiàng)目文件的腳本時(shí)，可以考慮使用cocoapods/xcodeproj。

 cocoapods安裝步驟

1、升級ruby環(huán)境

終端輸入：$gem update --system

此時(shí)會(huì)出現(xiàn)

error: while executing gem ... (gem::filepermissionerror)

you don‘t have write permissions for the /library/ruby/gems/2.0.0 directory.

zijingmacbook-pro:~ shiyunlei$ sudo gem update —system

這個(gè)是因?yàn)槟銢]有權(quán)限去更新ruby

這個(gè)時(shí)候你可以在終端使用：$sudo gem update —system來進(jìn)行升級

 這個(gè)時(shí)候表示ruby升級完成。 

2、安裝cocoapods時(shí)我們要訪問cocoapods.org，該網(wǎng)站可能被我們大天朝墻了，這樣下載安裝可能會(huì)是龜速，幸好我們可以用淘寶的ruby鏡像來訪問該網(wǎng)站，方法如下：

可以使用下面的命令(紅色部分)查看是否更換鏡像成功（如下圖所示）：
$ gem sources -l

3、安裝cocoapods，在終端輸入命令

$sudo gem install cocoapods

這個(gè)時(shí)候會(huì)提示你輸入密碼，注：在終端輸入密碼不會(huì)有提示，光標(biāo)也不會(huì)移動(dòng)，一定要注意

開始安裝，如下圖：ps:這個(gè)過程可能花費(fèi)時(shí)間比較長

安裝成功如下：

4、使用search命令搜索類庫名：

$pod search afnetworking

如果cocoapods支持，將會(huì)輸出搜索到的所有類庫版本和信息，以及在podfile中配置的寫法，終端返回信息如下：

-> afnetworking (2.3.1)

a delightful ios and os x networking framework.

pod ‘afnetworking‘, ‘~> 2.3.1'（這個(gè)語句是需要在編輯podfile的時(shí)候輸入的命令，即是如何安裝下載相關(guān)類庫的指令）

- homepage: https://github.com/afnetworking/afnetworking

- source: https://github.com/afnetworking/afnetworking.git

- versions: 2.3.1, 2.3.0, 2.2.4, 2.2.3, 2.2.2, 2.2.1, 2.2.0, 2.1.0,

2.0.3, 2.0.2, 2.0.1, 2.0.0, 2.0.0-rc3, 2.0.0-rc2, 2.0.0-rc1, 1.3.4, 1.3.3,

1.3.2, 1.3.1, 1.3.0, 1.2.1, 1.2.0, 1.1.0, 1.0.1, 1.0, 1.0rc3, 1.0rc2, 1.0rc1,

0.10.1, 0.10.0, 0.9.2, 0.9.1, 0.9.0, 0.7.0, 0.5.1 [master repo]

- sub specs: - afnetworking/serialization (2.3.1) -

afnetworking/security (2.3.1) - afnetworking/reachability (2.3.1) -

afnetworking/nsurlconnection (2.3.1) - afnetworking/nsurlsession (2.3.1)

- afnetworking/uikit (2.3.1)

-> afnetworking+autoretry (0.0.5)

auto retries for afnetworking requests

pod ‘afnetworking+autoretry‘, ‘~> 0.0.5‘

- homepage: https://github.com/shaioz/afnetworking-autoretry

- source: https://github.com/shaioz/afnetworking-autoretry.git

- versions: 0.0.5, 0.0.4, 0.0.3, 0.0.2, 0.0.1 [master repo]

5、需要在工程中創(chuàng)建一個(gè)podfile文件，

使用命令：

$cd /users/shiyunlei/desktop/cocoapodssample(進(jìn)入工程目錄，cd后面的是工程的路徑)

$ touch podfile（創(chuàng)建podfile文件）

然后使用vim編輯podfile文件，使用命令：

$ vim podfile
進(jìn)入如下界面

然后緊接著按鍵盤上的“i”鍵，變成如下狀態(tài)，這個(gè)時(shí)候可以對podfile文件進(jìn)行編輯：

$platform:ios, ‘7.0‘

$ pod ‘afnetworking‘, ‘~> 2.3.1‘

在編輯完成后按“esc”，

在按“:”,這個(gè)時(shí)候輸入wq,點(diǎn)擊回車，保存并退出。

這個(gè)時(shí)候打開podfile文件就會(huì)看到里面添加了剛才在終端輸入的一行語句，如下圖

然后在終端輸入命令安裝相應(yīng)的第三方類庫

$pod install

因?yàn)檫@個(gè)過程需要下載相應(yīng)的類庫，所以時(shí)間和網(wǎng)速有關(guān)。

安裝成功之后截圖如下：

這個(gè)時(shí)候會(huì)看到之后打開工程都需要從類型為工程名.xcworkspace文件打開。

史上最詳細(xì)的cocoapods安裝教程就此結(jié)束了，如果還有什么疑問可以查看下面的相關(guān)文章。