CocoaPods安裝教程

雖然網上關於CocoaPods安裝教程多不勝數,可是我在安裝的過程當中仍是出現了不少錯誤,因此你們能夠照下來步驟裝一下,我相信會很好用.

前言

在iOS項目中使用第三方類庫能夠說是很是常見的事，可是要正確地配置他們有時候是很是繁瑣的事情，幸運的是CocoaPods是一個很好的解決方案。

什麼是CocoaPods

CocoaPods是OS X和iOS下的一個第三類庫管理工具，經過CocoaPods工具咱們能夠爲項目添加被稱爲「Pods」的依賴庫（這些類庫必須是CocoaPods自己所支持的），而且能夠輕鬆管理其版本。

Cocoapods意義體如今兩個方面。第一，在引入第三方庫時它能夠自動爲咱們完成各類各樣的配置，包括配置編譯階段、鏈接器選項、甚至是ARC環境下的-fno-objc-arc配置等。第二，使用CocoaPods能夠很方便地查找新的第三方庫，這些類庫是比較「標準的」，而不是網上隨便找到的，這樣可讓咱們找到真正好用的類庫。

接下來咱們將介紹CocoaPods的使用。

CocoaPods的核心組件

CocoaPods是用Ruby寫的，並劃分紅了若干個Gem包。

CocoaPods在解析執行過程當中最重要的幾個包的路徑分別是：CocoaPods/CocoaPods、 CocoaPods/Core和 CocoaPods/Xcodeproj。

CocoaPods / CocoaPod：這是面向用戶的組件，每當執行一個pod命令時，這個組件將被激活。它包括了全部實用CocoaPods的功能，而且還能調用其餘gem包來執行任務。

CocoaPods / Core：Core gem提供了與CocoaPods相關的文件（主要是podfile和podspecs）的處理。

 

Podfile：該文件用於配置項目所須要的第三方庫，它能夠被高度定製。本文中咱們主要在這裏作動做。

Podspec：該文件描述了一個庫將怎樣被添加進工程中。.podspec文件能夠標識該第三方庫所須要的源碼文件、依賴庫、編譯選項，以及其餘第三方庫須要的配置。

CocoaPods / Xcodeproj：這個包負責處理工程文件，它能建立以及修改.xcodeproj文件和.xcworkspace文件。它也能夠做爲一個獨立的包使用，當你要編寫修改項目文件的腳本時，能夠考慮使用CocoaPods/Xcodeproj。

 

Cocoapods安裝步驟

一、升級Ruby環境

終端輸入：$gem update --system

此時會出現

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

這個是由於你沒有權限去更新Ruby

這個時候你能夠在終端使用：$sudo gem update —system來進行升級

 

這個時候表示Ruby升級完成。

 

二、安裝CocoaPods時咱們要訪問cocoapods.org，該網站可能被咱們大天朝牆了，這樣下載安裝可能會是龜速，幸虧咱們能夠用淘寶的Ruby鏡像來訪問該網站，方法以下：

一、gem sources --remove https://rubygems.org/

二、gem sources -a http://ruby.taobao.org/

最新版的Xcode要將http 換成 https

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

 

三、安裝Cocoapods，在終端輸入命令

$sudo gem install cocoapods

這個時候會提示你輸入密碼，注：在終端輸入密碼不會有提示，光標也不會移動，必定要注意

開始安裝，以下圖：PS:這個過程可能花費時間比較長

 

安裝成功以下：

 若是出現:

ERROR:  While executing gem ... (Errno::EPERM)

    Operation not permitted - /usr/bin/xcodeproj

能夠試試這個命令sudo gem install -n /usr/local/bin cocoapods

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

$pod search AFNetworking

若是CocoaPods支持，將會輸出搜索到的全部類庫版本和信息，以及在Podfile中配置的寫法，終端返回信息以下：

-> AFNetworking (2.3.1)

A delightful iOS and OS X networking framework.

pod ‘AFNetworking‘, ‘~> 2.3.1’（這個語句是須要在編輯Podfile的時候輸入的命令，便是如何安裝下載相關類庫的指令）

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

五、須要在工程中建立一個Podfile文件，

使用命令：

$cd /Users/shiyunlei/Desktop/CocoapodsSample(進入工程目錄，cd後面的是工程的路徑)

$ touch Podfile（建立Podfile文件）

 

而後使用vim編輯Podfile文件，使用命令：

$ vim Podfile
進入以下界面

 

而後緊接着按鍵盤上的「i」鍵，變成以下狀態，這個時候能夠對Podfile文件進行編輯：

  platform:ios, ‘7.0‘

  pod ‘AFNetworking‘, ‘~> 2.3.1‘

在編輯完成後按「esc」，

 

在按「:」,這個時候輸入wq,點擊回車，保存並退出。

 

這個時候打開Podfile文件就會看到裏面添加了剛纔在終端輸入的一行語句，以下圖

 

而後在終端輸入命令安裝相應的第三方類庫

$pod install     若是長時間沒有反應 證實被牆了 換成pod install --verbose --no-repo-update這個命令 

 

由於這個過程須要下載相應的類庫，因此時間和網速有關。

安裝成功以後截圖以下：

 

這個時候會看到以後打開工程都須要從類型爲工程名.xcworkspace文件打開。