CocoaPods天天用木西,但是不會天天安裝畴栖,所以在此記錄一下安裝步驟。本文比較詳細(xì)的記錄了最新的安裝過程八千,僅供參考吗讶。第一步可以省略,直接第二步開始就行恋捆。出現(xiàn)問題了再照著第一步來照皆。我參考的一些文章也會附在文章末尾,感謝各位作者沸停。
第一步:升級MacOS自帶的Ruby(新系統(tǒng)可不升級膜毁,直接第二步)
1. 安裝Xcode Command Line Tools
xcode-select --install
如果已經(jīng)安裝了,會報錯愤钾,顯示already installed瘟滨。
2. 安裝RVM,用來升級Ruby
RVM: Ruby Version Manager.中文為Ruby版本管理器绰垂,包括Ruby的版本管理和Gem庫管理
curl -L get.rvm.io | bash -s stable
驗(yàn)證RVM是否安裝成功: 關(guān)閉當(dāng)前命令窗口室奏,打開一個新的窗口(加載安裝好的文件)火焰,查看版本劲装,如果有版本號,就是安裝好了
rvm -v
3.安裝Homebrew
一個MacOS的套件昌简,安裝過程中需要輸入一次回車鍵和驗(yàn)證系統(tǒng)登錄用戶密碼占业。
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
4.查看當(dāng)前ruby版本,獲取rvm列表
會顯示當(dāng)前已經(jīng)安裝的版本號纯赎,MacOS默認(rèn)已經(jīng)安裝了一個
ruby -v
獲取rvm列表谦疾,列表里會顯示最新版Ruby版本
rvm list known
5.安裝最新版Ruby
根據(jù)rvm列表里# MRI Rubies一欄里顯示的的Ruby版本號,比如要安裝最新的2.4版本犬金,命令如下:
rvm install 2.4
安裝過程中會自動查找和下載依賴包念恍,根據(jù)不同的網(wǎng)速,可能需要的時間較長晚顷。如果下載失敗了峰伙,可以多試幾次或者開VPN試試。
附1: 卸載Ruby的方法
Ruby可以同時安裝和存在多個不同的版本该默,如果你有多個版本瞳氓,或者安裝了錯誤版本,要刪除一個栓袖,命令如下:
獲取版本列表
rvm list
卸載其中一個版本匣摘,注意不要寫錯版本號
rvm remove 2.4
附2: 可能出現(xiàn)的問題
Error running '__rvm_make -j 1',showing last 15 lines of /Users/GDarkness/.rvm/log/1474100434_ruby-2.2.4/make.log
安裝xcode command line 即可解決
xcode-select --install
第二步:升級RubyGems版本和更改gem源
1.升級RubyGems版本
輸入下面命令店诗,系統(tǒng)會讓你輸入登錄用戶密碼。如果已經(jīng)是最新版了音榜,就會提示已經(jīng)最新庞瘸,并自動忽略更新
sudo gem update --system
查看一下gem版本,要2.6以上才可以囊咏,現(xiàn)在是2.7.8恕洲。
gem -v
2.更改gem源
淘寶的gem源已經(jīng)不維護(hù)了,現(xiàn)在是官方論壇在維護(hù)梅割,地址https://gems.ruby-china.com/霜第,先看一下當(dāng)前的gem源
gem sources -l
如果你沒有改過源的話,默認(rèn)應(yīng)該是https://rubygems.org/户辞,你只需輸入下面一個命令就可以了
gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
如果你已經(jīng)改過了泌类,比如改成了淘寶的網(wǎng)址了,那你把修改后的地址替換上面的命令里的“https://rubygems.org”字段底燎,然后回車即可刃榨。
重新看一下gem源,確保只有一個双仍,https://gems.ruby-china.com/枢希。
gem sources -l
第三步:安裝CocoaPods
1.安裝CocoaPods
很多同學(xué)都是直接從這一步開始的,一般也沒啥問題朱沃,如果有啥問題苞轿,重復(fù)上面兩步試試。
sudo gem install cocoapods
驗(yàn)證是否安裝成功逗物。如果出現(xiàn)版本號搬卒,比如1.5.3,那就是安裝成功了翎卓。如果出現(xiàn)ERROR: While executing gem ... (Gem::FilePermissionError)
You don't have write permissions for the /usr/bin directory.那你從第一步開始吧契邀,可能是系統(tǒng)自帶的ruby權(quán)限不夠,沒仔細(xì)研究失暴。
pod --version
如果沒有出現(xiàn)版本號或安裝不成功坯门,試試這個命令:
sudo gem install -n /usr/local/bin cocoapods
2.克隆specs
這一步會從github上clone specs內(nèi)容,現(xiàn)在大約600M逗扒,根據(jù)網(wǎng)速不同古戴,可能下載需要很久。地址:https://github.com/CocoaPods/Specs
注意這個下載貌似不能斷點(diǎn)續(xù)傳缴阎,所以你要是去吃飯或者離開電腦的時候注意把系統(tǒng)偏好設(shè)置里的節(jié)能關(guān)掉允瞧,否則睡眠了,斷網(wǎng)了,可能會卡住不動述暂,如果這樣痹升,則關(guān)閉命令行工具,重新輸入命令開始即可畦韭。最新版Pod有下載進(jìn)度可以看疼蛾。
pod setup
如果出現(xiàn)綠色的Setup completed提示,說明CocoaPods已經(jīng)安裝并克隆specs成功了艺配。
在本機(jī)的路徑是/Users/你的用戶名/.cocoapods/repos/master
附:MacOS 顯示或隱藏所有文件
第一種察郁,臨時顯示,使用快捷鍵Shift + Command + > (句號鍵)转唉,三個按鍵同時按皮钠。
第二種,命令行赠法,如下
defaults write com.apple.finder AppleShowAllFiles Yes && killall Finder //顯示隱藏文件
defaults write com.apple.finder AppleShowAllFiles No && killall Finder //不顯示隱藏文件
3.導(dǎo)入第三方庫
cd 項(xiàng)目文件夾
進(jìn)入項(xiàng)目文件夾后麦轰,如果已經(jīng)有了Podfile,并在同一文件夾路徑下砖织,執(zhí)行導(dǎo)入命令即可
pod install
如果是全新項(xiàng)目款侵,那么初始化pod并創(chuàng)建Podfile文件,命令行如下:
pod init
用文本編輯器打開Podfile侧纯,在"do ... end"之間輸入所需第三方框架名和版本號新锈,格式如下,
target 'RAC' do
# Uncomment the next line if you're using Swift or would like to use dynamic frameworks
# use_frameworks!
# Pods for RAC
pod 'ReactiveObjC', '~> 3.1.0'
end
然后重新執(zhí)行pod install眶熬,完成后妹笆,用后綴名為.xcworkspace重新打開項(xiàng)目即可。
4.關(guān)于pod install和pod update的用法區(qū)別
簡單區(qū)別如下聋涨,詳細(xì)區(qū)別見官網(wǎng)文檔http://guides.cocoapods.org/using/pod-install-vs-update.html
1.pod install:這個是將本地已經(jīng)緩存的(也就是已經(jīng)pod setup過的)第三方庫直接安裝晾浴,如果本地有第三方庫负乡,就安裝牍白,不會管庫的版本,也不去網(wǎng)絡(luò)下載抖棘,如果本地沒有茂腥,那么就去網(wǎng)絡(luò)下載一個,然后緩存到本地切省;
2.“pod update”:這個命令會直接跳本地緩存的第三方庫最岗,直接從網(wǎng)絡(luò)上下載最新的。
3.“pod update --no-repo-update”:帶參數(shù)更新朝捆,若添加后僅從本地Cocoapods庫中查找SDK般渡,不再更新線上SDK。如果本地存在SDK會直接使用本地SDK版本(不是線上最新版本),若本地不存在SDK會產(chǎn)生錯誤驯用。
4.這兩命令第一次執(zhí)行時都會更新本地的庫脸秽。
附1: 可能遇到的問題:
執(zhí)行pod setup命令后可能出現(xiàn)以下錯誤提示,原因是從github下載specs庫的時候網(wǎng)絡(luò)出現(xiàn)了問題蝴乔,比如電腦休眠了记餐,斷網(wǎng)了,或者連接到github不穩(wěn)定薇正,都可能導(dǎo)致這個問題片酝,解決辦法就是多試幾遍pod setup命令
[!] /usr/bin/git clone https://github.com/CocoaPods/Specs.git master --progress
Cloning into 'master'...
remote: Counting objects: 1113291, done.
remote: Compressing objects: 100% (191/191), done.
error: RPC failed; curl 56 SSLRead() return error -980617.00 KiB/s
fatal: The remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed
附2: 參考文章:
這幾篇參考文章是最近幾次安裝的時候看的,當(dāng)然一開始看的文章不止這幾篇挖腰,而且這幾篇也可能參考別的文章了雕沿,比如唐巧的博客,這個是真正的教程猴仑,本文只是個安裝步驟晦炊,不是CocoaPods教程,所以不詳細(xì)宁脊。
最后感謝CocoaPods開發(fā)者和維護(hù)者断国,謝謝各位!