一、CocoaPods簡介
1.什么是CocoaPods?
CocoaPods是iOS的包管理工具。
2.為什么要使用CocoaPods?
在開發(fā)iOS項目時,經(jīng)常會使用第三方開源庫,手動引入流程復(fù)雜,并且?guī)熘g還存在依賴關(guān)系,更增加了手動管理的難度。開源庫如果升級了,你也想用最新版本,還需要重新手動導(dǎo)入,這大大增加了工作量。但用了CocoaPods后,安裝和升級都只是一句命令的事情,讓你可以專于業(yè)務(wù)本身。
二、CocoaPods安裝
1. 安裝Ruby
CocoaPods基于Ruby語言開發(fā)而成,因此安裝CocoaPods前需要安裝Ruby環(huán)境。幸運(yùn)的是Mac系統(tǒng)默認(rèn)自帶Ruby環(huán)境,如果沒有請自行查找安裝。檢測是否安裝Ruby:
$ gem -v
2.0.14
安裝則會提示當(dāng)前Ruby版本。gem介紹:gem是一個管理Ruby庫和程序的標(biāo)準(zhǔn)包,它通過Ruby Gem(如 http://rubygems.org/ )源來查找、安裝、升級和卸載軟件包,非常的便捷。
2. 更換gem源
因?yàn)閲鴥?nèi)網(wǎng)絡(luò)的問題導(dǎo)致gem源間歇性中斷,原因你懂的。因此我們需要更換gem源,使用淘寶的gem源https://ruby.taobao.org/。
第一步:移動默認(rèn)的源
gem sources --remove https://rubygems.org/
第二步:指定淘寶的源
gem sources -a https://ruby.taobao.org/
第三步:查看指定的源是不是淘寶源
$ gem sources -l
*** CURRENT SOURCES ***
https://ruby.taobao.org/
如果是https://ruby.taobao.org/,則更換成功。
3. 安裝CocoaPods
終于開始安裝CocoaPods,說實(shí)話本人都快忘記是在寫CocoaPods的教程了,囧!確認(rèn)改成淘寶源后執(zhí)行以下命令進(jìn)行安裝:
sudo gem install cocoapods
稍等片刻即可安裝完成,輸入以下命令檢測是否安裝成功:
$ pod --version
0.39.0
成功則會提示CocoaPods版本,到此安裝已告一段落。
三、CocoaPods使用實(shí)例
首先新建一個iOS工程MyDemo,在該工程中演示CocoaPods的使用。
1. 創(chuàng)建Podfile
進(jìn)入工程的根目錄,創(chuàng)建Podfile文件,創(chuàng)建完畢的目錄如下圖:
2. 編輯Podfile
根據(jù)需要,我們可以在Podfile文件中寫入我們需要的第三方庫,這里以AFNetworking和MJRefresh為例,Podfile內(nèi)容如下:
platform :ios, '7.0'
pod 'AFNetworking', '~> 3.0'
pod 'MJRefresh','~> 3.1'
這段代碼的意思是,當(dāng)前類庫支持的iOS最低版本是iOS 7.0, 要下載的兩個類庫的版本分別為 3.0、3.1。
3. pod install 導(dǎo)入第三方庫
這時候,你就可以利用CocoPods下載AFNetworking和MJRefresh類庫了。在終端中進(jìn)入工程根目錄,運(yùn)行以下命令:
$ cd /Users/myl/Desktop/IOS/MyDemo
$ pod install
Analyzing dependencies
Downloading dependencies
Installing AFNetworking (3.0.4)
Installing MJRefresh (3.1.0)
Generating Pods project
Integrating client project
[!] Please close any current Xcode sessions and use `MyDemo.xcworkspace` for this project from now on.
Sending stats
注意最后一句話,意思是:以后打開工程就用 MyDemo.xcworkspace 打開,而不是之前的.xcodeproj文件。你也許會郁悶,為什么會出現(xiàn).xcworkspace文件呢。這正是你剛剛運(yùn)行pod install命令產(chǎn)生的新文件。除了這個文件,你會發(fā)現(xiàn)還多了另外一個文件“Podfile.lock”和一個文件夾“Pods”。點(diǎn)擊 MyDemo.xcworkspace 打開工程之后,你會發(fā)現(xiàn)工程目錄多了一些,你會驚喜地發(fā)現(xiàn),AFNetwoking和MJRefresh已經(jīng)成功導(dǎo)入項目了!
新的目錄結(jié)構(gòu):
4. pod update 更新第三方庫
如果需要引入或刪除類庫,只需要修改Profile文件后執(zhí)行以下命令即可:
pod update
5. 工程中使用類庫
如果是OC項目,只需在使用的文件中導(dǎo)入該類庫的頭文件即可:
#import "AFNetworking.h"
#import "MJRefresh.h"
如果是Swift項目,使用OC的類庫,需要新建橋接頭文件(MyDemo-Bridging-Header.h),在頭文件中導(dǎo)入要使用的類庫:
#import <AFNetworking/AFNetworking.h>
#import <MJRefresh/MJRefresh.h>
四、常見問題
1. install,update速度慢
出現(xiàn)原因:你本地的repo庫太長時間沒有更新了
解決辦法:pod repo update
原因在于當(dāng)執(zhí)行以上兩個命令的時候會升級CocoaPods的specs倉庫,如果不想在install,update的時候升級specs庫,可以使用參數(shù)忽略掉
pod install --no-repo-update
pod update --no-repo-update
2. 導(dǎo)入Swift類庫
導(dǎo)入Swift語言編寫的類庫時需要加use_frameworks!,下面以導(dǎo)入Alamofire為例:
platform :ios, '8.0'
use_frameworks!
pod 'Alamofire', '~> 1.3'
3. 官方文檔
對于Podfile參數(shù)細(xì)節(jié),可以查閱官網(wǎng),再此不做過多介紹。
http://guides.cocoapods.org/
本文首發(fā)于馬燕龍個人博客,歡迎分享,轉(zhuǎn)載請標(biāo)明出處。
馬燕龍個人博客:http://www.mayanlong.com
馬燕龍個人微博:http://weibo.com/imayanlong
馬燕龍Github主頁:https://github.com/yanlongma