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

iOS CocoaPods 安裝與使用完整流程

編輯:iOS 相關資訊

CocoaPods 是 iOS/macOS 上最普及的相依性管理工具。它的安裝過程對新手來說不算直覺,尤其是 Ruby 環境這一段,因此這裡把整個流程從頭走一遍。

一、準備 Ruby 環境(rvm)

$ source ~/.rvm/scripts/rvm
$ rvm --version        # 查看版本,確認 rvm 是否安裝正確

接著用 rvm 安裝 Ruby:

$ rvm install 2.0.0    # 過程中需按 Enter 輸入管理員密碼
$ rvm 2.0.0 --default  # 把剛才安裝的版本設為系統預設
$ ruby --version       # 確認 Ruby 版本

二、安裝 CocoaPods

1. 切換 Ruby 鏡像

由於國外 gem 來源連線速度往往不理想,可以改用鏡像:

$ gem sources --remove https://rubygems.org/
$ gem sources -a https://ruby.taobao.org/
$ gem sources -l       # 確認目前的來源已是鏡像

2. 安裝 CocoaPods

$ sudo gem install cocoapods    # 需輸入管理員密碼

3. 驗證

$ pod

能印出說明訊息就代表安裝成功。

三、基本使用

1. 查詢第三方庫是否支援

$ pod search SDWebImage

清單會列出所有與關鍵字相關、且支援 CocoaPods 的框架及版本號。

2. 在專案中啟用 CocoaPods

以桌面上名為 test 的專案為例,進入專案所在目錄後建立 Podfile:

zhangcandeiMac:Desktop pican$ cd podsTest/
$ vim Podfile

在 Podfile 中輸入:

platform :ios, '6.1'
pod 'SDWebImage', '~>3.6'

存檔退出(Esc 後輸入 :wq)。這兩行的寫法通常可以直接從第三方庫的 GitHub 說明文件中複製,文件裡都會註明該如何加入。

3. 安裝相依庫

$ pod install    # 依 Podfile 內容下載安裝

安裝時間取決於網路狀況。完成後請特別注意最後一行提示:from now on use 'podsTest.xcworkspace'。

此時目錄中會多出幾個檔案:

  • Pods 目錄:存放你下載的所有第三方庫。
  • Podfile:記錄「需要哪些庫」,檔名固定為 Podfile 且沒有副檔名。
  • Podfile.lock:記錄「實際安裝的版本號」。
  • .xcworkspace:此後請改用 workspace 開啟專案,而非 .xcodeproj。因為 workspace 裡包含兩個專案:你自己的,以及管理第三方庫的 Pods 專案。

Podfile.lock 對團隊開發格外重要。某位成員 checkout 之後執行 pod install,取得的會是與其他成員完全一致的版本;若少了這個檔案,每個人可能都裝到當時的最新版,版本不一致所帶來的問題會非常棘手。因此 Podfile.lock 應該要進版控。

4. 更新相依庫

若某個第三方庫本身又相依於其他以 CocoaPods 管理的庫,直接執行:

$ pod update    # 把 Podfile 中的所有庫更新到最新版

幾點實務建議

  • 日常開發用 pod install,只有想升級時才用 pod update。這是兩者最關鍵的差異:install 會尊重 Podfile.lock 的版本,update 則會忽略 lock 往外抓新版。
  • Podfile 的 platform 版本要與專案 Deployment Target 一致,否則安裝時容易出現警告或不相容。
  • 不要手動改 Pods 目錄。它是產物,pod install 會直接覆蓋。
  • 目前主流工具已有變化。鏡像網址、Ruby 版本要求都會隨時間調整,若遇到 gem 權限問題,可考慮改用 Homebrew 安裝的 Ruby 或 Bundler 鎖定 CocoaPods 版本,能避免團隊成員版本不一致的困擾。
  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved