一, 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文件里面就是下載的庫

Done。
>使用說明:
>1.從此以后需要使用Cocoapods生成的 .xcworkspace文件來打開工程,而不是使用以前的.xcodeproj文件。
>2.每次更改了Podfile文件,都需要重新執行一次pod update命令。
>備注:當執行pod install之后,除了Podfile,還會生成一個名為Podfile.lock的文件,它會鎖定當前各依賴庫的版本,之后即使多次執行pod install也不會更改版本,只有執行pod update才會改變。Podfile.lock.在多人協作的時候,這樣可以防止第三方庫升級時候造成大家各自的第三方庫版本不一致。所以在提交版本的時候不能把它落下,也不要添加到.gitignore中。