iOS CocoaPods安裝和使用圖解


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

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM