一、 CocoaPods簡介
1、CocoaPods 是 iOS 最常用的第三方類庫管理工具,可以解決庫與庫之間的依賴關系,有名的開源類庫都支持 CocoaPods。
2、使用CocoaPods可以很方便地查找使用新的第三方庫,這些類庫是比較“標準的”,可以讓我們方便快捷找到真正好用的類庫。
3、CocoaPods 是用 ruby 實現的,要想使用它首先需要有 ruby 的環境。幸運的是macOS系統默認已經可以運行 ruby 了。
但是有時候 ruby 版本過低是無法正常支持 CocoaPods 的使用,所以需要先安裝更新升級 rvm 和 ruby。
二、 CocoaPods安裝過程
寫在前面
1.安裝需要用到Ruby,雖然Mac自帶了Ruby,不過版本有點老了,最好選擇更新一下。
2.查看當前Ruby版本,檢查本地Mac是否 已經安裝了。rvm (ruby version manager)命令。
引入概念:
RVM:
全稱是 Ruby Version Manager ,是一款由 Wayne E. Seguin 開發的一款命令行工具。rvm 能夠讓你輕松的安裝、管理 ruby 生產力環境,諸如不同版本的解釋器和 gem。
- rvm 的項目官網:http://rvm.io/gemsets/basics
- CocoaPods項目的地址:https://github.com/CocoaPods/CocoaPods
- CocoaPods官方指南地址 https://guides.cocoapods.org
Ruby:
Ruby,一種簡單快捷的 面向對象 ( 面向對象程序設計 ) 腳本語言 ,在20世紀90年代由日本人松本行弘( Yukihiro Matsumoto )開發,遵守 GPL 協議和Ruby License。
1 .安裝并載入rvm環境
(1). 檢查本地是否已安裝rvm
打開終端,輸入指令
$ rvm -v
1) 如果不存在,則會出現下面的情況:
如果不存在,先要進行安裝一下;
( 2 ). 安裝rvm
1)安裝指令是
$ curl -L https://get.rvm.io | bash -s stable
按下回車即進入下載安裝的狀態,期間會自動通過homebrew安裝依賴包.(Homebrew 是一個軟件包管理器,用于在mac上安裝一些macos 上沒有的UNiX工具;類似于360軟件管理器。)
等待一段時間就可以安裝好Rvm。
2)載入RVM環境:
$ source ~/.rvm/scripts/rvm
3)檢查是否安裝成功:
$ rvm -v
下圖即為安裝成功后,顯示的版本號
(3)RVM命令安裝Ruby環境
1)查看當前ruby版本
$ ruby -v
(檢查當前版本,當ruby版本低于2.2.2時,安裝cocoapods會報錯)
2)查看所有ruby版本
$ rvm list known
查詢當前所有已知的ruby環境。
如果版本低于2.2.2,請更新一下。vrm list known命令會查詢所有的ruby版本,找到最高版本號進行安裝;
若版本庫里沒有最新版本,輸入:
$ rvm get head
升級到最新的存儲庫源版本
3)安裝指定版本
輸入指令:
$ rvm install 2.5.1
(選擇較高版本),
然后根據提示按“enter”鍵,第二次按之后會提示你輸入密碼。
等待漫長的下載,編譯過程,完成以后,Ruby, Ruby Gems 就自動安裝好了。
4)查看已經安裝的ruby版本
$ rvm list
卸載一個已安裝版本
$ rvm remove 2.5.1
2. 設置默認Ruby版本
安裝好RVM之后可以指定特定Ruby版本為系統默認版本
輸入命令:
$ rvm 2.5.01 - - default
也可以指定其他版本號,前提是有用rvm install 安裝過那個版本
3. 檢查更新ruby版本環境
cocoapods是用gem ruby實現的,想要使用它首先需要有gem ruby的環境。且Mac的macos系統默認已經可以運行ruby。
(建議gem bury包環境升級到2.6.x以上。)
(1).檢查gem ruby版本號:
$ ruby -v
$ gem -v
得到如下結果:
Gem是管理Ruby庫和程序的標準包,如果它的版本過低也可能導致安裝失敗,解決的辦法是更新gem版本
(2).更新gem ruby版本
$ gem update - -system
更新gem ruby版本號:
4.檢查ruby源并移除。
(1)、檢查ruby源
$ gem sources -l
檢查ruby源,結果如下:
因為Ruby環境默認的的軟件源rubygems.org被屏蔽了,國內那面永遠需要翻 越的墻,你懂的~,我們需要來修改更換源,把源切換至ruby-china;
(2)、移除掉原有的源
$ gem sources - - remove https://rubygems.org/
(3)、添加國內最新的源。ruby-china
$ gem sources -a https://gems.ruby-china.com
這里注意一下https://gems.ruby-china.org 已經不能使用。后綴要改成com
(4)、檢查是否添加成功
$ gem sources -l
到這里就已經把Ruby環境安裝成功!接下來需要對cocoapods進行安裝。
5. 安裝CocoaPods
$ gem install -n /usr/local/bin cocoapods
6. 查看是否安裝成功并更新
(1)查看是否成功
$ pod - - version
查看pod版本
(2) 更新Podspec索引文件,創建本地索引庫,如果沒有報錯,就說明一切安裝成功了;這個過程需要一些時間。
$ pod setup
三、CocoaPods的使用
1、用Xcode創建(打開)一個工程,并創建podfile配置文件
(1)、進入項目目錄
$ cd ~
在沒有導入庫時,項目中import庫 會報錯
(2)、創建Podfile文件
$ touch Podfile
創建一個podfile文件,然后打開編輯;
或是使用$ vi podfile
輸入i
進入編輯,編輯完成后按 esc 然后輸入:wq
按回車鍵 ,保存并退出。
(3)、編輯Podfile文件。
我們可以在Podfile文件中寫入需要用到的第三方庫按如下格式:
platform :ios, '9.0'
use_frameworks!
target 'TestDemo' do
pod 'Alamofire', '~> 4.0.1'
pod 'Kingfisher', '~> 3.1.1'
end
Swift的pod文件在于use_frameworks! 這一句是必須的,作用是把三方庫打包成靜態庫,而oc是不需要的。
另外,也可在github中找到所需要的庫,里面有podfile格式內容
2、安裝依賴庫
$ pod install
(后續添加框架可直接pod update)
建議使用:
$ pod install --verbose --no-repo-update
$ pod update --verbose --no-repo-update
當執行標準命令的時候會升級CocoaPods的spec倉庫,加一個參數可以省略這一步,然后速度就會提升不少。
若出現以下錯誤時,在Podfile 文件中添加如下一行內容:
這是由于你多次移動你項目的路徑,以至于再次update你的Podfile項目時,出現找不到工程路徑的問題xcodeproj ‘你的工程名.xcodeproj’
3、進入項目時,再次打開,編譯報錯就消失了。安裝完成!
CocoaPods工作原理
CocoaPods的工作主要是通過ProjectName.xcworkspace來組織的,在打開ProjectName.xcworkspace文件后,發現Xcode會多出一個Pods工程。它是將所有的依賴庫都放到名為Pods項目中,然后讓主項目依賴Pods項目,就這樣,源碼管理工作都從主項目移到了Pods項目中。