最新 macOS Sierra 10.12.3 安裝CocoaPods及使用詳解

cocoapods官網(wǎng):https://guides.cocoapods.org

一、什么是CocoaPods

每種語言發(fā)展到一個階段,就會出現(xiàn)相應(yīng)的依賴管理工具,例如 Java 語言的 Maven,nodejs 的 npm。隨著 iOS 開發(fā)者的增多,業(yè)界也出現(xiàn)了為 iOS 程序提供依賴管理的工具,它的名字叫做:CocoaPods。

CocoaPods項目的源碼 在 Github 上管理。該項目開始于 2011 年 8 月 12 日,經(jīng)過多年發(fā)展,現(xiàn)在已經(jīng)成為 iOS 開發(fā)事實上的依賴管理標(biāo)準(zhǔn)工具。開發(fā) iOS 項目不可避免地要使用第三方開源庫,CocoaPods 的出現(xiàn)使得我們可以節(jié)省設(shè)置和更新第三方開源庫的時間。

二、為什么要使用CocoaPods

在使用CocoaPods之前,開發(fā)項目需要用到第三方開源庫的時候,我們需要

1.把開源庫的源代碼復(fù)制到項目中

2.添加一些依賴框架和動態(tài)庫

3.設(shè)置-ObjC,-fno-objc-arc等參數(shù)

4.管理他們的更新

在使用CocoaPods后,我們只需要把用到的開源庫放到一個名為Podfile的文件中,然后執(zhí)行pod install就可以了,Cocoapods就會自動將這些第三方開源庫的源碼下載下來,并且為我們的工程設(shè)置好響應(yīng)的系統(tǒng)依賴和編譯參數(shù)。

三、CocoaPods的原理

CocoaPods的原理是將所有的依賴庫都放到另一個名為Pods的項目中,然后讓主項目依賴Pods項目,這樣,源碼管理工作都從主項目移到了Pods項目中。Pods項目最終會編譯成一個名為libPods.a的文件,主項目只需要依賴這個.a文件即可。

四、CocoaPods的安裝

CocoaPods可以方便地通過Mac自帶的RubyGems安裝。

打開Terminal(Mac電腦自帶的終端),然后按照以下提示操作即可:

1.設(shè)置ruby的軟件源

這是因為ruby的軟件源rubygems.org因為使用亞馬遜的云服務(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太老,可以嘗試用如下命令升級gem:

在Terminal輸入以下命令:

sudo gem update --system

升級成功后會提示: Latest version currently installed. Aborting.

3.執(zhí)行安裝CocoaPods命令

注意:OS X 10.11 升級,雖然官方聲稱只是一個小的升級,但對于開發(fā)者而言,cocoapods需要重新安裝,但按照以前的安裝方式,在Terminal輸入以下命令:

sudo gem install? cocoapods

如果報以下錯誤:

ERROR:? While executing gem ... (Errno::EPERM)

Operation not permitted - /usr/bin/xcodeproj

解決方案1:

執(zhí)行下面的命令并重啟

sudo nvram boot-args="rootless=0"

sudo reboot

重啟之后, 執(zhí)行這個命令檢查

sudo gem install cocoapods -V

如果依舊有錯誤,使用第二個方案

解決方案2:

sudo gem install -n /usr/local/bin cocoapods

pod setup

還有一點需要注意,pod setup在執(zhí)行時,會輸出Setting up CocoaPods master repo,但是會等待比較久的時間。這步其實是 Cocoapods 在將它的信息下載到 ~/.cocoapods目錄下,如果你等太久,可以試著 cd 到那個目錄,用du -sh *來查看下載進(jìn)度。

安裝成功后,你會看到:Setup completed

五、Cocoapods的使用

隨便以一種方式新建一個名為Podfile的文件放到你的工程根目錄下(不能寫成別的名字,也可以自己在工程根目錄里面直接新建)

Podfile文件內(nèi)容的格式應(yīng)該如下:

platform :ios, '8.0' #(注明你的開發(fā)平臺以及版本,'8.0'忽略不寫即為最新版本)

pod 'AFNetworking', '~> 2.5.3' #('~> 2.5.3'為版本號,忽略不寫即為最新版本)

pod 'SDWebImage', '~> 3.7.2'

然后在Terminal進(jìn)入工程所在的根目錄(工程根目錄)中執(zhí)行 :

pod install

這樣,AFNetworking和SDWebImage就已經(jīng)下載完成并且設(shè)置好了編譯參數(shù)和依賴,以后使用的時候切記如下兩點:

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 還會生成一個名為Podfile.lock的文件,Podfile.lock 應(yīng)該加入到版本控制里面,不應(yīng)該把這個文件加入到.gitignore中。因為Podfile.lock會鎖定當(dāng)前各依賴庫的版本,之后如果多次執(zhí)行pod install 不會更改版本,要pod update才會改Podfile.lock了。這樣多人協(xié)作的時候,可以防止第三方庫升級時造成大家各自的第三方庫版本不一致


附:如何使用CocoaPods的鏡像索引:

所有項目的Podspec文件都托管在https://github.com/CocoaPods/Specs,

第一次執(zhí)行pod setup時,CocoaPods會將這些podspec索引文件更新到本地的~/.cocoapods目錄下,

這個索引文件比較大,所以第一次更新時非常慢.

友好人士在國內(nèi)的服務(wù)器建立了Cocoapods索引庫的鏡像,

所以執(zhí)行索引跟新操作時候會快很多.具體操作方法如下:

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上的鏡像。

推薦閱讀:

CocoaPods安裝和使用教程

用CocoaPods做iOS程序的依賴管理

CocoaPods極簡入門指南

CocoaPods的安裝使用和常見問題

2016-10-8號更新

CocoaPods的安裝以及遇到的坑

終端安裝cocoaPods的方法

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

推薦閱讀更多精彩內(nèi)容