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

CocoaPods 安裝與使用教程(2016 版)

編輯:iOS 開發基礎

本文投稿文章,作者:skytoup(Github)

CocoaPods 簡介

CocoaPods 是一個管理 Swift 與 Objective-C Cocoa 項目依賴的工具,目前庫數量已超過一萬八千個。簡單說,它替你完成第三方庫的引入、版本管理與工程配置,省去手工拖文件、手動配 link flag 的麻煩。

官網地址:https://cocoapods.org/

安裝

macOS 自帶 Ruby,通常不需要另外安裝(除非你卸載過)。

打開 Terminal,依次輸入以下命令(第二條可能需要稍等一會兒):

gem sources --remove https://rubygems.org/
gem source -a https://gems.ruby-china.org

第一條移除官方源,因為不翻牆時訪問較慢;第二條添加 ruby-china 的 RubyGems 鏡像。注意:很多舊教程讓你用 taobao 的 gem 源,但該源已停止維護,請改用 ruby-china(原文見 https://ruby-china.org/topics/29250)。

接著確認鏡像是否添加成功:

gem source

輸出中出現 ruby-china 的鏡像地址,說明配置完成。

然後正式安裝 CocoaPods:

sudo gem install cocoapods

等待片刻即可裝好。安裝結束後執行一次初始化:

pod setup

沒有報錯,整個安裝流程就結束了。

基本使用

cd 到你的工程目錄,執行:

pod init

執行完畢後,該目錄下會生成一個 Podfile。用文本編輯器(vim、Sublime Text 等)打開,大致會看到:

platform :ios, 'xxx'   # 目標平台及版本
use_frameworks!        # Swift 項目需要這句,Objective-C 項目請在前面加 # 註釋掉

target 'xxxx' do
    # 在這裡添加依賴庫,例如:
    pod 'Alamofire', '~> 3.1'
end

編輯完 Podfile 後,cd 到 Podfile 所在目錄,執行其中之一:

pod install --no-repo-update
# 或
pod install

第一條不更新本地庫信息,速度更快,但遇到剛發布的新庫時可能裝不上。若不嫌麻煩,可以定時執行一次:

pod repo update

之後再用第一條命令安裝即可。

安裝完成後,打開項目要打開 xxx.xcworkspace,而不是 xxx.xcodeproj,這一點經常被忽略。

如果之後修改了 Podfile,執行以下命令之一更新依賴(兩者區同上):

pod update --no-repo-update
# 或
pod update

安裝失敗的常見原因

最常見的是 gem 版本過舊。先切換到 ruby-china 源,再執行:

sudo gem update

更新完成後重新安裝 CocoaPods,一般就能通過。此外,如果你之前用 sudo 安裝過舊版本,建議先卸載再重裝,避免多版本共存導致命令指向錯誤。

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