Cocoapods安裝步驟
一、升級Ruby環境
sudo gem update --system
如果Ruby沒有安裝,請參考 如何在Mac OS X上安裝 Ruby運行環境
二、使用官方的RubyGems鏡像
安裝CocoaPods時我們要訪問cocoapods.org,用官方的RubyGems鏡像來代替官方版本,執行以下命令:
gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
為了驗證你的Ruby鏡像,可以用以下命令查看:
$ gem sources -l
只有在終端中出現下面文字才表明你上面的命令是成功的:
*** CURRENT SOURCES ***
https://gems.ruby-china.org
上面的命令,有時試了會沒有效,請參考https://gems.ruby-china.com
$ gem sources --add https://gems.ruby-china.org/ --remove https://rubygems.org/
$ gem sources -l *** CURRENT SOURCES *** https://gems.ruby-china.org # 請確保只有 gems.ruby-china.org $ gem install rails
三、在終端中輸入如下命令來完成安裝
//將 CocoaPods Specs repository復制到你電腦上~/.cocoapods目錄下 pod setup
它需要一點時間來完成,你等就是了
如果安裝失敗 ~/.cocoapods 里面是空的,就需要重新setup
命令如下:
pod repo remove master
pod setup
完畢之后這個文件夾大概有 100多M,需要花費比較多時間,請耐心等待。
到這里你已經成功安裝了CocoaPods
當然,要是pod setup 失敗,可以試試下面的方法:
1.訪問 https://github.com/CocoaPods/Specs,然后將Specs項目fork到自己的github賬戶上
2. 下載GitHub Desktop, 然后clone Specs項目。
3. 將clone的Specs項目的文件夾改名為master,然后拖到/Users/用戶名/.cocoapods/repos目錄下。
4. 運行pod setup
解釋:pod setup的本質就是將https://github.com/CocoaPods/Specs上的Specs項目clone到/Users/用戶名/.cocoapods/repos目錄下。若此目錄下已有Specs項目,則會將項目更新到最新的狀態。由於Specs很大,容易導致pod setup失敗。這時就需要我們手動安裝Specs。若直接從github上下載zip文件,由於缺少git文件,會導致cocoa pods不使用。若用git clone,由於文件過大,容易導致失敗。但是使用GitHub Desktop軟件,則會提高clone的成功率,並且會給出clone的進度。
或者通過命令:
$ pod repo remove master $ git clone https://github.com/CocoaPods/Specs.git ~/.cocoapods/repos/master $ pod repo update
Cocoapods使用
1.使用search命令搜索類庫名
$ pod search AFNetworking
得到結果如下圖:
從這個圖上,我們看到AFN有好多版本,最新的版本是2.6.0.
2.打開xcode,新建一個工程,工程名為CocoapodsSample。
使用命令cd,cd后面跟的是工程目錄名,可以直接拉進來,
回車后,輸入命令創建Podfile文件
$ touch Podfile
我們可以看到,在根目錄下,多了一個Podfile文件
3.使用vim編輯podfile文件,使用命令
$ vim Podfile
然后在Podfile文件中輸入以下文字:
platform :ios, '7.0' pod "AFNetworking", "2.5.0"
這兩句文字的意思是,當前AFNetworking支持的iOS最高版本是iOS 7.0, 要下載的AFNetworking版本是2.5.0。
在編輯完后按 esc,然后按":",這個時候輸入wq保存退出。
這個時候打開Podfile文件就會看到里面添加了剛才在終端輸入的兩行語句,如下圖
4.這時候,你就可以利用CocoPods下載AFNetworking類庫了。還是在終端中的當前項目目錄下,運行以下命令:
$ pod install
安裝成功后,如下圖:
這個時候,會看到多了一個.xcworkspace工程,以后打開項目就用 CocoapodsSample.xcworkspace 打開,而不是之前的.xcodeproj文件。
5.打開 CocoapodsSample.xcworkspace 工程,你會驚喜地發現,AFNetwoking已經成功導入項目了。
現在,你就可以開始使用AFNetworking.h啦。可以稍微測試一下,在你的項目任意代碼文件中輸入:
#import <AFNetworking.h> 或者 #import "AFNetworking.h"
然后編譯,看看是否出錯。如果你嚴格按照小編上述的步驟來,是不可能出錯的啦。
另:
如果有一些包已經存在了,或者我們更改了Podfile里面的版本,可以使用以下命令更新
$ pod update
關於Podfile文件編輯時,第三方庫版本號的各種寫法:
pod ‘AFNetworking’ //不顯式指定依賴庫版本,表示每次都獲取最新版本 pod ‘AFNetworking’, ‘2.0’ //只使用2.0版本 pod ‘AFNetworking’, ‘>2.0′ //使用高於2.0的版本 pod ‘AFNetworking’, ‘>=2.0′ //使用大於或等於2.0的版本 pod ‘AFNetworking’, ‘<2.0′ //使用小於2.0的版本 pod ‘AFNetworking’, ‘<=2.0′ //使用小於或等於2.0的版本 pod ‘AFNetworking’, ‘~>0.1.2′ //使用大於等於0.1.2但小於0.2的版本,相當於>=0.1.2並且<0.2.0 pod ‘AFNetworking’, ‘~>0.1′ //使用大於等於0.1但小於1.0的版本 pod ‘AFNetworking’, ‘~>0′ //高於0的版本,寫這個限制和什么都不寫是一個效果,都表示使用最新版本
Cocoapods 降級處理
移除pod組件,查看pod的安裝位置
$ which pod
手動刪除這個組件
$ sudo rm -rf <path>
卸載當前版本
sudo gem uninstall cocoapods
下載指定版本。
sudo gem install cocoapods -v 0.39.0
查看當前pod 版本
pod --version
2018-10-07更新,不需要操作第一步和第二步,直接【卸載當前版本】,下載指定版本即可。
如果在操作的過程中,報錯如:
則是因為 ruby 版本導致的,請參考淘寶網官方說明:https://ruby.taobao.org
當前的解決方式直接更新一下ruby指向:
$ gem sources --add https://gems.ruby-china.org/ --remove https://rubygems.org/
報錯2:Updating spec repo `master` [!] Failed to connect to GitHub to update the Co
執行下面命令就好了
sudo gem install -n /usr/local/bin cocoapods
參考資料:
http://code4app.com/article/cocoapods-install-usage
http://www.cnblogs.com/wayne23/p/3912882.html