一. CocoaPod相關(guān)介紹
每種語言發(fā)展到一個階段，就會出現(xiàn)相應(yīng)的依賴管理工具，例如 Java 語言的 Maven，nodejs 的 npm。隨著 iOS 開發(fā)者的增多，業(yè)界也出現(xiàn)了為 iOS 程序提供依賴管理的工具，它的名字叫做：CocoaPods。CocoaPods項(xiàng)目的源碼 在 Github 上管理。該項(xiàng)目開始于 2011 年 8 月 12 日，經(jīng)過多年發(fā)展，現(xiàn)在已經(jīng)成為 iOS 開發(fā)事實(shí)上的依賴管理標(biāo)準(zhǔn)工具。開發(fā) iOS 項(xiàng)目不可避免地要使用第三方開源庫，CocoaPods 的出現(xiàn)使得節(jié)省設(shè)置和更新第三方開源庫的時間
- 使用CocoaPods
在以前，開發(fā)項(xiàng)目需要用到第三方開源庫的時候，需要：
- 把開源庫的源代碼復(fù)制到項(xiàng)目中
- 添加一些依賴框架和動態(tài)庫
- 設(shè)置-ObjC，-fno-objc-arc等參數(shù)
- 管理他們的更新
在使用CocoaPods后，我們只需要把用到的開源庫放到一個名為Podfile的文件中，然后執(zhí)行pod install就可以了，Cocoapods就會自動將這些第三方開源庫的源碼下載下來，并且為我們的工程設(shè)置好響應(yīng)的系統(tǒng)依賴和編譯參數(shù)。
- CocoaPods原理
CocoaPods原理是將所有的依賴庫都放到另一個名為 Pods的項(xiàng)目中，然后讓主項(xiàng)目依賴Pods項(xiàng)目，這樣，源碼管理工作都從主項(xiàng)目移到 Pods項(xiàng)目中。Pods項(xiàng)目最終會編譯成一個名為 libPods.a的文件，主項(xiàng)目只需要依賴這個.a文件即可
- Ruby相當(dāng)于一個環(huán)境， 系統(tǒng)默認(rèn)有個版本的Ruby環(huán)境，盡量別安裝其他的軟件在系統(tǒng)的Ruby上，隔離好
- Gem相當(dāng)于Ruby的包管理工具。類似于node下的npm, 用來安裝類似CocoaPods這樣的軟件
- Rvm是Ruby的版本管理工具, 用來安裝， 切換Ruby環(huán)境
- CocoaPods是負(fù)責(zé)管理iOS項(xiàng)目中第三方框架。CocoaPods的項(xiàng)目源碼在Github上管理。項(xiàng)目從2011年8月12日開始,CocoaPods的出現(xiàn)使得我們可以節(jié)省設(shè)置和更新第三方開源庫的時間
二.準(zhǔn)備安裝
1. 更換gem軟件源
因?yàn)榕f的軟件源rubygems.org被屏蔽了，所以要更換.
移除舊的軟件源:
$ gem sources --remove https://rubygems.org/
添加新的軟件源:
$ gem sources -a https://gems.ruby-china.com/
為了驗(yàn)證你的軟件源是不是RubyChina,可以用以下命令查看：
$ gem sources -l
只有在終端中出現(xiàn)下面文字才表明你上面的命令是成功的:
*** CURRENT SOURCES ***
https://gems.ruby-china.com/
2. 更新gem本身(指定版本的話， 在后面加版本號如： gem update --system 2.7.6)
sudo gem update --system
接下來輸入系統(tǒng)密碼就可以安裝了，輸入密碼時不會顯示的，輸完回車就行了
- 更多Gem和Rvm命令可以參考:
Gem和Rvm命令
三.開始安裝CocoaPods
接下來就可以安裝CocoaPods了
1. 安裝gem下的某個包(例如cocoapod)
如果這個命令報以下錯:sudo gem install cocoapods
就更換以下命令:
安裝過程如下:sudo gem install -n /usr/local/bin cocoapods
安裝完后你可以輸入下面的命令查看是否成功，當(dāng)前CocoaPods版本為1.0.0
pod --version
安裝完成后就可以使用pod開頭的命令了
2. 設(shè)置倉庫
就是把所有上傳到cocoapods的第三方框架下載每個版本和網(wǎng)絡(luò)地址以及一些其他描述信息到本地，因?yàn)榉?wù)器在國外所以比較蛋疼
執(zhí)行以下命令:
pod setup
出現(xiàn)Setting up CocoaPods master repo (這個提示是正在安裝的提示)，說明Cocoapods在將它的信息下載到~/.cocoapods里
cd 到該目錄里，用du -sh *命令來查看文件大小，每隔幾分鐘查看一次，這個目錄最終大小是100多M，就是完成了
cd ~/.cocoapods
du -sh *
倉庫里裝的東西如下:
為了確定CocoaPods是否能正常使用，可以用CocoaPods的搜索功能驗(yàn)證一下。在終端中輸入：
$ pod search AFNetworking
如果能搜索到AFNetworking庫，就說明大功告成啦！
- 如果報錯：Unable to find a pod with name, author, summary, or description matching
AFNetworking
執(zhí)行如下步驟：
1：pod repo remove master
2：cd ~/.cocoapods/repos
3：git clone --depth 1 https://github.com/CocoaPods/Specs.git master
4：rm ~/Library/Caches/CocoaPods/search_index.json
5：pod search afnetworking
執(zhí)行完之后就可以正常搜索了。
- 如果你的網(wǎng)速比較好,安裝完成了,請直接跳到 --> 四.使用CocoaPods
網(wǎng)速不好，老是報錯的看這里！
之前我也嘗試過使用CocoaPods的鏡像索引使用國內(nèi)的鏡像，但是沒有效果，oschina的應(yīng)該是因?yàn)槿肆髁吭L問大，所以設(shè)置了驗(yàn)證碼，而gitcafe馬上要停止服務(wù)了，所以沒辦法了
一直報錯，503、argumenterror , syntax error on line 4, col 0: min:0.29.0 等等，都是你的網(wǎng)絡(luò)原因?qū)е碌?/p>
這就要手動下載配置，可以在上面的oschina和gitcafe鏈接中下載，也可以在github上下載(不過比較慢)
更新一個手動下載到本地的方法!!!
采用國內(nèi)的免費(fèi)服務(wù)器同步后下載:鏈接
下載完成后你可以輸入
pod setup
然后control+c 中斷，目的是讓他幫你創(chuàng)建文件夾
當(dāng)然你也可以手動創(chuàng)建文件夾，但是文件夾是隱藏的所以你需要在Finder頁面使用快捷鍵command + shift + .
隨后在Finder點(diǎn)擊 前往>前往文件夾 中前往文件，輸入下面指令
~/.cocoapods
對比一下可以發(fā)現(xiàn)我們下載的文件和安裝后的文件只是改了一下文件名，把最外面的文件改為master，然后扔到~/.cocoapods/repos文件夾下就完成設(shè)置了
下載進(jìn)度說明:
下載中如果不放心，可以新建一個終端窗口分別輸入下面兩條命令查看下載了多少，下載完成的文件大小如下(2016.5.25日下載的文件)
cd ~/.cocoapods
du -sh *
四.使用CocoaPods
1. 創(chuàng)建Podfile文件
方法1:
使用cd命令到你項(xiàng)目所在目錄，然后在當(dāng)前目錄下執(zhí)行pod init命令創(chuàng)建Podfile
$ pod init
你會發(fā)現(xiàn)當(dāng)前目錄下面多了一個Podfile文件
使用Xcode打開Podfile文件,進(jìn)行編輯
方法2:
使用cd命令到你項(xiàng)目所在目錄，然后在當(dāng)前目錄下執(zhí)行vim Podfile命令,就會在終端中編輯Podfile文件
vim Podfile
進(jìn)入Podfile后輸入 i 編輯狀態(tài)(可以查看左下角有個INSERT)，進(jìn)入輸入下面命令
platform :ios, '9.3'
use_frameworks!
target 'Test' do
pod 'SDWebImage', '~>3.7.6'
pod 'Masonry', '~>1.0.0'
end
- platform 是平臺
- ios, '9.3' 是指定所支持系統(tǒng)和最低版本
- Test 填寫你的target名稱,pod 后面的就是你需要的框架,'~>后面就是指定的版本',不指定默認(rèn)下載最新的
- Podfile里面的命令一定要按照這個格式,否則會報錯 isnot usedin any concrete target
寫完后按Esc 然后:wq 意思是保存并退出
2. 下載第三方庫
接著執(zhí)行以下命令就會把Podfile文件里的第三方庫下載到當(dāng)前文件夾下，并且創(chuàng)建.xcworkspace
pod install
出現(xiàn)Pod installation Complete! There are 3 dependencies......就表示下載成功
接下來就可以打開Test(target名).xcworkspace文件編寫你的程序了
如果當(dāng)前項(xiàng)目已經(jīng)存在Podfile文件,就cd到Podfile文件所在的文件夾執(zhí)行以下命令更新第三方庫:
$ pod update
常用命令
重新安裝Podfile里的全部庫
pod install
更新Podfile里的全部庫
pod update
更新Podfile里的指定庫
pod update 庫名
更新本地倉庫
pod repo update
從本地已有倉庫重新安裝當(dāng)前項(xiàng)目中的所有庫(不更新本地倉庫)
pod install --verbose --no-repo-update
從本地已有倉庫更新當(dāng)前項(xiàng)目中的所有庫(不更新本地倉庫)
pod update --verbose --no-repo-update
- 如果想要知道cocoapods導(dǎo)入的框架的版本,可以使用xcode打開podfile.lock文件
- 其他問題可以參考:
Cocoapods的pod search無法搜索到類庫的解決辦法
CocoaPods更新第三方庫出錯的解決辦法
