CocoaPods安裝和使用教程

CocoaPods是什么?

當(dāng)你開(kāi)發(fā)iOS應(yīng)用時(shí),會(huì)經(jīng)常使用到很多第三方開(kāi)源類(lèi)庫(kù),比如JSONKit,AFNetWorking等等??赡苣硞€(gè)類(lèi)庫(kù)又用到其他類(lèi)庫(kù),所以要使用它,必須得另外下載其他類(lèi)庫(kù),而其他類(lèi)庫(kù)又用到其他類(lèi)庫(kù),“子子孫孫無(wú)窮盡也”,這也許是比較特殊的情況??傊【幍囊馑季褪?,手動(dòng)一個(gè)個(gè)去下載所需類(lèi)庫(kù)十分麻煩。另外一種常見(jiàn)情況是,你項(xiàng)目中用到的類(lèi)庫(kù)有更新,你必須得重新下載新版本,重新加入到項(xiàng)目中,十分麻煩。如果能有什么工具能解決這些惱人的問(wèn)題,那將“善莫大焉”。所以,你需要 CocoaPods。

CocoaPods應(yīng)該是iOS最常用最有名的類(lèi)庫(kù)管理工具了,上述兩個(gè)煩人的問(wèn)題,通過(guò)cocoaPods,只需要一行命令就可以完全解決,當(dāng)然前提是你必須正確設(shè)置它。重要的是,絕大部分有名的開(kāi)源類(lèi)庫(kù),都支持CocoaPods。所以,作為iOS程序員的我們,掌握CocoaPods的使用是必不可少的基本技能了。

如何下載和安裝CocoaPods?

在安裝CocoaPods之前,首先要在本地安裝好Ruby環(huán)境。至于如何在Mac中安裝好Ruby環(huán)境,請(qǐng)google一下,本文不再涉及。

假如你在本地已經(jīng)安裝好Ruby環(huán)境,那么下載和安裝CocoaPods將十分簡(jiǎn)單,只需要一行命令。在Terminator(也就是終端)中輸入以下命令(注意,本文所有命令都是在終端中輸入并運(yùn)行的。什么,你不知道什么是終端?那請(qǐng)小編吃飯,小編告訴你):

sudo gem install cocoa pods

但是,且慢。如果你在天朝,在終端中敲入這個(gè)命令之后,會(huì)發(fā)現(xiàn)半天沒(méi)有任何反應(yīng)。原因無(wú)他,因?yàn)槟嵌聣ψ钃趿薱ocoapods.org。(你會(huì)問(wèn),我靠,這都要墻!是的,小編也納悶。)

但是,是的,又但是(不過(guò)是個(gè)可喜的“但是”)。我們可以用淘寶的Ruby鏡像來(lái)訪問(wèn)cocoapods。按照下面的順序在終端中敲入依次敲入命令:

$ gem sources --remove https://rubygems.org/

//等有反應(yīng)之后再敲入以下命令(淘寶鏡像已換成https協(xié)議)

$ gem sources -a https://ruby.taobao.org/

為了驗(yàn)證你的Ruby鏡像是并且僅是taobao,可以用以下命令查看:

$ gem sources -l

只有在終端中出現(xiàn)下面文字才表明你上面的命令是成功的:

*** CURRENT SOURCES ***

http://ruby.taobao.org/

這時(shí)候,你再次在終端中運(yùn)行:

$ sudo gem install cocoapods

等上十幾秒鐘,CocoaPods就可以在你本地下載并且安裝好了,不再需要其他設(shè)置。

看到這里,你心里會(huì)不會(huì)說(shuō),我靠!太爽了,這么容易就可以下載并且安裝好了!是的,小編也是這么想的。CocoPods就是這么簡(jiǎn)單,使用也十分簡(jiǎn)單。繼續(xù)往下看吧。

如何使用CocoaPods?

好了,安裝好CocoPods之后,接下來(lái)就是使用它。所幸,使用CocoPods和安裝它一樣簡(jiǎn)單,也是通過(guò)一兩行命令就可以搞定。

小編在這里用兩種使用場(chǎng)景來(lái)具體說(shuō)明如何使用CocoaPods。

場(chǎng)景1:利用CocoaPods,在項(xiàng)目中導(dǎo)入AFNetworking類(lèi)庫(kù)

AFNetworking類(lèi)庫(kù)在GitHub地址是:https://github.com/AFNetworking/AFNetworking

為了確定AFNetworking是否支持CocoaPods,可以用CocoaPods的搜索功能驗(yàn)證一下。在終端中輸入:

$ pod search AFNetworking

你看到這里也許會(huì)問(wèn),CocoaPods為什么能下載AFNetworking呢,而不是下載其他類(lèi)庫(kù)呢?這個(gè)問(wèn)題的答案是,有個(gè)文件來(lái)控制CocoaPods該下載什么。這個(gè)文件就叫做“Podfile”(注意,一定得是這個(gè)文件名,而且沒(méi)有后綴)。你創(chuàng)建一個(gè)Podfile文件,然后在里面添加你需要下載的類(lèi)庫(kù),也就是告訴CocoaPods,“某某和某某和某某某,快到碗里來(lái)!”。每個(gè)項(xiàng)目只需要一個(gè)Podfile文件。

好吧,廢話(huà)少說(shuō),我們先創(chuàng)建這個(gè)神奇的PodFile。在終端中進(jìn)入(cd命令)你項(xiàng)目所在目錄,然后在當(dāng)前目錄下,利用vim創(chuàng)建Podfile,運(yùn)行:

$ vim podfile

然后在Podfile文件中輸入以下文字:

platform :ios, '7.0'

pod "AFNetworking", "~> 2.0"

注意,這段文字不是小編憑空生成的,可以在AFNetworking的github頁(yè)面找到。這兩句文字的意思是,當(dāng)前AFNetworking支持的iOS最高版本是iOS 7.0, 要下載的AFNetworking版本是2.0。

然后保存退出。vim環(huán)境下,保存退出命令是:

:wq

這時(shí)候,你會(huì)發(fā)現(xiàn)你的項(xiàng)目目錄中,出現(xiàn)一個(gè)名字為Podfile的文件,而且文件內(nèi)容就是你剛剛輸入的內(nèi)容。注意,Podfile文件應(yīng)該和你的工程文件.xcodeproj在同一個(gè)目錄下。

這時(shí)候,你就可以利用CocoPods下載AFNetworking類(lèi)庫(kù)了。還是在終端中的當(dāng)前項(xiàng)目目錄下,運(yùn)行以下命令:

$ pod install

因?yàn)槭窃谀愕捻?xiàng)目中導(dǎo)入AFNetworking,這就是為什么這個(gè)命令需要你進(jìn)入你的項(xiàng)目所在目錄中運(yùn)行。

運(yùn)行上述命令之后,小編的終端出現(xiàn)以下信息:

EricmatoMacBook-Pro:CocoaPodsDemo ericwang$ pod install

Analyzing dependencies

Downloading dependencies

Installing AFNetworking (2.0.2)

Generating Pods project

Integrating client project

[!] From now on use `CocoaPodsDemo.xcworkspace`.

注意最后一句話(huà),意思是:以后打開(kāi)項(xiàng)目就用 CocoaPodsDemo.xcworkspace 打開(kāi),而不是之前的.xcodeproj文件。

現(xiàn)在,你就可以開(kāi)始使用AFNetworking.h啦??梢陨晕y(cè)試一下,在你的項(xiàng)目任意代碼文件中輸入:

#import <AFNetworking>

然后編譯,看看是否出錯(cuò)。如果你嚴(yán)格按照小編上述的步驟來(lái),是不可能出錯(cuò)的啦。

至此,CocoPods的第一個(gè)應(yīng)用場(chǎng)景講述完畢。別看小編寫(xiě)了這么多,其實(shí)過(guò)程是十分簡(jiǎn)單的??偨Y(jié)一下就是:

先在項(xiàng)目中創(chuàng)建Podfile,Podfile的內(nèi)容是你想導(dǎo)入的類(lèi)庫(kù)。一般類(lèi)庫(kù)的原作者會(huì)告訴你導(dǎo)入該類(lèi)庫(kù)應(yīng)該如何寫(xiě)Podfile;

運(yùn)行命令:`$ pod install.

下面,小編繼續(xù)講述第二種使用場(chǎng)景。

場(chǎng)景2:如何正確編譯運(yùn)行一個(gè)包含CocoPods類(lèi)庫(kù)的項(xiàng)目

你也許曾經(jīng)遇到過(guò)(特別是新手iOS開(kāi)發(fā)者)這種情況,好不容易在GitHub上找到一份代碼符合自己想需求,興沖沖下載下來(lái),一編譯,傻眼了,發(fā)現(xiàn)有各種各樣錯(cuò)誤。一看,原來(lái)是缺失了各種其他第三方類(lèi)庫(kù)。這時(shí)候莫慌,你再仔細(xì)一看,會(huì)發(fā)現(xiàn)你下載的代碼包含了Podfile。沒(méi)錯(cuò),這意味著你可以用CocoaPods很方便下載所需要的類(lèi)庫(kù)。

下面,小編以代碼 UAAppReviewManager 為例來(lái)說(shuō)明如何正確編譯運(yùn)行一個(gè)包含CocoPods類(lèi)庫(kù)的項(xiàng)目。

UAAppReviewManager是一個(gè)能夠讓你方便地將提醒用戶(hù)評(píng)分的功能加入你的應(yīng)用中。當(dāng)你去UAAppReviewManager的GitHub地址下載這份代碼之后,打開(kāi)Example工程(UAAppReviewManagerExample),編譯,你會(huì)發(fā)現(xiàn)Xcode報(bào)告一大堆錯(cuò)誤,基本都是說(shuō)你編譯的這份代碼找不到某某頭文件,這就意味著你要成功編譯UAAppReviewManager的Example代碼,必須先導(dǎo)入一些第三方類(lèi)庫(kù)。

這時(shí)候,打開(kāi)終端,進(jìn)入U(xiǎn)AAppReviewManagerExample所在的目錄,也就是和Podfile在同一目錄下,和場(chǎng)景1一樣,輸入以下命令(由于已經(jīng)有Podfile,所以不需要再創(chuàng)建Podfile):

$ pod update

過(guò)幾秒(也許需要十幾秒,取決于你的網(wǎng)絡(luò)狀況)之后,終端出現(xiàn):

Analyzing dependencies

Fetching podspec for `UAAppReviewManager` from `../`

Downloading dependencies

Installing UAAppReviewManager (0.1.6)

Generating Pods project

Integrating client project

[!] From now on use `UAAppReviewManagerExample.xcworkspace`.

這時(shí)候,再回到UAAppReviewManagerExample文件夾看一看,會(huì)看到多了一個(gè)文件UAAppReviewManagerExample.xcworkspace

根據(jù)終端的信息提示,你以后就需用新產(chǎn)生的UAAppReviewManagerExample.xcworkspace來(lái)運(yùn)行這個(gè)Example代碼了。

打開(kāi)UAAppReviewManagerExample.xcworkspace,編譯運(yùn)行,成功!

注意,這里有個(gè)小問(wèn)題,如果剛剛你不是輸入$ pod update,而是輸入$ pod install,會(huì)發(fā)現(xiàn)類(lèi)庫(kù)導(dǎo)入不成功,并且終端出現(xiàn)下面提示:

[!] Required version (UAAppReviewManager (from `../`)) not found for `UAAppReviewManager`.

Available versions: 0.1.6

這里的意思大概是Podfile文件過(guò)期,類(lèi)庫(kù)有升級(jí),但是Podfile沒(méi)有更改。$ pod install只會(huì)按照Podfile的要求來(lái)請(qǐng)求類(lèi)庫(kù),如果類(lèi)庫(kù)版本號(hào)有變化,那么將獲取失敗。但是 $ pod update會(huì)更新所有的類(lèi)庫(kù),獲取最新版本的類(lèi)庫(kù)。而且你會(huì)發(fā)現(xiàn),如果用了 $ pod update,再用 $ pod install 就成功了。

那你也許會(huì)問(wèn),什么時(shí)候用 $ pod install,什么時(shí)候用 $ pod update 呢,我又不知道類(lèi)庫(kù)有沒(méi)有新版本。好吧,那你每次直接用 $ pod update 算了?;蛘呦扔?$ pod install,如果不行,再用 $ pod update。

轉(zhuǎn)載:http://code4app.com/article/cocoapods-install-usage

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書(shū)系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

  • CocoaPods安裝和使用教程 Code4App 原創(chuàng)文章。轉(zhuǎn)載請(qǐng)注明出處:http://code4app.co...
    幻世神碼閱讀 255評(píng)論 0 0
  • 一 母親告訴我,阿芳回家了。 回哪里去?為什么回去? 可能回XX吧?她老公死了…… 她能認(rèn)得回家的路嗎? 不知道。...
    蠡殼閱讀 890評(píng)論 0 1
  • 關(guān)系數(shù)據(jù)庫(kù) MySql Orcal 表結(jié)構(gòu)固定,修改麻煩 非關(guān)系數(shù)據(jù)庫(kù) 靈活改變,存儲(chǔ)json數(shù)據(jù) MongoDB...
    我_巨可愛(ài)閱讀 466評(píng)論 0 0

友情鏈接更多精彩內(nèi)容