cocoapods安裝、使用、工程配置--20170308

最近在使用cocoapods時,因為沒有很系統的了解,導致要頻繁的去網上查閱各種資料,結果很多資料都已經過時,或是使用后頻繁報錯,最終結果就是要踩很多的坑,費時費力。碰壁過后,決定把資源好好整合一下,查漏補缺。

首先,關于cocoapods是啥,為什么要使用?使用有什么好處,可以點擊查看這篇文章,里面說的很詳細:細聊 Cocoapods 與 Xcode 工程配置。我這就不啰嗦了。

CocoaPods 是用 gem ruby 實現的,要想使用它首先需要有 gem ruby 的環境。且 MAC 的 OS X系統默認已經可以運行 ruby 。但是當 gem ruby 包版本低于 2.2.2 時,安裝 CocoaPods 會報錯;為防止 gem ruby 包環境過低,建議先升級 gem ruby 環境,建議升級到 2.6.x 版本以上。(此步操作可以查看A-2步驟的其他指令)

故其先后步驟是:安裝RVM,再安裝ruby環境,再安裝cocoapods.


第一步,安裝cocoapods,安裝之前,首先需要安裝RVM和檢查ruby版本環境。(以下命令全在終端執行)

A-1安裝RVM:

a步驟、rvm -v ? ?//檢查當前 rvm 環境,若不存在,執行b步驟。若存在,直接跳至A-2.

b步驟、curl -L https://get.rvm.io | bash -s stable ? //安裝RVM環境

? ? ? ? ? ? ? source ~/.rvm/scripts/rvm? ? ? ? ? //載入RVM環境

c步驟、rvm -v? ? //再次檢查當前 rvm 環境。


A-2安裝ruby版本環境(用 rvm 安裝 ruby 環境;)

a步驟、? rvm list known ? ? ? ? ? ? ? ? //安裝ruby,查詢已知的 ruby 環境。?

b步驟、 rvm install 2.3.0? ? ? ? ? ? ? ? //指定 ruby 版本進行更新( 此處按照 ruby 2.3.0 版本進行更新 ---更新時在 ?安裝homebrew` 安裝依賴包)。

c步驟、rvm list? ? ? ? ? //查詢ruby是否已經安裝好的。

ruby其他相關指令:

rvm remove 1.9.2 ? ? ?//卸載一個已安裝版本:

sudo gem -v? ? ? ? //檢查 gemruby 版本號

sudo gem update --system? ? ? ? ? //更新 gemruby 版本號


A-3更換鏡像源(需要來修改更換源國內鏡像源,taobao源 (已經停止維護了)切換至ruby-china源

a步驟、gem sources -l ? ? ? ? //檢查 ruby源

b步驟、 gem sources --remove https://rubygems.org/ ? ? ?//移除 ruby源

c步驟、gem sources --add https://gems.ruby-china.org? ? //替換 ruby-china源

d步驟、gem sources -l ? ? ? ? //再次檢查此時的 ruby 源


A-4安裝CocoaPods.

a步驟、安裝 CocoaPods.(若安裝失敗,執行C步驟)

OS X 10.11之前系統的安裝 CocoaPods 指令: $ sudo gem install cocoa pods ??

OS X 10.11以后系統的安裝 CocoaPods 指令: $ sudo gem install -n /usr/local/bin cocoa pods

b步驟、下載過程中可新建一個終端,輸入命令 cd ~/.cocoapods進入終端,輸入命令du -sh *查看下載進度.

c步驟:(若a步驟安裝失敗,執行下列命令)

pod setup? ? ? ? ? ? ? ? ? //更新pod,

sudo gem update --system? ? ? ? ? //更新gem到最新版本

ping github.com? ? ? ? ? ? ? ? //檢查是否可以ping通github

pod repo list? ? ? ? ? ? ? //查看pob repo list

rm ~/Library/Caches/CocoaPods/search_index.json? ? ? //仍報錯則輸入

d步驟、通過搜索第三方框架,驗證是否安裝成功.

pod search 第三方庫


第二部,cocoapods使用。

第一步:打開終端,在終端輸入cd 按一下空格鍵, 然后把工程文件夾拖到終端內生成路徑。

第二步:在終端輸入ls,驗證打開路徑是否正確,對比一下文件夾目錄是否正確。

第三步:在終端輸入:vim Podfile? ,創建Podfile文件。

第四步:輸入i,進入編輯模式,輸入第三方庫相關一些信息。官方版文檔格式為(舉例):

platform :ios, '8.0'? ? ? ? ? ? //iOS版本

target '你的項目名稱' do? ? ? ? ? //項目名稱

pod 'AFNetworking', '~> 3.0' ? ? ? ? //舉例

end ? ? ? ? ? ? ? ?//完成

第五步:編輯完后,按下esc鍵,退出編輯模式。再輸如:wq,保存退出.

第六步:輸入pod install ,對你所需要的第三方進行下載。

第七步:由Cocoapods生成的 .xcworkspace文件來打開工程,而不是使用以前的.xcodeproj文件。

注意:當執行pod install之后,除了Podfile,還會生成一個名為Podfile.lock的文件,它會鎖定當前各依賴庫的版本,之后即使多次執行pod install也不會更改版本,只有執行pod update才會改變Podfile.lock.在多人協作的時候,這樣可以防止第三方庫升級時候造成大家各自的第三方庫版本不一致。所以在提交版本的時候不能把它落下,也不要添加到.gitignore中。

小竅門:

1、創建Podfile文件(在終端輸入:touch Podfile),此時Podfile文件就生成了。

2、在終端輸入: open -e Podfile),就可以在文本編輯器中對Podfile文件進行修改。

3、每次更改了Podfile文件,都需要重新執行一次pod update命令。

想詳細了解安裝流程的可以去看下這篇文章:2017最新安裝cocoapods流程


另外收集了一些針對錯誤、缺陷提供的解決辦法。

問題1:執行pod install還是pod update都卡在了Analyzing dependencies不動。

解決辦法:原因在于當執行以上兩個命令的時候會升級CocoaPods的spec倉庫,加一個參數可以省略這一步,然后速度就會提升不少。加參數的命令如下:? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? pod install --verbose --no-repo-update

pod update --verbose --no-repo-update

問題2:使用cocoaPods后,import導入時第三方庫頭文件沒有提示

解決辦法:看這里

問題3:待繼續補充。


最后,卸載cocoapods再重新安裝。

1、 sudo gem uninstall cocoapods

2、sudo gem uninstall cocoapods-core

3、sudo rm -fr ~/.cocoapods/repos/master? ? ? ? ? //清除cocoapods緩存

4、sudo gem install -n /usr/local/bin cocoapods --pre? ? //重裝cocoapods

以上,按照步驟來是比較速成的安裝方法,不會四處碰壁,至于想弄清其中緣由,那還得自己親身踩一下坑才會明白。我只是安裝自己容易接受的方式做了一次搬運工。


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

推薦閱讀更多精彩內容

  • CocoaPods 是什么? CocoaPods 是一個負責管理 iOS 項目中第三方開源庫的工具。CocoaPo...
    朝洋閱讀 25,732評論 3 51
  • 第一次安裝CocoaPods也遇到了一些坑,但是 那個時候時間比較緊,沒有抽出時間整理,最近因為電腦還原從新做了系...
    幸福的尾巴__閱讀 8,347評論 7 9
  • 2017年11月13號 新的一周新氣象,早上鬧鐘一響,你就起床幫爸爸做飯啦,真是一個好的開始。早餐...
    石憶鑫閱讀 282評論 0 1
  • 我們被“我知道”的想法占據著 填滿我們自以為是的頭腦 我們只是不敢放掉“我知道”的想法 因為在“我知道”的想法背后...
    彭章喜閱讀 137評論 0 1
  • 1.大學中需要計劃自己的時間。合理安排時間。讓大學生活變得充實。 2.technique 上了大學后才發現優秀的人...
    侯淑潔閱讀 211評論 3 0