cocoapods官網:https://guides.cocoapods.org
因自己最近安裝cocoapods 就自己整理一下(macOS Sierra 10.12.5? +? xcode 8.3.2)
一、CocoaPods的安裝
CocoaPods可以方便地通過Mac自帶的RubyGems安裝。
打開Terminal(Mac電腦自帶的終端),然后按照以下提示操作即可:
1.設置ruby的軟件源
這是因為ruby的軟件源rubygems.org因為使用亞馬遜的云服務,被我天朝屏蔽了,需要更新一下ruby的源,過程如下:
gem sources -l #(查看當前ruby的源)
gem sources --remove https://rubygems.org/ ? ?(移除當前ruby的源)
gem sources -a https://gems.ruby-china.org/ ? ? (設置當前ruby的源)
gem sources -l #(再次查看當前ruby的源)
如果Terminal輸出:
*** CURRENT SOURCES ***
https://gems.ruby-china.org/
就證明ruby的軟件源已經設置OK了。
2.設置gem為最新版本
如果gem太老,可以嘗試用如下命令升級gem:
在Terminal輸入以下命令:
sudo gem update --system
升級成功后會提示: Latest version currently installed. Aborting.
3.執行安裝CocoaPods命令
sudo gem install? cocoapods
如果報以下錯誤:
ERROR:? While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin
則執行命令:
sudo gem install -n /usr/local/bin cocoapods
pod setup
還有一點需要注意,pod setup在執行時,會輸出Setting up CocoaPods master repo,但是會等待比較久的時間。這步其實是 Cocoapods 在將它的信息下載到 ~/.cocoapods目錄下,如果你等太久,可以試著 cd 到那個目錄,用du -sh *來查看下載進度。
安裝成功后,你會看到:Setup completed
二、Cocoapods的使用
隨便以一種方式新建一個名為Podfile的文件放到你的工程根目錄下(不能寫成別的名字,也可以自己在工程根目錄里面直接新建)
Podfile文件內容的格式應該如下:
platform :ios, '8.0' #(注明你的開發平臺以及版本,'8.0'忽略不寫即為最新版本)
use_frameworks !
? ?target '項目bundle ID' ?do
? ? ? pod 'AFNetworking', '~> 2.5.3' #('~> 2.5.3'為版本號,忽略不寫即為最新版本)
? ? ? ?pod 'SDWebImage', '~> 3.7.2'
end
然后在Terminal進入工程所在的根目錄(工程根目錄)中執行 :
pod install
這樣,AFNetworking和SDWebImage就已經下載完成并且設置好了編譯參數和依賴,以后使用的時候切記如下兩點:
1.從此以后需要使用Cocoapods生成的 .xcworkspace文件來打開工程,而不是使用以前的.xcodeproj文件
2.每次更改了Podfile文件,都需要重新執行一次pod install命令
查找第三方庫:
你如果不知道 cocoaPods 管理的庫中,是否有你想要的庫,那么你可以通過 pod search 命令進行查找,以下是我用 pod search json 查找到的所有可用的庫:
可以在Terminal中輸入:
pod search SDWebImage
回車之后就可以看到和你搜索的關鍵字相關的一些庫類,如圖:
推出搜索 :q
關于 Podfile.lock
當你執行pod install之后,除了 Podfile 外,CocoaPods 還會生成一個名為Podfile.lock的文件,Podfile.lock 應該加入到版本控制里面,不應該把這個文件加入到.gitignore中。因為Podfile.lock會鎖定當前各依賴庫的版本,之后如果多次執行pod install 不會更改版本,要pod update才會改Podfile.lock了。這樣多人協作的時候,可以防止第三方庫升級時造成大家各自的第三方庫版本不一致
pod --version ?:查看當前CocoaPods版本號