看一遍就會的CocoaPods的安裝和使用教程
什么是CocoaPods?
CocoaPods是專門為iOS工程提供對第三方庫的依賴的管理工具,通過CocoaPods,我們可以更方便地管理每個第三方庫的版本,而且不需要我們做太多的配置。直觀、集中和自動化地管理我們項目的第三方庫。
我們都有這樣的經歷,當我們添加第三方庫的時候,需要導入一堆相關依賴庫,更新的時候也要刪掉重新導入然后再配置。當我們需要更新某個第三方庫的時候,我們又要手動移除該庫,導入新的庫,然后再配置。這些是很麻煩且沒有意義的工作。
當我們開始使用CocoaPods管理第三方庫后,我們只需要相當少的配置,其它的一切都交由CocoaPods來管理即可,我們使用起來就更省心了。
安裝CocoaPods
1.首先更新gem到最新版本,在終端中輸入:$ sudo gem update --system,注意不要把“$”復制上。等待一會兒會看到:
更新gem
2.刪除自帶的ruby鏡像,終端輸入:gem sources --remove https://rubygems.org/。
3.添加淘寶的鏡像,終端輸入:gem sources -a https://gems.ruby-china.org/(原來的淘寶鏡像https://ruby.taobao.org/已經不能用了)。
4.可以用gem sources -l來檢查使用替換鏡像位置成功,結果應該只有https://gems.ruby-china.org/才對。
修改鏡像
5.安裝CocoaPods,終端輸入:sudo gem install cocoapods。
等待一會兒會看到:
安裝CocoaPods
6.然后配置下CocoaPods,終端輸入:pod setup。
配置CocoaPods
等待過程可能有點長,成功后會看到:
配置成功
到這里CocoaPods就安裝好了。
查找第三方庫
比如查找MJExtension,終端輸入:pod search MJExtension,第一次搜索他需要建索引,等待一會兒就可以了。
建索引中
完成后他會自動進入一個新的頁面顯示搜索結果,上下滑動查看更多,要退出的話按wq就可以了。以后再搜索就不需要建索引了。
查找結果
引入第三方庫到項目中
我先在桌面上新建一個Test項目,然后演示把MJExtension導進去。
剛開始的文件目錄是這樣的
原始目錄.png
1,首先打開終端,cd到Test路徑下。
Test
2.然后生成并編輯一個Podfile文件,命令為vim Podfile,要導入的第三方都要在這里面寫上。進去后需要先按I鍵進入編輯狀態,寫完后按esc,然后按shift+zz(或者先按shift+:,再按wq)就可以保存退出了。下面的動圖里面都有。
Podfile的格式大概如下,其中'Test'為你的target的名字。
platform :ios,'8.0'
target 'Test' do
pod 'MJExtension', '~> 3.0.13'
end
3.安裝,命令為:pod install。
安裝第三方
安裝成功之后,就可以去項目里面使用了。現在的項目文件變成了這樣
屏幕快照 2016-09-07 23.23.19.png
之前我們一直是雙擊Test.xcodeproj打開項目,以后我們就要雙擊Test.xcworkspace打開了,打開后發現項目里面多了紅色框的部分,可以看到MJExtension已經被引入了。
多出來的文件
使用第三方
你會發現當引入MJExtension的頭文件時,可以#import 或者#import ,但是卻不能在輸入#import "MJExtension.h"的時候出現提示。雖然強制輸入也可以編譯通過,但是感覺很不爽。
解決這個問題的辦法是在工程的Build Settings搜索Search,然后在User header search paths中添加$(SRCROOT)并選擇recursive。
頭文件不提示的解決辦法
現在就可以提示#import "MJExtension.h"啦。
然后我們就可以在項目里面使用MJExtension的方法啦。
使用MJExtension
增加新的第三方
如果使用過程中我還想添加其他的第三方怎么辦,只要在Podfile里面接著添加,然后終端再執行pod install就可以了。
新增第三方
更新CocoaPods中的第三方們。
第三方庫們都有人在維護升級,我們需要隔斷時間就要更新下我們工程中第三方庫的版本。只需要終端輸入命令pod update就可以了。
如果遇到pod install或者pod update慢的問題,原因在于當執行以上兩個命令的時候會升級CocoaPods的spec倉庫,加一個參數可以省略這一步,然后速度就會提升不少。加參數的命令如下:
pod install --verbose --no-repo-update
pod update --verbose --no-repo-update
刪除CocoaPods中的某些第三方們。
當我們需要去掉某個第三方庫時,只需要在Podfile刪除該引入該庫的語句,然后執行pod update或者pod install就可以了。
將CocoaPods從項目中刪除
如果你在以后的使用過程中不想用CocoaPods了怎么辦?很簡單,把多出來的東西們都刪掉就可以了,不過為了項目正常運行,你需要手動導入已經使用的第三方們哦。
將CocoaPods從項目中刪除
升級CocoaPods
升級CocoaPods版本的命令和安裝CocoaPods的命令一樣,都是sudo gem install cocoapods。
如果老版本升級cocoapods的時候提示Operation not permitted - /usr/bin/xcodeproj,改用命令sudo gem install -n /usr/local/bin cocoapods --pre就可以了。
卸載CocoaPods
卸載CocoaPods的命令是sudo gem uninstall cocoapods
卸載CocoaPods
執行完命令后,最下面打印Successfully uninstalled cocoapods字樣就代表已經成功卸載了。
CocoaPods Mac App的安裝和使用
CocoaPods桌面應用版下載地址:https://cocoapods.org/app
打開應用會提示你是否安裝命令行工具,選擇install就也可以在命令行使用Pod了。省去了上面的步驟們,方便快捷的使用CocoaPods。
是否安裝命令行工具
現在假如要給一個Test項目加入第三方庫
1.選擇File-New Podfile from Xcode Project,去選擇項目的Project文件。
選擇項目
2.填寫自動生成的Podfile,并且安裝。
Podfile
然后就可以去打開工程了,是不是比命令行簡單多了。
注意:Cocoapods.app 刪掉并執行命令可能會報錯:Unable to locate the CocoaPods.app application bundle. Please ensure the application is available and launch it at least once
錯誤信息.png
這時候只要執行sudo gem install -n /usr/local/bin cocoapods命令就可以了。
CocoaPods官方使用指南
鏈接:https://guides.cocoapods.org/
有什么不了解的或者遇到錯誤可以去這里查看一下。
XCode的CocoaPods插件
CocoaPods-xcode-plugin是一個XCode的插件,可以很方便的在Xcode通過pods安裝各種第三方庫。前提是終端已經安裝好CocoaPods,使用方法大概如下:
CocoaPods插件使用