一、CocoaPods的作用
??在iOS開發(fā)中勢(shì)必會(huì)用到一些第三方依賴庫(kù),比如大家都熟悉的ASIHttpRequest桩盲、AFNetworking、JSONKit等席吴。使用這些第三方類庫(kù)能極大的方便項(xiàng)目的開發(fā)赌结,但是,集成這些依賴庫(kù)需要我們手動(dòng)去配置抢腐,例如集成ASIHttpRequest庫(kù)時(shí)除了加入源碼以外還需要手動(dòng)去添加一些系統(tǒng)的framework姑曙,CFNetwork、MobileCoreServices等迈倍,如果這些第三方庫(kù)發(fā)生了更新伤靠,還需要手動(dòng)去更新項(xiàng)目。這就顯得非常麻煩。有麻煩自然有解決辦法宴合,CocoaPods就是為了解決這個(gè)問(wèn)題而生的焕梅。通過(guò)CocoaPods,我們可以將第三方的依賴庫(kù)統(tǒng)一管理起來(lái)卦洽,配置和更新只需要通過(guò)簡(jiǎn)單的幾行命令即可完成贞言,大大的提高了實(shí)際開發(fā)中的工作效率,使我們的主要精力集中到更重要的事情上去阀蒂。
二该窗、CocoaPods的安裝
1. 配置ruby環(huán)境
Mac打開終端,移除原有鏡像:$ gem sources -r https://rubygems.org/
安裝基于騰訊云的鏡像:$ gem sources -a https://gems.ruby-china.org/
查看鏡像:$ gem sources -l
蚤霞,確保只有 gems.ruby-china.org
若上面鏡像被墻酗失,請(qǐng)使用2019年最新國(guó)內(nèi)鏡像:
gem source -a https://rubygems.org/
2.Mac上更新Ruby
安裝CocoaPods,需要Ruby版本在 2.2.2 以上昧绣,這里使用RVM對(duì)Ruby進(jìn)行升級(jí):
(1)安裝 RVM
RVM (Ruby Version Manager)规肴,即Ruby版本管理器,包括Ruby的版本管理和Gem庫(kù)管理夜畴。按照下面的命令安裝 RVM拖刃,需等待一段時(shí)間,務(wù)必保持網(wǎng)絡(luò)穩(wěn)定:
$ curl -L get.rvm.io | bash -s stable
$ source ~/.bashrc
$ source ~/.bash_profile
若提示-bash: /Users/Xiao/.bash_profile: No such file or directory找不到 .bash_profile 文件贪绘,直接在根目錄創(chuàng)建一個(gè)即可:
$ cd ~
$ touch .bash_profile
安裝成功后兑牡,可查看rvm版本:$ rvm -v
(2)用RVM升級(jí)Ruby
查看當(dāng)前ruby版本:$ ruby -v
列出已知的ruby版本:$ rvm list known
安裝xcode command line:$ xcode-select --install
選擇要安裝的版本,如安裝ruby 2.4.0:$ rvm install 2.4.0
3. 安裝CocoaPods并更新gem
(1)$ sudo gem install -n /usr/local/bin cocoapods
(2)$ pod setup
(3)$ sudo gem update --system
安裝pod過(guò)程需等待一段時(shí)間税灌,務(wù)必保持網(wǎng)絡(luò)穩(wěn)定发绢!安裝完成后,在終端輸入:$ pod
垄琐,若顯示下面的信息就表示CocoaPods安裝成功了。
輸入:$ pod --version
和 $ gem -v
经柴,可查看 pod 和 gem 版本
三狸窘、CocoaPods的使用
1. 新建并編輯Podfile文件
在終端切換路徑到工程文件夾,輸入命令:$ touch Podfile
在工程目錄下新建Podfile文件坯认,注意此文件無(wú)擴(kuò)展名翻擒。
在工程文件夾中雙擊打開Podfile文件,編輯內(nèi)容如下
注意文件中的ios要小寫牛哺,標(biāo)點(diǎn)符號(hào)是英文格式陋气,為避免手打?qū)戝e(cuò)格式,可在終端使用 $ pod search AFNetworking
命令搜索出這個(gè)第三方庫(kù)引润,復(fù)制系統(tǒng)的語(yǔ)句巩趁,按 q 鍵退出搜索界面。pod 'AFNetworking', '~> 3.1.0' 這種寫法表示使用3.1.0版本的庫(kù)淳附,若不寫版本號(hào)表示使用當(dāng)下最新版本议慰。
2. 安裝所需的第三方庫(kù)
終端輸入命令:$ pod install
若被墻卡住蠢古,可嘗試命令: $ pod install --verbose --no-repo-update
若看到下面的內(nèi)容信息,表示成功安裝好了Podfile文件里的第三方庫(kù)别凹。
此時(shí)查看工程目錄多了4個(gè)東西草讶,Pods文件夾存放你下載的第三方庫(kù)。以后打開工程不再是使用xcodeproj炉菲,而是使用xcworkspace堕战。打開workspace工作空間,發(fā)現(xiàn)里面包含兩個(gè)xcodeproj工程文件拍霜,一個(gè)是本身的工程嘱丢,一個(gè)是Pods管理第三方庫(kù)的工程。
3. 導(dǎo)入頭文件的相關(guān)配置
如果引入的第三方庫(kù)后找不到頭文件沉御,在項(xiàng)目中Build Settings—>User Header Search Paths中添加:$(SRCROOT)屿讽,右面值為recursive。(這一步驟只需要配置一次吠裆,以后再導(dǎo)入新的第三方庫(kù)都不需要配置了)
小結(jié):
(1)Podfile文件控制CocoaPods該下載什么伐谈,文件名一定叫做Podfile且沒(méi)有后綴;
(2)切換到工程目錄试疙,輸入命令:$pod update
诵棵,可更新所有配置好的第三方庫(kù);
(3)若后續(xù)要添加新的第三方庫(kù)祝旷,則在Podfile文件履澳,添加新的第三方庫(kù)代碼,如:$pod 'SDWebImage'
怀跛,然后在終端切換到工程目錄距贷,輸入 $ pod update
即可。同理想要?jiǎng)h除某個(gè)第三方庫(kù)吻谋,只需在Podfile文件里把對(duì)應(yīng)的第三方庫(kù)那行代碼刪除忠蝗,然后在終端切換到工程目錄,執(zhí)行 $ pod update
即可漓拾。
四阁最、常見問(wèn)題
Mac OS 10.11之后, cocoapods的一些命令需要進(jìn)行變化。若遇到 pod setup 或pod update 出現(xiàn)問(wèn)題骇两,而且很難解決速种,建議直接卸載重裝:
- 卸載cocoapods:
$ sudo gem uninstall cocoapods
- 重裝cocoapods:
10.11之前:$ sudo gem install cocoapods
10.11之后:$ sudo gem install -n /usr/local/bin cocoa pods
常見報(bào)錯(cuò)問(wèn)題及解決方法參考鏈接:
http://www.reibang.com/p/6d8604f0b94c