- 網上的教程有很多,但是自己在安裝和使用的過程中,總會遇到各式各樣的問題。
在這里將我自己的安裝與使用過程與大家分享一下。
一、介紹
- 簡單的說,CocoaPods 就是一個第三方開源庫的管理工具,就像 Java 的 Maven。至于它的原理,這里就不說了。(畫外音:其實原理我也不知道 ?? )
- 開發中經常會用到一些第三方,使得開發簡便,比如:AFNetWorking、SDWebImage、FMDB 等等。不借助工具的話,需要手動將開源庫的源代碼復制到項目、添加它的依賴框架、設置 -ObjC 等參數,如果有更新還要及時的手動更新。這些操作沒有技術含量,而且浪費時間,還容易漏添報錯。
- 使用 CocoaPods 可以避免這些繁瑣的操作,只需幾行命令就可以添加、移除、更新需要的第三方。
二、安裝
#######1.查看當前 Ruby( Mac 默認安裝了 Ruby 環境)
gem sources -l
終端返回信息如下:
*** CURRENT SOURCES ***
https://rubygems.org/
2.移除當前 Ruby 默認源,換成淘寶的(默認源用的是亞馬遜云服務,被墻了)
gem sources --remove https://rubygems.org/
gem sources -a https://ruby.taobao.org/
gem sources -l
終端返回如下信息說明替換成功
*** CURRENT SOURCES ***
https://ruby.taobao.org/
3.安裝 CocoaPods
sudo gem install cocoapods
pod setup
?? 當初新買個 Mac 自帶的系統是 OS X EL Capitan,按照網上教程無論怎么安裝都報錯。要注意:系統版本為10.11以后的安裝命令如下:
sudo gem install -n /usr/local/bin cocoapods
pod setup
- pod setup 過程中可能報錯,可能是 gem 版本太低,需要更新 gem
sudo gem update --system
完成后會提示:
Latest version currently installed. Aborting.
?? 建議 gem 過一段時間最好更新一下,否則導入第三方可能會出現版本問題。公司前一段讓我做直播功能,我用七牛的 PLCameraStreamingKit,官方最新版本是1.8.1,我倒入時總是會缺少幾個文件對應的方法,卡了我好久,后來發現是 gem 版本太低,只能導入1.6.3的版本。
- pod setup 過程會比較久,網速慢的小伙伴要經歷漫長的等待??
終端中出現如下信息,說明 CocoaPods 正在下載
Setting up CocoaPods master repo
- 強迫癥患者可以進到下載目錄,查看進度
cd ~/.cocoapods
du -sh *
825M repos(我現在的是825M)
- 直到出現下面的信息,大功告成
Setup completed
三、使用
- 進到需要集成 CocoaPods 的項目目錄(直接 cd 空格,將項目直接拖到終端即可)
- 創建 Podfile,方法很多,可以直接 pod init,按照目錄中生成的 Podfile 文件格式填寫。不過我更習慣下面的操作:
vim Podfile
- 編輯如下內容:('test'為項目名、'~> 3.0'為版本號,若不寫,默認下載最新的)
platform :ios, '8.0'
target 'test' do
pod 'AFNetworking', '~> 3.0'
end
- 保存退出后
pod install
- 添加新的第三方后,可以
pod update
- 有時 pod install 或者 pod update 會卡在 Analyzing dependencies 好久,是因為這兩個命令執行時會更新 CocoaPods 的 spec 倉庫,替換為如下命令可跳過這一步
pod install --verbose --no-repo-update
pod update --verbose --no-repo-update
- 當需要在 Swift 中 使用 CocoaPods 時,需要使用框架來代替靜態庫。即在 Podfile 文件中加入
use_frameworks!
如果沒有這一句,pod install 會報錯。