網上關于cocoapods的安裝可謂是不可勝數。但是對于新版的系統來說,的確存在很多的坑點,本文只是對網上資源做了整合和自己的一些使用見解。
一:卸載cocopods
1.卸載老版本cocopods
$ sudo gem uninstall cocoapods
2.查看本地安裝過的cocopods相關東西
$ gem list --local | grep cocoapods
結果如下:
cocoapods (1.0.1)
cocoapods-core (1.0.1)
cocoapods-deintegrate (1.0.1)
...
3.然后使用命令逐個刪除
$ sudo gem uninstall +你要刪除的庫名稱
比如:$ sudo gem uninstall cocoapods-core
.cocopods 文件有可能因為權限問題刪除不了,可以直接找到 .cocopods 文件(隱藏文件)刪掉就好
顯示隱藏文件 :
defaults write com.apple.finder AppleShowAllFiles -bool true
killall Finder
二:安裝cocopods
1.終端輸入
$ curl -L https://get.rvm.io | bash -s stable
2.載入 RVM 環境
$ source ~/.rvm/scripts/rvm
檢查一下是否安裝正確
$ rvm -v
打印結果為:rvm 1.27.0 (latest) by Wayne E. Seguin <wayneeseguin@gmail.com>, Michal Papis <mpapis@gmail.com> [https://rvm.io/]
3.用RVM安裝Ruby環境
- 可以先查詢已經安裝的ruby
$ rvm list
- 如果你想卸載一個已安裝版本
$ rvm remove 1.9.2
- 列出已知的ruby版本
$ rvm list known
- 可以選擇現有的rvm版本來進行安裝(下面以rvm 2.3.0版本的安裝為例)
$ rvm install 2.3.0
- 設置Ruby版本
- RVM 裝好以后,需要執行下面的命令將指定版本的 Ruby 設置為系統默認版本
$ rvm 2.3.0 --default
- 驗證RVM
$ ruby -v
打印如下:ruby 2.3.0p0 (2015-12-25 revision 53290) [x86_64-darwin15]
- 查看ruby源
$ gem sources -l
- 可以查看當前是什么連接,然后替換方式如下:
$ gem source -r https://rubygems.org/
$ gem sources --add https://gems.ruby-china.com/
- 有多余的鏡像可以移除
gem sources --remove 鏡像鏈接
- 要想驗證是否替換成功了,可以執行:
$ gem sources -l
- 成功顯示
*** CURRENT SOURCES ***
https://gems.ruby-china.com/
- 開始安裝cocoapods
$ sudo gem install cocoapods
等到提示:gems installed
$ pod setup
- 如果報異常可先執行
$ sudo rm -fr ~/.cocoapods/repos/master
再執行$ pod setup
- 如果報git相關異常估計是系統升級導致的,先執行
$ xcode-select --install
再執行$ pod setup
漫長的等待,估計有五百多兆...
如果安裝過程中報如下錯誤:
unable to access 'https://github.com/CocoaPods/Specs.git/': SSLRead() return error -9806
遇到這種問題的話,可以手動去克隆一份到repos目錄下面。
- 步驟1.通過finder的前往文件夾進行查看 ~/.cocoapods/repos
- 步驟2.通過終端,進入到 ~/.cocoapods/repos
- 步驟3.然后通過 git clone https://github.com/CocoaPods/Specs.git
可憐的你發現,速度真是慢啊,你等不了,還有二個解決方法
直接打開倉庫鏈接,下載下來拷貝到相應的問價夾
可憐的你還是發現,下載速度也很慢啊,這里還有一個解決方案,等!等等就快了,筆者試了的確比克隆快-
終極解決方案,找一臺工作正常的電腦,到他的~/.cocoapods/repos目錄下面拷貝出master文件到自己的Mac上的相應位置
好了,現在我們重新檢測一下是否能正常運行。
三:使用cocoapods
- 終端進入項目目錄下
cd 空格一下 + 文件路徑(直接把項目拉入終端即可)
如:cd ~/Path/To/Folder/Containing/IceCreamShop
- 創建一個PodFile
pod init
這將為你的項目創建一個PodFile文件
- 輸入下面的命令行打開PodFile,并使用Xcode進行編輯:
open -a Xcode Podfile
注意:你不能使用TextEdit來編輯Podfile,因為它有可能用圖形化的更有吸引力的typeset quotes代替standard quotes,這可能導致CocoaPods不能理解并拋出錯誤,所以最好用Xcode或者別的編程文本編輯器來編輯你的Podfile。
默認的podFile看起來是這樣的:
# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'
target 'testProject' do
# Comment the next line if you're not using Swift and don't want to use dynamic frameworks
use_frameworks!
# Pods for testProject
end
- 將
# platform :ios, '9.0'
的#號去掉,后面的9.0可以根據項目需要更改,這段話就告訴了CocoaPods--你的項目使用的是iOS 9.0,并且將使用框架來代替靜態庫。 - 安裝你的第一個庫,將下面的內容添加到你的Podfile里面
pod 'Alamofire', '1.2.3'
保存并關閉podFile
- 開始給項目安裝CocoaPods
pod install
- 如果庫比較多,在重新導入庫用
pod install
就比較慢,下面的2個命令在安裝新的庫的前面不會重新更新前面已經安裝的庫
pod install --no-repo-update
或
pod update --no-repo-update
四:Podfile的語法解釋
示列一個稍微復雜的Podfile:
source 'ssh://git@gitlab.9ijx.com:9830/iOS/Specs.git'
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '7.0'
use_frameworks!
inhibit_all_warnings!
workspace 'JYCocoaPodsTest'
target 'JYCocoaPodsTest' do
pod 'AFNetworking'
pod 'JYCarousel', '0.0.1'
pod 'WCJCache', :git => "http://gitlab.9ijx.com/iOS/WCJCache.git"
target :JYCocoaPodsTestUITests do
inherit! :search_paths
pod 'YYText'
end
end
1.platform :iOS, '7.0'
- 指定了開源庫應該被編譯在哪個平臺以及平臺的最低版本。
- 若不指定平臺版本,官方文檔里寫明各平臺默認值為iOS:4.3,OS X:10.6,tvOS:9.0,watchOS:2.0
inhibit_all_warnings!
- 屏蔽cocoapods庫里面的所有警告
- 這個特性也能在子target里面定義,如果你想屏蔽某pod里面的警告也是可以的:
pod 'JYCarousel', :inhibit_warnings => true
-
xcodeproj
現在被project
代替,這個變量就別使用了
- 允許你指定需要鏈接的工程
-
use_frameworks!
使用frameworks動態庫替換靜態庫鏈接
- swift項目cocoapods 默認 use_frameworks!
- OC項目cocoapods 默認 #use_frameworks!
-
workspace
- 指定應該包含所有projects的Xcode workspace.
- 如果沒有顯示指定workspace并且在Podfile所在目錄只有一個project,那么project的名稱會被用作于workspace的名稱
project
默認情況下是沒有指定的,當沒有指定時,會使用Podfile目錄下與target同名的工程:(我們只有一個工程JYCocoaPodsTest)
# JYCocoaPodsTest這個Target只有在JYCocoaPodsTest工程中才會鏈接
target 'JYCocoaPodsTest' do
project 'JYCocoaPodsTest'
...
end
target 'xxxx' do ...end
- 指定特定Target的依賴庫
- 可以嵌套子Target的依賴庫
inherit! :search_paths
- 明確指定繼承于父層的所有pod,默認就是繼承的
source
- 指定specs的位置,自定義添加自己的podspec。公司內部使用
cocoapods 官方source是隱式的需要的,一旦你指定了其他source 你就需要也把官方的指定上
例如:
source 'ssh://git@gitlab.9ijx.com:9830/iOS/Specs.git'
source 'https://github.com/CocoaPods/Specs.git'
- 依賴庫的基本寫法:
pod 'JYCarousel', //不顯式指定依賴庫版本,表示每次都獲取最新版本
pod 'JYCarousel', '0.01'//只使用0.0.1版本
pod 'JYCarousel', '>0.0.1' //使用高于0.0.1的版本
pod 'JYCarousel', '>=0.0.1' //使用大于或等于0.0.1的版本
pod 'JYCarousel', '<0.0.2' //使用小于0.0.2的版本
pod 'JYCarousel', '<=0.0.2' //使用小于或等于0.0.2的版本
pod 'JYCarousel', '~>0.0.1' //使用大于等于0.0.1但小于0.1的版本,相當于>=0.0.1&&<0.1
pod 'JYCarousel', '~>0.1' //使用大于等于0.1但小于1.0的版本
pod 'JYCarousel', '~>0' //高于0的版本,寫這個限制和什么都不寫是一個效果,都表示使用最新版本
// 依賴庫的自定義寫法
pod 'JYCarousel', :path => '/Users/Dely/Desktop/JYCarousel'
end
查看最新CocoaPods的下載地址 https://ruby-china.org/