您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 依賴管理工具 CocoaPods 安裝與使用全流程

編輯:iOS 開發綜合

開發移動應用幾乎一定會用到第三方套件。由於套件種類繁多、版本各異,手動下載、手動拖進專案、手動處理衝突實在過於痛苦,這時候就需要一個套件管理工具。iOS 生態中最主流的選擇就是 CocoaPods。

順帶釐清兩個名詞:Cocoa 是開發 macOS 應用的 API 集合,Cocoa Touch 則是給 iOS 觸控設備用的 API(我們新建類別時看到的「Cocoa Touch Class」就是它)。而 CocoaPods 是建在 Ruby 之上的依賴管理工具。

一、安裝 CocoaPods

官網:https://cocoapods.org/。若你的機器已具備 Ruby 環境,一行指令即可裝好:

sudo gem install cocoapods

若還沒有 Ruby 環境,則依序執行以下步驟。

1. 安裝 RVM(Ruby 版本管理器)

curl -L https://get.rvm.io | bash -s stable

2. 重新載入 RVM 設定(或乾脆重開終端機)

source ~/.rvm/scripts/rvm

3. 確認 RVM 安裝成功並查看版本

rvm -v

4. 用 RVM 安裝 Ruby

rvm install 2.0.0
ruby -v      # 確認 Ruby 版本
gem -v       # 確認 gem 版本(安裝 Ruby 時通常會一併裝好)

5. 更換 Ruby 鏡像源。由於官方源在部分網路環境下速度不佳,可換用國內鏡像。先移除原來源:

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

再加入新的鏡像源:

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

接著確認目前使用的鏡像:

gem sources -l

看到輸出中包含 taobao.org 就代表切換成功。

6. 正式安裝 CocoaPods

sudo gem install cocoapods

稍候片刻,終端顯示安裝完成即可。

二、在專案中使用 CocoaPods

(1)建立 iOS 專案。 這裡以 Swift 為例,專案名為 CocoapodsDemo。

(2)建立 Podfile。 在終端機中進入專案根目錄,用 vim 建立名為 Podfile 的文字檔(注意檔名沒有副檔名):

(3)在 Podfile 中宣告要用的套件。 以下以 AFNetworking 為例:

platform :ios, '8.0'
use_frameworks!

target 'CocoapodsDemo' do
    pod 'AFNetworking', '~> 2.6'
end

存檔退出後,回到專案根目錄執行:

pod install

(4)改用 workspace 開啟專案。 終端會提示你以後必須用 xxx.xcworkspace 開啟。關掉原本的 Xcode 專案視窗,在根目錄打開 CocoapodsDemo.xcworkspace,此時左側結構會多出一個 Pods 專案:

三、幾個實務提醒

  • 一定要用 .xcworkspace 開啟。直接用 .xcodeproj 開會找不到 Pods 的設定,編譯必然失敗。
  • Podfile 要進版本控制,Pods 目錄則可依團隊慣例決定是否加入 .gitignore。
  • 鎖定版本。正式專案建議用 Podfile.lock 搭配明確的版本約束,避免團隊成員或 CI 環境裝到不同版本。
  • 鏡像網址更換。上述 taobao 鏡像為當時的可用方案,若失效可查閱官方文件更換為現行可用的鏡像源。
  • 後續套件管理:pod search 找套件、pod update 更新、pod outdated 查看可更新項目。

整體流程走完,第三方庫的引入與版本維護就都交給工具處理了,比手動管理清爽太多。

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