簡單說明本次知識要點
1.Cocoapods的安裝;
2.安裝遇到的問題;
3.安裝總結(jié);
4.最新補充;
背景介紹: 前幾天發(fā)現(xiàn)筆記本有將近50個G的空間憑空消失了(用mac的朋友們有沒有這個疑惑婿奔,求解答),一怒之下问慎,就把系統(tǒng)格了萍摊,隨之而來的就有各種問題了, 其中一個便是這個,雖然網(wǎng)上有很多的文章如叼,但某些不全的地方說不定就在這看到啦冰木,哈哈,方便各位學友吧笼恰,于是本文油然而生... ?
才疏學淺片酝,不足之處,還請各位大神指正挖腰!閑話少說雕沿,言歸正傳!
1.Cocoapods的安裝
a. 移除現(xiàn)有Ruby默認源
gem sources --remove https://rubygems.org/
b. 使用新的源
gem sources --add?https://gems.ruby-china.com/?--remove?https://rubygems.org/
c. 驗證新源是否替換成功
gem sources -l
出現(xiàn)以代碼表示替換成功
*** CURRENT SOURCES ***
d. 安裝CocoaPods
?sudo gem install cocoa pods?
?備注:蘋果系統(tǒng)升級 OSX EL Capitan 后改為
?sudo gem install -n /usr/local/bin cocoa pods 這一步會讓輸入密碼猴仑;
5. 設置pod倉庫
pod setup?
終端會停留在 Setting up CocoaPods master repo 一段時間审轮,通過新開一個終端窗口肥哎,輸入"cd ~/.cocoapods/"命令行跳到cocoapods文件夾內(nèi),執(zhí)行"du -sh *"查看文件夾的大小疾渣。需要下載安裝篡诽,而且目錄較大,請耐心等待榴捡。如果順利杈女,安裝完成后會出現(xiàn) Setup completed大功告成 ,你便可享受Cocoapods帶來的快感啦啦...
以上如果順利吊圾,則說明你的RP很好达椰; 然世事一般不會如此順利;以下為安裝可能遇到的一些問題项乒;在此略舉一二!
2. 安裝遇到的坑
1.常規(guī)坑
?升級Ruby環(huán)境
如果你用 ?gem update --system ?時啰劲,會出現(xiàn)如下錯誤
Updating rubygems-update
ERROR:? While executing gem ... (Gem::FilePermissionError)
You don't have write permissions for the /Library/Ruby/Gems/2.0.0 directory.
這說明你沒有權(quán)限,要用以下命令檀何;
sudo gem update --system值得注意的是:在新系統(tǒng)10.11以上的要用
sudo gem install -n /usr/local/bin cocoapods
2. 在OS X EI Capitan中的新坑
如下:
Error installing cocoapods:
activesupport requires Ruby version >= 2.2.2.
要求ruby環(huán)境必須大于以上版本蝇裤,可以用 ruby -v 來查看當前ruby版本,安裝RVM频鉴, Ruby Version Manager, Ruby 版本管理器栓辜, 包括Ruby的版本管理器和Gem庫管理(gems)
第一步,安裝RVM
curl -L get.rvm.io | bash -s stable
等待一段時間垛孔, 成功安裝RVM
##? Thank you for using RVM!
#? We sincerely hope that RVM helps to make your life easier and more enjoyable!!!
#測試是否安裝正常藕甩,輸入以下命令
source ~/.bashrc
source ~/.bash_profile
rvm -v
rvm 1.27.0 (latest) by Wayne E. Seguin, Michal Papis[https://rvm.io/]
第二步,用RVM升級Ruby
a. ?查看當前ruby版本
? ?ruby?-v
? ?ruby?2.0.0
b. ?列出已知的ruby版本
? ? ?rvm?list?known
c. ?安裝ruby?2.3.0
? ? ? rvm?install?2.3.0
至此似炎,ruby環(huán)境安裝完成,便可從新按照步驟一來從新安裝啦悯姊;
另一個錯誤:
[!] An error occurred while performing `git pull` on repo `master`.
[!] /usr/bin/git pull --ff-only
這個錯誤應該是說這個節(jié)點有問題羡藐。在網(wǎng)上搜下資料,然后試試把cocoapods的節(jié)點刪除悯许,重新添加一個節(jié)點仆嗦;
原因: Cocoapods的分支不支持當前最新的Xcode版本
解決辦法: 刪除master分支 重新建立新的分支
sudo rm -fr ~/.cocoapods/repos/master
然后再:?pod setup
實用的技巧
a. 打印Xcode路徑:xcode-select --print-path
b. "cd ~/.cocoapods/"命令行跳到cocoapods文件夾內(nèi),執(zhí)行"du -sh *"查看文件夾的大小先壕,實時了解安裝動態(tài)瘩扼,以解等待之苦。
c. 在新版本中 [!] The dependency `MBProgressHUD` is not used in any concrete target.
新的cocoapods不能像之前那樣安裝第三方了±牛現(xiàn)在的格式是要加上項目的target集绰。如下:
platform :ios, '8.0'
target 'ceshi' do
pod 'AFNetworking', '~> 2.6'
pod "MBProgressHUD"
end
里面的 ceshi 記得替換為自己項目里面的target。這樣就基本OK了谆棺,執(zhí)行pod install?
d. ?在新版的Xcode中栽燕,用到插件Cocoapods時,可能也會不好使,至于錯誤忘記貼出來了碍岔,如果不好用了浴讯,你就直接在Podfile中添加一下格式試下即可;
platform :ios, '8.0'
target 'ceshi' do
pod 'AFNetworking', '~> 2.6'
pod "MBProgressHUD"
end
將要添加的第三方放到target do ? ?~ ? ? end ?之間 ?另外還有一個路徑的問題蔼啦;
安裝命令: sudo gem install -n /usr/local/bin cocoapods
用上述命令安裝的cocoapods,那么在Xcode的cocoapods插件的GEM_PATH里寫入? ? /usr/local/bin? ? 即可
在終端里輸入 ?gem env
找到SHELL PATH: ?會出現(xiàn)以下路徑:
/usr/local/bin
/usr/bin
/bin
/usr/sbin
/sbin
通過命令找到這些榆纽,一個個試試,總之捏肢,肯定有一個是正確的奈籽;填入即可;
3.結(jié)語
好了猛计,至此已至深夜唠摹,常見的問題已差不多解決了,要給朋友們說再見了奉瘤,下次繼續(xù)交流勾拉,不足之處還請各位大神不吝賜教!
最新補充:
cocoapods盗温,如果在安裝時出現(xiàn)類似錯誤The dependency `AFNetworking` is not used in any concrete target.
就可以按照上述實用技巧d步驟去寫藕赞,還有一種簡單的方法: 在新項目中可以使用,cd到目錄文件夾中卖局,直接 pod init ?即可完成Podfile文件的創(chuàng)建里面會預置需要補充的內(nèi)容斧蜕,試一下就知道了,預置內(nèi)容如下:
# Uncomment this line to define a global platform for your project
# platform :ios, '9.0'
target 'safafd' do
# Uncomment this line if you're using Swift or would like to use dynamic frameworks
# use_frameworks!
# Pods for safafd
target 'safafdUITests' do
inherit! :search_paths
# Pods for testing
end
end
(2018年10月16)新的安裝錯誤補充
如果有以下的提示砚偶、其實也是已經(jīng)成功了批销,但是如果你覺得「!」不舒服的話染坯,[!] This is a test version we'd love you to try. (以下是完整的信息)
CocoaPods 1.6.0.beta.1 is available.
To update use: `sudo gem install cocoapods --pre`
[!] This is a test version we'd love you to try.
For more information, see https://blog.cocoapods.org and the CHANGELOG for this version at https://github.com/CocoaPods/CocoaPods/releases/tag/1.6.0.beta.1
Setup completed
遇到這種情況均芽、輸入sudo gem install cocoapods --pre 會報以下錯誤:
ERROR:? While executing gem ... (Gem::FilePermissionError)
? ? You don't have write permissions for the /usr/bin directory.
改用以下命令即可:
sudo gem install -n /usr/local/bin cocoapods 即可以完成安裝;