CocoaPod安裝牛程

一, CocoaPods 介紹

CocoaPods 是 iOS 最常用的第三方類庫管理工具,絕大部分有名的開源類庫都支持 CocoaPods。
CocoaPods 是用 ruby 實現的,要想使用它首先需要有 ruby 的環境。
在OS X系統默認已經可以運行 ruby。但 ruby 版本過低是無法正常支持 CocoaPods 的使用,所以需要先安裝更新升級 rvm 和 ruby。

二, 安裝流程

第1步.

檢查是否存在rvm環境, 打開終端輸入

 $ rvm -v ```
如果存在rvm環境 返回信息:

rvm 1.27.0 (latest) by Wayne E. Seguin wayneeseguin@gmail.com, Michal Papis mpapis@gmail.com [https://rvm.io/]

不存在則出現:

-bash: rvm: command not found



如果不存在rvm,先安裝配置rvm,輸入:

$ curl -L https://get.rvm.io | bash -s stable

安裝完成后載入rvm:

$ source ~/.rvm/scripts/rvm

####第2步.
確定已安裝rvm并載入rvm環境后,下一步檢查ruby 版本環境:
OS X系統默認存在ruby,但版本低于2.2.2,安裝會出錯,所以先檢查其版本

$ sudo gem -v

低于2.6.x的建議更新到最新:

$ gem update --system

返回更新成功信息:

Updating rubygems-update
Fetching: rubygems-update-2.6.7.gem (100%)
Successfully installed rubygems-update-2.6.7

######補充指令

*查詢已安裝的 ruby:*

$ rvm list

*卸載一個已安裝版本:*

$ rvm remove 1.9.2

*修改默認使用的ruby版本*

$ rvm use 2.3.0 --default

---
####第3步.
由于淘寶的鏡像 (https://ruby.taobao.org/ )已經不可用了。
所以接下來我們用最新支持的ruby鏡像 (https://gems.ruby-china.org/)
首先檢查電腦目前的鏡像:

$ gem sources -l


如果電腦沒安裝過CocoaPods,默認的應該是https://rubygems.org/ 

*** CURRENT SOURCES ***
https://rubygems.org/

輸入移除命令:

$ gem sources --remove https://rubygems.org/

返回移除成功:

https://rubygems.org/ removed from sources

添加國內鏡像 https://gems.ruby-china.org 輸入:

$ gem sources --add https://gems.ruby-china.org

成功后返回信息:``https://gems.ruby-china.org added to sources``

確認當前ruby源:

$ gem sources -l

返回信息:

*** CURRENT SOURCES ***
https://gems.ruby-china.org //已經添加


##三,安裝CocoaPods
####第1步.
如果系統版本是10.11.x  輸入這行命令:

$ sudo gem install -n /usr/local/bin cocoapods

否則輸入:

$ sudo gem install cocoapods

注意:當系統升級10.11 后,輸入pod命令會出現
``-bash: pod: command not found``
解決方法就是輸入下面這一行命令就可以了:

$ sudo gem install -n /usr/local/bin cocoapods

接著$pod setup:

$ pod setup

提示:如果終端一直停留在``Settng up CocoaPods master repo``這個狀態,是因為要進行下載安裝,文件比較大,此時你可通過新開一個終端窗口,輸入``cd ~/.cocoapods/``命令行跳到cocoapods文件夾內,執行``du -sh *``查看正在下載的文件夾的大小。
下載完成最后返回顯示 ``Setup completed``

當出現如下:

[!] An error occurred while performing [Git](http://lib.csdn.net/base/git) pull on repo master.
[!] /usr/bin/git pull --ff-only

原因: Cocoapods的分支不支持當前最新的Xcode版本
解決辦法: 刪除master分支 重新建立新的分支
``sudo rm -fr ~/.cocoapods/repos/master``
然后再: pod setup

####第2步.
用xcode新建一個project(例如:CocoaPodsTestDemo),并在終端用cd到工程文件夾目錄(具體操作:終端輸入cd+空格+工程文件夾直接拖拽到終端+回車)

查找所需第三方庫的最新版本例如:AFNetworking,輸入指令:

$ pod search 'AFNetworking' //(退出搜索按 :wq )

####第3步.
vim Podfile 配置文件

$ vim Podfile

寫入以下內容并保存 ( 提示:終端vim文件 按 i 進入編輯模式 ,esc 退出編輯模式(如果esc沒反應,control+c也可以退出編輯狀態),退出編輯模式以后按 :wq 可保存并退出Podfile)

Uncomment this line to define a global platform for your project

platform :ios, '8.0'
target 'CocoaPodsTestDemo' do

Uncomment this line if you're using Swift or would like to use dynamic frameworks

Pods for CocoaPodsTestDemo

pod 'AFNetworking', '~>3.1.0'
pod 'SDWebImage'
pod 'FMDB'
pod 'Masonry'
pod 'MJRefresh'

use_frameworks!

pod 'ReactiveCocoa'

end


備注:platform那一行,ios三個字母都要小寫,而且與前面的冒號之間不能有間隔,后面的版本號也可以不寫,但是有些開源庫對版本是有要求的,比如要在6.0以上才能運行,遇到這樣的開源庫就需要寫上版本號

####第4步.
保存退出Pofile后
下載第三方庫文件到項目工程中:

$ pod install

####第5步.
打開CocoaPodsTestDemo.xcworkspace 
打開Pod文件里面就是下載的庫

![](http://upload-images.jianshu.io/upload_images/3252527-cb529ba321ef0903.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/300)
Done。


>使用說明:

>1.從此以后需要使用Cocoapods生成的 .xcworkspace文件來打開工程,而不是使用以前的.xcodeproj文件。

>2.每次更改了Podfile文件,都需要重新執行一次pod update命令。

>備注:當執行pod install之后,除了Podfile,還會生成一個名為Podfile.lock的文件,它會鎖定當前各依賴庫的版本,之后即使多次執行pod install也不會更改版本,只有執行pod update才會改變。Podfile.lock.在多人協作的時候,這樣可以防止第三方庫升級時候造成大家各自的第三方庫版本不一致。所以在提交版本的時候不能把它落下,也不要添加到.gitignore中。
最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容