轉(zhuǎn)載自http://www.reibang.com/p/b64b4fd08d3c
《最新Mac OS X 10.11.1 安裝cocoapods及使用詳解》( 分享自 @jianshuio )
cocoapods官網(wǎng):https://cocoapods.org
一恃疯、什么是CocoaPods
每種語言發(fā)展到一個(gè)階段屯烦,就會(huì)出現(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è)置和更新第三方開源庫的時(shí)間。
二互纯、為什么要使用CocoaPods
在使用CocoaPods之前瑟幕,開發(fā)項(xiàng)目需要用到第三方開源庫的時(shí)候,我們需要
1.把開源庫的源代碼復(fù)制到項(xiàng)目中
2.添加一些依賴框架和動(dòng)態(tài)庫
3.設(shè)置-ObjC留潦,-fno-objc-arc等參數(shù)
4.管理他們的更新
在使用CocoaPods后只盹,我們只需要把用到的開源庫放到一個(gè)名為Podfile的文件中,然后執(zhí)行pod install就可以了兔院,Cocoapods就會(huì)自動(dòng)將這些第三方開源庫的源碼下載下來殖卑,并且為我們的工程設(shè)置好響應(yīng)的系統(tǒng)依賴和編譯參數(shù)。
三坊萝、CocoaPods的原理
CocoaPods的原理是將所有的依賴庫都放到另一個(gè)名為Pods的項(xiàng)目中孵稽,然后讓主項(xiàng)目依賴Pods項(xiàng)目许起,這樣,源碼管理工作都從主項(xiàng)目移到了Pods項(xiàng)目中菩鲜。Pods項(xiàng)目最終會(huì)編譯成一個(gè)名為libPods.a的文件园细,主項(xiàng)目只需要依賴這個(gè).a文件即可。
四接校、CocoaPods的安裝
CocoaPods可以方便地通過Mac自帶的RubyGems安裝猛频。
打開Terminal(Mac電腦自帶的終端),然后按照以下提示操作即可:
1.設(shè)置ruby的軟件源
這是因?yàn)閞uby的軟件源rubygems.org因?yàn)槭褂脕嗰R遜的云服務(wù)蛛勉,被我天朝屏蔽了鹿寻,需要更新一下ruby的源,過程如下:
` gem sources -l #(查看當(dāng)前ruby的源)
gem sources --remove https://rubygems.org/ #(移除當(dāng)前ruby的源)
gem sources -a https://ruby.taobao.org/ #(設(shè)置當(dāng)前ruby的源為我天朝的)
gem sources -l #(再次查看當(dāng)前ruby的源)
如果Terminal輸出:
*** CURRENT SOURCES ***
https://ruby.taobao.org/
就證明ruby的軟件源已經(jīng)設(shè)置OK了诽凌。
2.設(shè)置gem為最新版本
如果gem太老烈和,可以嘗試用如下命令升級(jí)gem:
在Terminal輸入以下命令:
sudo gem update --system
升級(jí)成功后會(huì)提示: Latest version currently installed. Aborting.
3.執(zhí)行安裝CocoaPods命令
注意:OS X 10.11 升級(jí),雖然官方聲稱只是一個(gè)小的升級(jí)皿淋,但對(duì)于開發(fā)者而言招刹,cocoapods需要重新安裝,但按照以前的安裝方式窝趣,在Terminal輸入以下命令:
sudo gem install? cocoapods
如果報(bào)以下錯(cuò)誤:
ERROR:? While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/xcodeproj
解決方案1:
執(zhí)行下面的命令并重啟
sudo nvram boot-args="rootless=0"
sudo reboot
重啟之后, 執(zhí)行這個(gè)命令檢查
sudo gem install cocoapods -V
如果依舊有錯(cuò)誤疯暑,使用第二個(gè)方案
解決方案2:
sudo gem install -n /usr/local/bin cocoapods
pod setup
還有一點(diǎn)需要注意,pod setup在執(zhí)行時(shí)哑舒,會(huì)輸出Setting up CocoaPods master repo妇拯,但是會(huì)等待比較久的時(shí)間。這步其實(shí)是 Cocoapods 在將它的信息下載到 ~/.cocoapods目錄下洗鸵,如果你等太久越锈,可以試著 cd 到那個(gè)目錄,用du -sh *來查看下載進(jìn)度膘滨。
安裝成功后,你會(huì)看到:Setup completed
五甘凭、Cocoapods的使用
隨便以一種方式新建一個(gè)名為Podfile的文件放到你的工程根目錄下(不能寫成別的名字,也可以自己在工程根目錄里面直接新建)
Podfile文件內(nèi)容的格式應(yīng)該如下:
OS X 10.11后這樣寫
platform :ios, '8.0' #(注明你的開發(fā)平臺(tái)以及版本火邓,'8.0'忽略不寫即為最新版本)
use_frameworks!
target ‘RunTest’ do
pod 'AFNetworking', '~> 2.5.3' #('~> 2.5.3'為版本號(hào)丹弱,忽略不寫即為最新版本)
pod 'SDWebImage', '~> 3.7.2'
end
然后在Terminal進(jìn)入工程所在的根目錄(工程根目錄)中執(zhí)行 :
pod install
這樣,AFNetworking和SDWebImage就已經(jīng)下載完成并且設(shè)置好了編譯參數(shù)和依賴铲咨,以后使用的時(shí)候切記如下兩點(diǎn):
1.從此以后需要使用Cocoapods生成的 .xcworkspace文件來打開工程躲胳,而不是使用以前的.xcodeproj文件
2.每次更改了Podfile文件,都需要重新執(zhí)行一次pod update命令
查找第三方庫:
你如果不知道 cocoaPods 管理的庫中纤勒,是否有你想要的庫坯苹,那么你可以通過 pod search 命令進(jìn)行查找,以下是我用 pod search json 查找到的所有可用的庫:
可以在Terminal中輸入:
pod search AFNetworking
回車之后就可以看到和你搜索的關(guān)鍵字相關(guān)的一些庫類摇天,如圖:
關(guān)于 Podfile.lock
當(dāng)你執(zhí)行pod install之后粹湃,除了 Podfile 外恐仑,CocoaPods 還會(huì)生成一個(gè)名為Podfile.lock的文件,Podfile.lock 應(yīng)該加入到版本控制里面再芋,不應(yīng)該把這個(gè)文件加入到.gitignore中菊霜。因?yàn)镻odfile.lock會(huì)鎖定當(dāng)前各依賴庫的版本坚冀,之后如果多次執(zhí)行pod install 不會(huì)更改版本济赎,要pod update才會(huì)改Podfile.lock了。這樣多人協(xié)作的時(shí)候记某,可以防止第三方庫升級(jí)時(shí)造成大家各自的第三方庫版本不一致
附:如何使用CocoaPods的鏡像索引:
所有項(xiàng)目的Podspec文件都托管在https://github.com/CocoaPods/Specs,
第一次執(zhí)行pod setup時(shí),CocoaPods會(huì)將這些podspec索引文件更新到本地的~/.cocoapods目錄下,
這個(gè)索引文件比較大,所以第一次更新時(shí)非常慢.
友好人士在國內(nèi)的服務(wù)器建立了Cocoapods索引庫的鏡像,
所以執(zhí)行索引跟新操作時(shí)候會(huì)快很多.具體操作方法如下:
pod repo remove master
pod repo add master https://gitcafe.com/akuandev/Specs.git
pod repo update
這是使用gitcafe上的鏡像,將以上代碼中的 https://gitcafe.com/akuandev/Specs.git
替換成 http://git.oschina.net/akuandev/Specs.git 即可使用oschina上的鏡像司训。
文/詹平(簡書作者)
原文鏈接:http://www.reibang.com/p/b64b4fd08d3c
著作權(quán)歸作者所有,轉(zhuǎn)載請(qǐng)聯(lián)系作者獲得授權(quán)液南,并標(biāo)注“簡書作者”壳猜。