2017最新CocoaPods安裝
最近給新mac安裝CocoaPods,在網上找了一下資料,發現文章要麼過時,要麼各種報錯。特意整理了一下最新的教程,並親測成功。taobao Gems 源已停止維護,現由 ruby-china 提供映象服務
不管需不需要升級ruby,rvm可以讓你擁有多個版本的Ruby,並且可以在多個版本之間自由切換。如果已經安裝過跳到第2步(rvm -v 檢視是否安裝)
curl -L get.rvm.io | bash -s stable
//需要等一會
source ~/.bashrc
source ~/.bash_profile
等待終端載入完畢,後輸入
rvm -v
如果能顯示版本號則安裝成功了。
CocoaPods目前安裝需要Ruby的版本大於2.2.2,不然會報錯:Error installing pods: activesupport requires Ruby
檢視已安裝的ruby:
rvm list
如果已安裝版本大於2.2.2,直接到第3步。
ruby -v //也可以檢視ruby版本
//列出ruby可安裝的版本資訊
rvm list known
rvm install 2.2.2 //安裝一個ruby版本
rvm use 2.2.2 --default
目前網上文章大都是這面這種:
sudo gem update --system
gem sources --remove https://rubygems.org/
//等有反應之後再敲入以下命令
gem sources -a https://ruby.taobao.org/
這裡是個大坑:會報錯_connect returned=1 errno=0 state=SSLv3 read servercertificateB:certificate verify failed (https://ruby.taobao.org/specs.4.8.gz)
這是因為taobao Gems 源已停止維護,現由 ruby-china 提供映象服務,正確的操作是:
sudo gem update --system
gem sources --remove https://rubygems.org/
gem sources --remove https://ruby.taobao.org/ //如果安裝了淘寶的映象
//等有反應之後再敲入以下命令
gem sources -a https://gems.ruby-china.org/
為了驗證你的Ruby映象是並且僅是ruby-china,可以用以下命令檢視:
gem sources -l
只有在終端中出現下面文字才表明你上面的命令是成功的:
*** CURRENT SOURCES ***
https://gems.ruby-china.org/
# 確保只有 gems.ruby-china.org/
這裡有幾種選擇
1)、在終端輸入以下命令:
sudo gem install -n /usr/local/bin cocoapods
pod setup
這個過程會很慢,反正我掛了一天最後還是跟遠端連線失敗掛掉了,據說大多都是掛機一晚上才裝好的,繼續往下看吧,總有更好的。
2)、執行:
git clone https://git.coding.net/CocoaPods/Specs.git ~/.cocoapods/repos/master
感覺也就幾分鐘的樣子,
normal.png有如圖就正常了,最後切記要:
pod repo update
用第一種掛掉後改用這種很快就搞定了,長舒一口氣,先隨便搜尋一個第三方庫,如 pod search AFNetWorking,有結果不報錯說明已經安裝成功了。
3)、把你已經裝好了CocoaPods同事~/.cocoapods目錄下的repo目錄拷貝下來,放進自己的目錄裡。再 pod setup。
嘗試著將自己安裝好的cocoapods目錄下的repos檔案拷貝到U盤,由於裡面檔案數量非常之多,速度相當慢。所以個人覺得第二種方法要好一些。
好了,三種方法都介紹完了,選哪種自己斟酌。
補充:
2017.5.31補充更新:
假如完成以上步驟後輸入pod命令報錯:-bash: pod:command not found
解決辦法:sudo gem install -n /usr/local/bin cocoapods
指令執行完後就可以使用pod命令了,系統升級10.11後需要這樣處理。
某些環境原因導致pod更新不了,可能原因有
1).gem版本太低;
2).github無法連結;
3).cocoapods目錄下的配置資訊錯誤。
我們可以一個一個來排除,首先更新gem到最新版本,在終端中輸入:
$ sudo gem update --system
然後檢查是否可以ping通github,在終端中輸入:
$ ping github.com
然後檢視pob repo list:
$ pod repo list
結果顯示0 repos,說明沒有安裝成功;
刪除.cocoapods目錄,重新下載pod更新:
$ cd ~/.cocoapods/
$ sudo -rm -rf ~/.cocoapods/
重新執行pod setup,過一段時間後提示setup completed,在終端中輸入 pod list,展示出安裝列表;
接下來看下如何使用:
我們先建立這個神奇的PodFile。在終端中進入(cd命令)你專案所在目錄,然後在當前目錄下,利用vim建立Podfile,執行:
$ vim Podfile
然後在Podfile檔案中輸入以下文字:
platform : ios, '7.0' //注意ios要小寫,有大寫會報錯
target '你的專案名稱' do
pod 'AFNetworking', '~> 3.1.0'
end
然後儲存退出。vim環境下,儲存退出命令是:
:wq
這時候,你會發現你的專案目錄中,出現一個名字為Podfile的檔案,而且檔案內容就是你剛剛輸入的內容。注意,Podfile檔案應該和你的工程檔案.xcodeproj在同一個目錄下。
這時候,你就可以利用CocoPods下載AFNetworking類庫了。還是在終端中的當前專案目錄下,執行以下命令:
$ pod install
注意最後一句話,意思是:以後開啟專案就用 CocoaPodsDemo.xcworkspace 開啟,而不是之前的.xcodeproj檔案。否則無法關聯pod下來的類庫。
工欲善其事,必先利其器。