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

CocoaPods 入門:iOS 第三方套件管理這樣做就對了

編輯:iOS 相關資訊

手動管理第三方函式庫是件痛苦的事:要下載原始碼、拖進專案、設定 header search path、處理系統框架相依、更新時還得重來一遍。CocoaPods 把這一切都自動化了。

一、CocoaPods 是什麼

它是一個專門管理 iOS / macOS 專案中第三方開源程式碼的相依性工具,原始碼在 GitHub 上開源。你只要在一個文字檔裡寫清楚要哪些套件、哪些版本,執行一道指令,它就會幫你下載、配置專案設定、處理套件之間的相依關係。省下的時間與避免的人為錯誤相當可觀。

二、安裝

CocoaPods 以 Ruby gem 形式發布,在終端機依序執行:

sudo gem install cocoapods
pod setup

pod setup 會把 spec 索引庫 clone 到本機,第一次執行需要等候一段時間。若你的網路環境無法順利存取 GitHub,可以先換用鏡像來源:

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

三、基本使用流程

第一步,在 Xcode 建立專案(例如 PodsDemo),完成後關閉 Xcode。

第二步,在終端機 cd 進入專案所在目錄,建立配置檔:

vi Podfile

內容可以寫成:

platform :ios, '7.0'
pod 'AFNetworking'

除了宣告要用的套件,platform 這行同時指定了專案支援的最低系統版本。

第三步,存檔退出(:wq),然後安裝:

pod install

第四步,從此之後請改用 Finder 打開 PodsDemo.xcworkspace,而不是原本的 .xcodeproj。CocoaPods 建立的 workspace 同時包含了你的專案與 Pods 專案,直接開 xcodeproj 會找不到標頭檔。

小提醒:在較舊的 Xcode 版本中,#import 時可能沒有自動補全提示,但手動輸入完整名稱仍能正常編譯,不必誤以為設定有錯。

四、常用操作

搜尋可用的第三方套件:

pod search json

可以輸入完整套件名稱,也可以只用關鍵字模糊搜尋。

更新相依:編輯 Podfile 增減套件後存檔,執行:

pod update
# 或
pod install

兩者的差異值得記住:pod install 只會安裝 Podfile 中新增的套件,並嚴格遵守 Podfile.lock 中鎖定的版本,適合日常開發與多人協作;pod update 會忽略 lock 檔重新解析並升級到符合 Podfile 約束的最新版本,適合明確想升級時使用。提交原始碼時,Podfile.lock 一定要進版控,這樣團隊成員才會拿到完全一致的版本。

更多資訊可參考官方文件:https://docs.cocoapods.org/guides/getting_started.html

五、附帶提到的 gem 指令

由於 CocoaPods 以 gem 發布,順手整理幾個常用指令:

gem sources -a https://ruby.taobao.org/   # 加入套件來源
gem sources --list                     # 列出目前來源
sudo gem update --system               # 升級 gem 本身
gem --version                          # 查看版本
gem cleanup                            # 清除過舊版本
gem install <name>                     # 安裝
gem uninstall <name>                   # 移除
gem update                             # 更新所有已安裝套件
gem list                               # 列出已安裝套件

最後補充一個實務建議:Podfile 中盡量鎖定版本(例如 pod 'AFNetworking', '~> 3.0'),避免團隊不同成員在不同時間執行 pod install 拿到不同版本,這是多人協作最常見的踩坑來源。

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