您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 訊息 >> iOS 相關資訊

CocoaPods 安裝與使用完整教程

編輯:iOS 相關資訊

CocoaPods 是什麼

開發 iOS 應用時,幾乎一定會用到第三方開源庫,例如 JSONKit、AFNetworking 等。有些庫又依賴其他庫,為了用它你得先補齊一長串依賴;更麻煩的是,當某個庫有了新版本,你還得重新下載、重新加入專案,過程瑣碎又容易出錯。

CocoaPods 正是為了解決這些惱人之事而生,而且它應該是 iOS 生態中最常見、最有名的類別庫管理工具。上述兩個問題,只要一行命令就能搞定(前提是環境設定正確)。更關鍵的是,絕大多數知名開源庫都支援 CocoaPods,因此把它學會算是 iOS 開發者的基本功。

安裝 CocoaPods

安裝前,本機必須先有 Ruby 環境。Mac 上的 Ruby 環境建置方式這裡不展開。

若 Ruby 已就緒,安裝只需一行命令,在終端機輸入:

sudo gem install cocoapods

但在某些網路環境下,你會發現指令敲完之後老半天沒反應——因為預設的 gem 來源被牆住了。

解法是改用鏡像來源。依序在終端機執行:

gem sources --remove https://rubygems.org/
// 等上面這個有反應之後,再執行下一行
gem sources -a https://ruby.taobao.org/

接著驗證來源是否已只剩鏡像:

gem sources -l

只有輸出下面這段,才代表前面的步驟成功:

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

完成上述設定後,終端機上的畫面大致如下:

此時再執行一次安裝指令:

sudo gem install cocoapods

等十幾秒,CocoaPods 就裝好了,不需要其他設定。

如何使用 CocoaPods

好消息是,使用它同樣簡單。下面用兩個常見場景說明。

場景一:把 AFNetworking 導入專案

AFNetworking 的 GitHub 位址是 https://github.com/AFNetworking/AFNetworking 。動手前可以先確認它是否支援 CocoaPods:

pod search AFNetworking

幾秒後終端機會列出相關資訊,能搜到就代表支援。

接著用 Xcode 建一個名為 CocoaPodsDemo 的專案。先看一下尚未支援 CocoaPods 時的目錄結構,稍後好做對比:

你可能會好奇:CocoaPods 怎麼知道該下載哪些庫?答案是靠一個名為 Podfile 的檔案(檔名必須精確,而且沒有副檔名)。你在裡面寫上要下載的庫,等於告訴 CocoaPods「就是這些,快到碗裡來」。每個專案只需要一個 Podfile。

在終端機中切換到專案目錄,用 vim 建立 Podfile:

vim Podfile

寫入以下內容:

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

這兩行並非憑空而來,通常可以在該庫的 GitHub 頁面找到。意思是:支援的 iOS 平台版本為 7.0,要下載的 AFNetworking 版本為 2.0 以上。

存檔退出(vim 下輸入 :wq)。此時專案目錄中會出現一個 Podfile,位置必須和 .xcodeproj 同一層。

接著在同一個目錄執行:

pod install

之所以要在專案目錄下執行,就是因為這是把庫安裝進「這個專案」。

終端機大致會輸出:

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。

.xcworkspace 正是 pod install 產生的。此外還會多出 Podfile.lock 與一個 Pods 目錄。打開 workspace 後,目錄結構如下:

AFNetworking 已經成功進到專案裡(紅框處)。現在你可以直接:

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

編譯看看,若前面步驟無誤是不會出錯的。

小結一下,導入流程就兩步:建立 Podfile(內容通常是原作者在 README 中提供的寫法),然後執行 pod install。

場景二:正確編譯一個含 CocoaPods 依賴的專案

新手常遇到這種情況:在 GitHub 找到一份符合需求的程式碼,興沖沖下載回來一編譯,滿屏都是找不到某個 header 的錯誤。先別慌,仔細看會發現專案裡有 Podfile——這代表你可以用 CocoaPods 輕鬆補齊依賴。

以 UAAppReviewManager 為例(它能幫你把「提醒使用者評分」的功能加入 App)。下載後打開 Example 專案編譯,會看到一堆找不到頭檔案的錯誤;同時你會在 UAAppReviewManagerExample 目錄下發現三個與 CocoaPods 相關的項目:Podfile、Podfile.lock 與 Pods。

打開終端機,切到與 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.xcworkspace:

之後就用這個 workspace 開啟並執行:

這裡有個容易踩的坑:如果你改用 pod install,可能會失敗並出現:

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

意思是 Podfile 裡指定的版本已過期,與實際可用版本不符。pod install 只會照 Podfile 的要求去抓,版本對不上就失敗;而 pod update 會更新所有庫到最新版。實測時用過 pod update 之後再跑 pod install 也會成功。

那到底何時該用哪一個?如果你不確定庫有沒有出新版,最省事的策略是:先試 pod install,失敗再換 pod update。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved