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

CocoaPods 完整使用教學:從安裝到第一個專案整合

編輯:iOS 開發綜合

一、為什麼需要 CocoaPods

做 iOS 開發很難不碰到第三方開源庫,SBJson、AFNetworking、Reachability 幾乎是必備。而傳統手動整合的流程大致是:

  • 下載原始碼並拖進工程
  • 逐一補上它相依的 framework
  • 處理庫與庫、庫與工程之間的相依關係,還要檢查 framework 是否重複加入
  • 一旦某個庫升版,就得把舊的刪掉,再重跑前三步

專案一大,這件事立刻就變成惡夢。CocoaPods 的出現就是為了把這些瑣事全部自動化——我們只需要寫幾行設定,剩下的交給它。

簡單說,CocoaPods 是一個用來管理第三方相依庫的工具。它能解析庫之間的相依關係、下載原始碼,並透過建立一個 Xcode workspace 把這些庫和我們的專案串接起來,讓我們可以自動化、集中且直覺地管理所有開源元件。

二、安裝

CocoaPods 以 Ruby 實作,因此環境需要 Ruby。好消息是 OS X 預設就能跑 Ruby,所以只要一行命令:

 $ sudo gem install cocoapods

安裝過程中若詢問是否更新 rake,輸入 y 即可——rake 這個 gem 會在安裝時檢查是否有新版本。安裝結束後執行:

 $ pod setup

沒有報錯就代表裝好了。

常見問題排查

① 執行 install 後卡住沒反應。很可能是因為 Ruby 預設源是 cocoapods.org,國內存取不穩定。可以換成鏡像:

 $ gem sources --remove https://rubygems.org/   // 等它回應後再執行下一行
 $ gem sources -a https://ruby.taobao.org/

驗證是否成功:

 $ gem sources -l

正常輸出:

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

② gem 版本過舊。gem 是 Ruby 函式庫與程式的標準套件管理器,版本太低也會導致安裝失敗,升級即可:

 $ sudo gem update --system

③ 裝完執行 pod setup 卻報找不到 cocoapods。

 /Users/wangzz/.rvm/rubies/ruby-1.9.3-p448/lib/ruby/site_ruby/1.9.1/rubygems/dependency.rb:298:in `to_specs':
 Could not find 'cocoapods' (>= 0) among 6 total gem(s) (Gem::LoadError)

這是 RVM 的 Ruby 路徑沒切對,指定一下即可:

 $ rvm use ruby-1.9.3-p448

升級 CocoaPods:重跑一次安裝命令就行。

 $ sudo gem install cocoapods

要注意的是,當初安裝用了 sudo,升級也得用,否則容易出現路徑不一致的問題。

三、實際操作

以下示範專案名為 CocoaPodsTest。

1. 建立 Podfile

CocoaPods 的一切都從這個檔案開始:

 $ cd /Users/wangzz/Desktop/CocoaPodsTest
 $ touch Podfile

先切到專案根目錄,建立一個空白 Podfile:

(Podfile 也可以不放根目錄,只是稍麻煩,下一篇會說明。)

2. 編輯 Podfile

以 Reachability、SBJson、AFNetworking 三個庫為例:

 platform :ios
 pod 'Reachability', '~> 3.0.0'
 pod 'SBJson', '~> 4.0.0'

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

3. 執行安裝

 $ cd /Users/wangzz/Desktop/CocoaPodsTest
 $ pod install

輸出大致如下:

 Analyzing dependencies
 Downloading dependencies
 Installing AFNetworking (2.1.0)
 Installing JSONKit (1.5pre)
 Installing Reachability (3.0.0)
 Generating Pods project
 Integrating client project
 [!] From now on use `CocoaPodsTest.xcworkspace`.

最後一行是关键:從現在起請改用 .xcworkspace 開啟專案。

根目錄多了三樣東西:CocoaPodsTest.xcworkspace、Podfile.lock 與 Pods 目錄。

整合過程中發生了什麼?

其一,第三方庫會被編譯成靜態庫。CocoaPods 把所有庫以 target 的形式組成一個名為 Pods 的工程(就在新產生的 Pods 目錄下),最終產出 libPods.a 供我們的專案使用。

其二,兩份工程由一個 workspace 共同管理。CocoaPodsTest 與 Pods 會被組織進 CocoaPodsTest.xcworkspace,方便統一檢視。

其三,原本的專案設定已被改寫,直接開 .xcodeproj 編譯會出錯,務必改用 workspace。

打開 workspace 之後,目錄結構一目了然。在專案中 import 剛才加入的第三方庫標頭檔,編譯通過——整合成功。

四、參考資料

1、https://code4app.com/article/cocoapods-install-usage
2、https://cocoapods.org/

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