詳解2016 cocoapods的安裝和使用以及版本升級遇到的問題
一.CocoaPods是什么?
CocoaPods是一個負(fù)責(zé)管理iOS項(xiàng)目中第三方開源庫的工具。CocoaPods的項(xiàng)目源碼在Github上管理。該項(xiàng)目開始于2011年8月12日,在這兩年多的時間里,它持續(xù)保持活躍更新。開發(fā)iOS項(xiàng)目不可避免地要使用第三方開源庫,CocoaPods的出現(xiàn)使得我們可以節(jié)省設(shè)置和更新第三方開源庫的時間,在iOS開發(fā)中經(jīng)常會用到第三方庫如AFNetworking,ASIHttpRequest等,在使用第三方庫時,你除了要導(dǎo)數(shù)源碼外,但是,集成這些依賴庫需要我們手動去配置,還有當(dāng)這些第三方庫發(fā)生了更新,還需要手動去更新項(xiàng)目。這就顯得非常麻煩。有麻煩自然有解決辦法,CocoaPods就是為了解決這個問題而生的。通過CocoaPods,我們可以將第三方的依賴庫統(tǒng)一管理起來,配置和更新只需要通過簡單的幾行命令即可完成。
二.CocoaPods的下載及安裝
mac系統(tǒng)已經(jīng)默認(rèn)安裝好Ruby環(huán)境,如果你不確定自己系統(tǒng)中是否有Ruby的,可以在終端中輸入命令行:ruby -v查看當(dāng)前ruby版本。如圖:
確定以后,接下來就可以下載和安裝CocoaPods,只需要一行命令。在Terminator(也就是終端)中輸入以下命令:
sudo gem install cocoapods
但是,在終端中敲入這個命令之后,會發(fā)現(xiàn)半天沒有任何反應(yīng)。原因是那堵墻阻擋了cocoapods.org。
解決辦法是,我們可以用阿里云的Ruby鏡像來訪問cocoapods。按照下面的順序在終端中敲入依次敲入命令:
首先,檢查你的ruby源:
$gem sources -l
默認(rèn)情況下,終端應(yīng)該返回如下信息:
*** CURRENT SOURCES *** https://rubygems.org/
當(dāng)然這個源在墻內(nèi)是訪問不到的。因此我們需要尋找一個可以在國內(nèi)訪問到的鏡像。目前筆者找到的是http://rubygems-china.oss.aliyuncs.com這個阿里云的鏡像,當(dāng)然隨著時間的推移,未來這個鏡像也有可能無法訪問了,到時候就只能重新尋找了。
確認(rèn)鏡像可用后,現(xiàn)在就要開始修改ruby源了。首先執(zhí)行以下命令刪除原來的ruby源:
$gem sources --remove https://rubygems.org/
執(zhí)行命令后可在終端看見以下信息:
https://rubygems.org/ removed from sources
然后下一步添加你找到的可用的鏡像源:
$gem sources -a http://rubygems-china.oss.aliyuncs.com
此時如果你再執(zhí)行g(shù)em sources -l命令,就能看到當(dāng)前鏡像源里只有阿里云這一個了。此時你就可以重新執(zhí)行這一段開頭的那句命令了:
$sudo gem install cocoapods
如果一切正常,你應(yīng)該能看到一段安裝進(jìn)度,以及最后有一條信息:
3 gems installed
確認(rèn)看見這條信息,后先判斷的CocoaPods是否可以使用,可以用CocoaPods的搜索功能驗(yàn)證一下。在終端中輸入:
pod search AFNetworking;
執(zhí)行后可能會一直停在
Setting up CocoaPods master repo然后(很久)會出現(xiàn)如下錯誤:
解決辦法是:
這說明CocoaPods還不能正常使用,需要更新pod,下載它的一些依賴包;在終端中輸入:
$ pod setup
過一段時間之后,你會在終端中看到跟上面同樣的紅色的錯誤信息。
這說明某些環(huán)境原因?qū)е聀od更新不了,可能原因有,1)gem版本太低;2)github無法鏈接;3).cocoapods目錄下的配置信息錯誤。我們可以一個一個來排除,
首先更新gem到最新版本,在終端中輸入:
$ sudo gem update --system
然后檢查是否可以ping通github,在終端中輸入:
$ ping github.com
然后查看pob repo list:
$ pod repo list
說明Cocoapods在將它的信息下載到 ~/.cocoapods里;
cd 到該目錄里,用du -sh *命令來查看文件大小,結(jié)果顯示0 repos,說明沒有安裝成功;
在終端輸入:
cd ~/.cocoapods
進(jìn)入cocoapods文件后在終端輸入:
du -sh *
重新執(zhí)行pod setup,過一段時間后提示setup completed,在終端中輸入 pod list,展示出安裝列表;
這樣總算安裝好了。接下來再一次輸入:
pod search AFNetworking
輸入過后它可能會報(bào):
[!] Unable to find a pod with name, author, summary, or descriptionmatching `AFNetworking`
解決方案是:
輸入:
rm ~/Library/Caches/CocoaPods/search_index.json
后在一次輸入:pod search AFNetworking
就可以咯。
三,cocoapods的使用
首先來到你的項(xiàng)目文件:
cd 項(xiàng)目文件的位置
然后,添加一個Podfile文件: vim Podfile
然后按i進(jìn)入插入模式,進(jìn)行編輯,在文件中輸入以下內(nèi)容:
注意百度上很多舊版本輸入的類容:
platform :ios, '8.1'
pod 'AFNetworking', '~> 2.0'
它會報(bào):[!] The dependency `AFNetworking (~> 3.0)` is not used in any concrete target.
現(xiàn)在版本升級官方給的文檔是:
platform :ios, '8.0'
target '你的項(xiàng)目名稱' do
pod 'AFNetworking', '~> 3.0'
end
注意:'你的項(xiàng)目名稱'是你項(xiàng)目文件中'xx.xcodeproj'文件,'xx.xcodeproj'去掉后綴名所得的‘xx'==(就是)‘你的項(xiàng)目名稱'
輸入完成后按ESC退出編輯模式,最后輸入:wq保存并退出文件。此時可以發(fā)現(xiàn)在項(xiàng)目目錄下多了一個Podfile的文件,請注意這個文件必須與.xcodeproj在同一目錄下。
最后:
pod install
沒報(bào)錯就可以了。
以上就是本文的全部內(nèi)容,希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
IOS UI學(xué)習(xí)教程之區(qū)分NSBundle和NSURL(讀取文件、寫入文件)
這篇文章主要為大家詳細(xì)介紹了IOS UI學(xué)習(xí)教程之區(qū)分NSBundle和NSURL,如何讀取、寫入文件,感興趣的小伙伴們可以參考一下2016-03-03iOS中使用NSURLConnection處理HTTP同步與異步請求
NSURLConnection的作用現(xiàn)在已經(jīng)基本被NSURLSession所取代,所以我們簡單了解下iOS中使用NSURLConnection處理HTTP同步與異步請求的方法即可:2016-07-07