CocoaPods 安裝與使用

weixin_34365417發表於2016-06-12

1、安裝

  1. 開啟Finder/應用程式/實用工具/終端；
  2. CocoaPods 是用 Ruby 寫的，所以執行需要安裝 Ruby 環境。Mac 中已經自帶 Ruby 環境，如果認為 Ruby 環境不夠新，可以先在終端輸入以下命令進行更新：
gem update –system

由於安裝 CocoaPods 時要訪問cocoapods，因為可能被遮蔽了，因此用淘寶的Ruby映象來訪問該網站，在終端輸入以下命令進行替換映象：

gem sources --remove https://rubygems.org/
gem sources -a https://ruby.taobao.org/

成功後，使用以下命令檢視：

gem sources –l

可以看到替換映象成功：

*** CURRENT SOURCES ***
https://ruby.taobao.org/

接下來是真正的安裝，在終端輸入以下命令（如果 Ruby 版本過低，以下命令會報錯）：

sudo gem install cocoapods

如果 Ruby 版本過低導致無法安裝，則執行以下命令進行升級：

curl -L get.rvm.io | bash -s stable    // 安裝 rvm
source ~/.bashrc  // 更新
source ~/.bash_profile  // 更新
ruby -v  // 檢視當前 ruby 版本
rvm list known  // 列出可安裝版本
rvm install 2.2  // 安裝 ruby 2.2 版本

等待安裝成功後使用以下命令配置 cocoapods：

pod setup
  1. 安裝指定版本的cocoapod：
sudo gem install cocoapods -v 0.34.4

2、建立工程並配置第三方類庫

  1. 首先開啟 Xcode 新建一個工程，假設為 Desktop/CocoaPodsDemo ，並且我們要往該工程中匯入 AFNetworking 這個類庫。
    AFNetworking 在 Github 中的地址為：https://github.com/AFNetworking/AFNetworking
    這裡也說明了如何使用CocoaPods配置該類庫：
    808722-be113f89b0be8c6e.png
    配置
  2. 以上說明是我們應該如何書寫 Podfile 檔案。一般非常流行和成熟的類庫都得到了 CocoaPods 的支援，並且有這個說明。如何確定 CocoaPods 是否支援我們想要加入的目標類庫？使用 Search 命令搜尋類庫名：
pod search AFNetworking

如果 CocoaPods 支援，將會輸出搜尋到的所有類庫版本和資訊，以及在 Podfile 中配置的寫法，例如：

808722-7c928ad3aeabadb7.png
Podfile檔案

  1. 先看看普通的工程目錄：
    808722-86e60d788da8a1c7.png
    普通工程目錄

    首先在我們的工程目錄下建立 Podfile 檔案，該檔案用來控制 CocoaPods 的下載內容，該檔案是沒有字尾的，每個專案只需要一個 Podfile 檔案，如果需要匯入多個類庫那麼統一在該檔案中書寫下載內容。
    建立過程：首先 cd 到工程目錄，然後建立 Podfile 並且使用 vim 編寫：
  2. 建立檔案：
cd Desktop/CocoaPodsDemo/
pod init    # 自動建立 Podfile 檔案，也可以使用 touch Podfile 手動建立 Podfile 檔案
  1. 編寫命令：
platform:ios, '7.0'
pod "AFNetworking", "~>2.1"

Podfile 中的兩句文字的意思是，當前 AFNetworking 支援的 iOS 最高版本是 iOS 7.0, 要下載的 AFNetworking 版本是2.1。

  1. 在有了 Podfile 後，在 Podfile 檔案所在目錄下輸入以下命令安裝類庫：
pod install

安裝完成後，輸出資訊如下：

Analyzing dependencies
Downloading dependencies
Installing AFNetworking (2.1.0)
Generating Pods project
Integrating client project
 [!] From now on use `CocoaPodsDemo.xcworkspace`.

最後一句表明，如果要正確開啟工程我們應該開啟最新生成的 .xcworkspace 檔案。

3、編譯執行

如果一個專案中已經包含了 CocoaPods 的配置檔案，但是編譯卻出現錯誤，那麼我們僅需要一行命令就可以配置好所有的第三方類庫了：

pod update

4、僅新增要加入的庫

pod install --verbose --no-repo-update

5、解除安裝

在終端執行：

sudo gem uninstall cocoapods

相關文章