cocapods最新安裝教程

引用：http://www.jianshu.com/p/b64b4fd08d3c

cocoapods官網：https://guides.cocoapods.org

1、什麼是CocoaPods

每種語言發展到一個階段，就會出現相應的依賴管理工具，例如 Java 語言的 Maven，nodejs 的 npm。隨着 iOS 開發者的增多，業界也出現了爲 iOS 程序提供依賴管理的工具，它的名字叫作：CocoaPods。

CocoaPods項目的源碼 在 Github 上管理。該項目開始於 2011 年 8 月 12 日，通過多年發展，如今已經成爲 iOS 開發事實上的依賴管理標準工具。開發 iOS 項目不可避免地要使用第三方開源庫，CocoaPods 的出現使得咱們能夠節省設置和更新第三方開源庫的時間。

2、爲何要使用CocoaPods

在使用CocoaPods以前，開發項目須要用到第三方開源庫的時候，咱們須要

1.把開源庫的源代碼複製到項目中

2.添加一些依賴框架和動態庫

3.設置-ObjC，-fno-objc-arc等參數

4.管理他們的更新

在使用CocoaPods後，咱們只須要把用到的開源庫放到一個名爲Podfile的文件中，而後執行pod install就能夠了，Cocoapods就會自動將這些第三方開源庫的源碼下載下來，而且爲咱們的工程設置好響應的系統依賴和編譯參數。

3、CocoaPods的原理

CocoaPods的原理是將全部的依賴庫都放到另外一個名爲Pods的項目中，而後讓主項目依賴Pods項目，這樣，源碼管理工做都從主項目移到了Pods項目中。Pods項目最終會編譯成一個名爲libPods.a的文件，主項目只須要依賴這個.a文件便可。

4、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://ruby.taobao.org/ #(設置當前ruby的源爲我天朝的)  已廢

gem sources -a https://gems.ruby-china.com/

gem sources -l #(再次查看當前ruby的源)

若是Terminal輸出：

*** CURRENT SOURCES ***

https://ruby.taobao.org/

就證實ruby的軟件源已經設置OK了。

2.設置gem爲最新版本

若是gem太老，能夠嘗試用以下命令升級gem：

在Terminal輸入如下命令：

sudo gem update --system

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

3.執行安裝CocoaPods命令

注意：OS X 10.11 升級，雖然官方聲稱只是一個小的升級，但對於開發者而言，cocoapods須要從新安裝，但按照之前的安裝方式，在Terminal輸入如下命令：

sudo gem install  cocoapods

若是報如下錯誤：

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

Operation not permitted - /usr/bin/xcodeproj

解決方案1：

執行下面的命令並重啓

sudo nvram boot-args="rootless=0"

sudo reboot

重啓以後, 執行這個命令檢查

sudo gem install cocoapods -V

若是依舊有錯誤，使用第二個方案

解決方案2：

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

pod setup

還有一點須要注意，pod setup在執行時，會輸出Setting up CocoaPods master repo，可是會等待比較久的時間。這步實際上是 Cocoapods 在將它的信息下載到 ~/.cocoapods目錄下，若是你等過久，能夠試着 cd 到那個目錄，用du -sh *來查看下載進度。

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

5、Cocoapods的使用

隨便以一種方式新建一個名爲Podfile的文件放到你的工程根目錄下（不能寫成別的名字，也能夠本身在工程根目錄裏面直接新建）

Podfile文件內容的格式應該以下：

platform :ios, '8.0' #(註明你的開發平臺以及版本，'8.0'忽略不寫即爲最新版本)

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

pod 'SDWebImage', '~> 3.7.2'

而後在Terminal進入工程所在的根目錄（工程根目錄）中執行 ：

pod install

這樣，AFNetworking和SDWebImage就已經下載完成而且設置好了編譯參數和依賴，之後使用的時候切記以下兩點：

1.今後之後須要使用Cocoapods生成的 .xcworkspace文件來打開工程，而不是使用之前的.xcodeproj文件

2.每次更改了Podfile文件，都須要從新執行一次pod update命令

查找第三方庫：

你若是不知道 cocoaPods 管理的庫中，是否有你想要的庫，那麼你能夠經過 pod search 命令進行查找，如下是我用 pod search json 查找到的全部可用的庫：

能夠在Terminal中輸入：

pod search AFNetworking

回車以後就能夠看到和你搜索的關鍵字相關的一些庫類，如圖：

關於 Podfile.lock

當你執行pod install以後，除了 Podfile 外，CocoaPods 還會生成一個名爲Podfile.lock的文件，Podfile.lock 應該加入到版本控制裏面，不該該把這個文件加入到.gitignore中。由於Podfile.lock會鎖定當前各依賴庫的版本，以後若是屢次執行pod install 不會更改版本，要pod update纔會改Podfile.lock了。這樣多人協做的時候，能夠防止第三方庫升級時形成你們各自的第三方庫版本不一致

 

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

全部項目的Podspec文件都託管在https://github.com/CocoaPods/Specs,

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

這個索引文件比較大,因此第一次更新時很是慢.

友好人士在國內的服務器創建了Cocoapods索引庫的鏡像,

因此執行索引跟新操做時候會快不少.具體操做方法以下:

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的方法