快捷導(dǎo)航

2016 cocoapods的安裝和使用方法以及版本升級(jí)遇到的問題

更新時(shí)間：2016年09月30日 22:13:39 投稿：mdxy-dxy

CocoaPods是一個(gè)負(fù)責(zé)管理iOS項(xiàng)目中第三方開源庫的工具，通過CocoaPods，我們可以將第三方的依賴庫統(tǒng)一管理起來，配置和更新只需要通過簡單的幾行命令即可完成,需要的朋友可以參考下

一.CocoaPods是什么？

　　CocoaPods是一個(gè)負(fù)責(zé)管理iOS項(xiàng)目中第三方開源庫的工具。CocoaPods的項(xiàng)目源碼在Github上管理。該項(xiàng)目開始于2011年8月12日，在這兩年多的時(shí)間里，它持續(xù)保持活躍更新。開發(fā)iOS項(xiàng)目不可避免地要使用第三方開源庫，CocoaPods的出現(xiàn)使得我們可以節(jié)省設(shè)置和更新第三方開源庫的時(shí)間，在iOS開發(fā)中經(jīng)常會(huì)用到第三方庫如AFNetworking,ASIHttpRequest等，在使用第三方庫時(shí)，你除了要導(dǎo)數(shù)源碼外，但是，集成這些依賴庫需要我們手動(dòng)去配置，還有當(dāng)這些第三方庫發(fā)生了更新，還需要手動(dòng)去更新項(xiàng)目。這就顯得非常麻煩。有麻煩自然有解決辦法，CocoaPods就是為了解決這個(gè)問題而生的。通過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

但是，在終端中敲入這個(gè)命令之后，會(huì)發(fā)現(xiàn)半天沒有任何反應(yīng)。原因是那堵墻阻擋了cocoapods.org。

解決辦法是，我們可以用阿里云的Ruby鏡像來訪問cocoapods。按照下面的順序在終端中敲入依次敲入命令：

首先，檢查你的ruby源：

$gem sources -l

　　默認(rèn)情況下，終端應(yīng)該返回如下信息：

*** CURRENT SOURCES ***

https://rubygems.org/

　　當(dāng)然這個(gè)源在墻內(nèi)是訪問不到的。因此我們需要尋找一個(gè)可以在國內(nèi)訪問到的鏡像。目前筆者找到的是http://rubygems-china.oss.aliyuncs.com這個(gè)阿里云的鏡像，當(dāng)然隨著時(shí)間的推移，未來這個(gè)鏡像也有可能無法訪問了，到時(shí)候就只能重新尋找了。

　　確認(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

　　此時(shí)如果你再執(zhí)行g(shù)em sources -l命令，就能看到當(dāng)前鏡像源里只有阿里云這一個(gè)了。此時(shí)你就可以重新執(zhí)行這一段開頭的那句命令了：

$sudo gem install cocoapods

　　如果一切正常，你應(yīng)該能看到一段安裝進(jìn)度，以及最后有一條信息：

3 gems installed

　　確認(rèn)看見這條信息，后先判斷的CocoaPods是否可以使用，可以用CocoaPods的搜索功能驗(yàn)證一下。在終端中輸入：

pod search AFNetworking；

執(zhí)行后可能會(huì)一直停在

Setting up CocoaPods master repo然后(很久)會(huì)出現(xiàn)如下錯(cuò)誤：

解決辦法是：

這說明CocoaPods還不能正常使用，需要更新pod，下載它的一些依賴包；在終端中輸入：

$ pod setup

過一段時(shí)間之后，你會(huì)在終端中看到跟上面同樣的紅色的錯(cuò)誤信息。

這說明某些環(huán)境原因?qū)е聀od更新不了，可能原因有，1）gem版本太低；2）github無法鏈接；3）.cocoapods目錄下的配置信息錯(cuò)誤。我們可以一個(gè)一個(gè)來排除，

首先更新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，過一段時(shí)間后提示setup completed,在終端中輸入 pod list，展示出安裝列表；

這樣總算安裝好了。接下來再一次輸入：

pod search AFNetworking

輸入過后它可能會(huì)報(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)目文件的位置

　　然后，添加一個(gè)Podfile文件： vim Podfile

然后按i進(jìn)入插入模式，進(jìn)行編輯，在文件中輸入以下內(nèi)容：

注意百度上很多舊版本輸入的類容：

platform :ios, '8.1'
pod 'AFNetworking', '~> 2.0'
它會(huì)報(bào)：[!] The dependency `AFNetworking (~> 3.0)` is not used in any concrete target.
現(xiàn)在版本升級(jí)官方給的文檔是：

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保存并退出文件。此時(shí)可以發(fā)現(xiàn)在項(xiàng)目目錄下多了一個(gè)Podfile的文件，請(qǐng)注意這個(gè)文件必須與.xcodeproj在同一目錄下。

最后：

pod install

沒報(bào)錯(cuò)就可以了。

您可能感興趣的文章: