iOS開發(fā) - CocoaPods安裝和使用教程

一、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)建完畢的目錄如下圖:


創(chuàng)建Podfile文件后的工程目錄結(jié)構(gòu)

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):


CocoaPods_03.png

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

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 229,619評論 6 539
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 99,155評論 3 425
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 177,635評論 0 382
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經(jīng)常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,539評論 1 316
  • 正文 為了忘掉前任,我火速辦了婚禮,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 72,255評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 55,646評論 1 326
  • 那天,我揣著相機(jī)與錄音,去河邊找鬼。 笑死,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,655評論 3 444
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 42,838評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 49,399評論 1 335
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 41,146評論 3 356
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 43,338評論 1 372
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,893評論 5 363
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 44,565評論 3 348
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,983評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,257評論 1 292
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,059評論 3 397
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 48,296評論 2 376

推薦閱讀更多精彩內(nèi)容

  • CocoaPods 是什么? CocoaPods 是一個負(fù)責(zé)管理 iOS 項目中第三方開源庫的工具。CocoaPo...
    朝洋閱讀 25,735評論 3 51
  • 沉浮于這凡塵間 一顆零落的心 只愿覓一處歸所 以為是你 希望是你 卻不知 在這心心念念間 已蕩起萬千愁緒
    木漠然閱讀 140評論 0 2
  • 今夜細(xì)雨茫茫今夜任由思念萬千穿越夜色蒼蒼水云深處通向天堂花園門口依偎在你的身旁 往事一半隨風(fēng)飛舞一半雨中蕩漾唇齒間...
    隨意詩社閱讀 224評論 2 6
  • 迎著朝陽我們又開始了社會實(shí)踐第五天的活動,經(jīng)歷了前四天豐 富而有趣的活動,大家的默契與配合度都得到了很大的提升。
    emmmmmm哦閱讀 201評論 0 0
  • 隨著現(xiàn)代信息化、科技化的時代的到來,我們的生活會出現(xiàn)各種各樣新奇的事和物。作為學(xué)生的我們,當(dāng)然會對這些新奇的事物產(chǎn)...
    啊梵緹bernice閱讀 306評論 0 0