一、簡介

開發IOS應用時，經常會用到一些第三方開源類庫，如JSONKit、AFNetWorking、QRCode等。一個類庫可能還會引用其它類庫。手動去一個個載入就顯得比較麻煩。而CocoaPods就是用來解決類庫引用問題的，它類似於PHP上的Composer、JAVA上的Maven，也許與Linux平臺的apt-get命令也有相似之處。 官網地址： https://cocoapods.org

二、安裝

CocoaPods需要先安裝好Ruby環境，預設應該是已經安裝的，這裡不再介紹Ruby安裝方式，直接介紹CocoaPods安裝。 命令列輸入

sudo gem install cocoapods
 

如果輸入密碼後很長時間沒有反應，或提示無法找到，可能地址被牆了，那要先輸入：

gem sources --remove https://rubygems.org/
//等有反應之後再敲入以下命令
gem sources -a https://gems.ruby-china.org/

gem sources -l

把映象改為國內的映象。
這時介面輸出：

*** CURRENT SOURCES ***

https://gems.ruby-china.org/

再執行安裝命令。 如果提示： Unable to resolve dependencies:cocoapods requires cocoapods-core(=0.35.0),... 則先執行：

sudo gem update --system
 

如果再提示： ERROR: While executing gem... (Errno::EPERM)    Operation not permitted - /usr/bin/xcodeproj 則執行：

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

安裝完後執行

pod install 命令 ----安裝倉庫。

也可以通過外掛安裝：（未測試）

三、ionic專案新增CocoaPods支援

1.  使用xcode開啟專案  2. 編輯文字

vim Podfile

# Uncomment this line to define a global platform for your project
platform :ios, '7.0'

target 'Demo' do

pod 'AFNetworking', '~> 2.0'
pod 'JSONModel', '~> 1.1.2'
pod '
 
[email protected]', '~> 0.0.4'

end

target 'DemoTests' do

end

然後命令列執行:pod install --verbose --no-repo-update

四、使用示例

1.專案裡引用QRCode 首先驗證QRCode是否支援CocoaPods

pod search QRCodeReaderViewController

輸出：

-> QRCodeReaderViewController (3.4.0)
   Simple QRCode reader for iOS 7 and over
   pod 'QRCodeReaderViewController', '~> 3.4.0'
   - Homepage: https://github.com/YannickL/QRCodeReaderViewController
   - Source:   https://github.com/yannickl/QRCodeReaderViewController.git
   - Versions: 3.4.0, 3.3.0, 3.2.3, 3.2.2, 3.2.1, 3.2.0, 3.1.0, 3.0.0, 2.0.0,
   1.0.1, 1.0.0 [master repo]

到專案的.xcodeproj目錄，建立Podfile檔案：

touch Podfile

vim Podfile

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '7.0'
pod 'QRCodeReaderViewController', '~> 3.4.0'

儲存後，輸入命令：

pod install

安裝完成後，輸入命令：

open MyProject.xcworkspace

開啟專案，不要用.xcodeproj開啟專案。 以後需要升級使用的開源庫時，只需要輸入： pod update 即可自動完成更新。

四 刪除類庫

1.刪除Poads裡的類庫資料夾 2.把Podfile裡刪除對應行 3.重新執行pod install命令。

五 其它命令

有時經常卡住，可能要這樣清理一下。如果xcode升級，這裡有時也要這麼操作一下：

pod repo remove master --刪除主倉庫

pod setup --重建安裝

pod install

跳過更新倉庫的操作直接安裝類庫 

pod install --verbose --no-repo-update

pod update --verbose --no-repo-update

方法2：

執行：

rm -rf ~/.cocoapods/repos/masterpod repo remove masterpods install --verbose

可以看到下載提示。 確認是否在執行：

cd ~/.cocoapods
du -sh

看值一直在變大，就是正在下載。

方法3：

下載安裝github desktop登陸github，把專案https://github.com/CocoaPods/Specs  fork到自己的github賬戶下開啟github desktop , clone Specs到本地電腦改名為master，放到~/.cocoapods/repos/master

其它問題處理：

執行pod install時

提示An error occurred while processing the post-install hook of the Podfile.undefined method `project` for #<Pod::Installer:0x007ffa309af2e0> 處理方法： 開啟Podfile,把裡面的 project 改為 pods_project

不支援i386

工程在模擬器上編譯報錯，不支援i386，Cocoapods確實還不支援64位模擬器，解決辦法：

方法1：

1.build active architecture only 在debug的時候設定成YES，不要在release的時候用模擬器   

2.other linker flags 加一個 $(inherited)

pods root也可能需要設定為$(inherited)

方法2：（未測試）

點選專案檔案 project.xcodeproj，右鍵`顯示包內容`，用文字編輯器開啟`project.pbxproj`，刪除`OTHER_LDFLAGS`的地方，儲存，回到 Xcode，編譯通過。

需要對第三方庫修改

先把git fork到自己賬號下，然後編輯Podfile：

platform :ios, '7.0'
pod '要匯入的庫', :git => 'https://github.com/我的github/要匯入的庫' 

Xcode 提示Pod錯誤

diff: /../Podfile.lock: No such file or directory

diff: /Manifest.lock: No such file or directory

error: The sandbox is not in sync with the Podfile.lock. Run 'pod install' or update your CocoaPods installation.

1.關閉Xcode，重新執行pod install，之後再重新開啟Xcode執行。

2.刪除一下檔案

xcworkspace
Podfile.lock
Pods資料夾
~/Library/Developer/Xcode/DerivedData路徑下對應工程的資料夾

然後重新執行pod install

3.如果以上都不行 檢查Project->選擇Info tab->看看Configurations是不是被設定為 None了，如果是None的話改為Pods

4.右鍵工程根目錄下的xxx.xcodeproj檔案，顯示包內容

雙擊開啟project.pbxproj檔案查詢"Pods-resources.sh", 把路徑改為如下紅框處：

解決方案參考：http://www.jianshu.com/p/4c3164fe552a