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

CocoaPods 完整使用指南:從安裝到第三方框架管理

編輯:iOS 開發綜合

1. CocoaPods 是什麼

CocoaPods 是 iOS 開發中最常用、也最知名的類別庫管理工具。開發過程中難以避免要使用第三方框架,CocoaPods 的出現讓我們能更從容地管理這些依賴,讓專案中的第三方庫更新變得方便許多。

2. 安裝 CocoaPods

CocoaPods 的服務器在國外,直接安裝往往很慢甚至失敗,實務上會先切換到國內的 Ruby 鏡像。

Step 1 查看目前的 gem 來源:

$ gem sources -l
*** CURRENT SOURCES ***
https://rubygems.org/

Step 2 移除官方來源(會要求輸入密碼):

$ sudo gem sources -r https://rubygems.org/

Step 3 加入鏡像來源:

$ sudo gem sources -a https://gems.ruby-china.com/

Step 4 安裝:

$ sudo gem install cocoapods

Step 5 驗證:安裝完成後在終端輸入 pod 並回車,能看到相關指令說明就代表成功。

常用的 gem 指令整理:

# 查看 gem 來源
gem sources -l
# 升級 gem 本身
sudo gem update --system
# 查看版本
gem --version
# 清理過期的 gem
sudo gem cleanup
# 安裝套件
sudo gem install cocoapods
# 移除套件
gem uninstall cocoapods
# 更新套件
sudo gem update
# 列出本地已安裝的套件
gem list

3. 在 Objective-C 專案中使用 CocoaPods

# 1. 切換到專案根目錄(把專案資料夾直接拖進終端即可)
$ cd 專案根目錄

# 2. 建立 Podfile
$ vim Podfile

# 3. 進入編輯模式
按 i

# 4. 寫入需要的框架,格式為 pod '框架名稱'
# 5. 退出編輯模式並存檔
按 ESC,輸入 :wq

# 6. 下載/更新第三方框架
$ pod update --no-repo-update

成功後終端會提示:

[!] Please close any current Xcode sessions
and use `xxxxx.xcworkspace` for this project from now on.
Pod installation complete! There is 1 dependency from the Podfile
and 1 total pod installed.

從這一刻起,請改用 .xcworkspace 開啟專案,不要再直接開 .xcodeproj,否則找不到 pods。

4. 在 Swift 專案中使用 CocoaPods

$ cd 專案資料夾
$ pod init

此時專案資料夾下會產生一個 Podfile,用 Xcode 打開它,內容大致如下:

# platform :ios, '8.0'   // 指定支援的最低 iOS 版本
# use_frameworks!        // Swift 專案必須打開這行

target 'text' do
end

搜尋要用的框架(以 AFNetworking 為例):

$ pod search afn

=> AFNetworking (3.1.0)
    A delightful iOS and OS X networking framework.
    pod 'AFNetworking', '~> 3.1.0'
    - Homepage: https://github.com/AFNetworking/AFNetworking

把找到的 pod 宣告貼進 Podfile:

platform :ios, '8.0'
use_frameworks!

target 'text' do
    pod 'AFNetworking'
end

然後安裝:

$ pod install --no-repo-update

一樣會看到提示,改用 xxxxx.xcworkspace 開啟專案即可。

5. 移除不需要的框架

從 Podfile 中刪掉對應的 pod 宣告,然後執行:

$ pod update --no-repo-update

6. 用圖形界面管理(Alcatraz 插件)

不想敲指令的話,可以安裝 Xcode 插件 Alcatraz,它會提供一個視覺化的套件管理視窗。

  • GitHub 位址:https://github.com/mneorr/Alcatraz

安裝完成後點 Window → Package Manager,搜尋 cocoapods。

完全退出 Xcode,新建一個專案,然後從選單選擇 Product → CocoaPods → Create/Edit Podfile。

打開這個檔案後,把內容精簡成你要的框架名稱。

接著 Install Pods 就能點擊了。

控制台會開始輸出訊息,若等一會兒沒有反應,就自己開終端處理:

cd 專案資料夾
pod install --verbose --no-repo-update   # 忽略本地快取,直接從網上抓最新版

指令速查

# 第一次安裝框架
pod install
# 之後升級、新增、刪除框架,或某個框架版本怪怪的
pod update
# 搜尋框架
pod search XXX
# 在專案資料夾下產生預設的 Podfile
pod init

Podfile 格式要點:

# 最低支援的 iOS 版本
platform :ios, '8.0'

# Swift 專案需要把框架轉成 frameworks 才能使用
use_frameworks!

# 框架清單
pod 'AFNetworking'

兩個實務提醒:Podfile 建議提交進版本控制,但 Pods/ 目錄是否納入版控則看團隊習慣;另外 pod install 與 pod update 的差別在於前者尊重 Podfile.lock 中鎖定的版本、後者會重新解析並升級,日常協作請優先使用 pod install,以免不同人拉到不同版本。

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