iOS開發 CocoaPods安裝、移除和常見問題

CocoaPods是iOS項目標依靠辦理東西，閃開發者可以快速集當作第三方開源庫和添加依靠庫。跟著Ruby、Gem、Mac OSX、Xcode和CocoaPods的更新，CocoaPods的安裝方式也跟著轉變，當然也會發生各類如許的問題。

東西/原料

Mac OSX操作系統：OS X 10.11.5
編譯情況：Xcode 7.3.1
Mac自帶終端

搭建CocoaPods情況

1
打開Mac自帶“終端”
在Launchpad找到“其他”軟件文件夾，找到終端打開。
2
替代Ruby的默認源，移除rubygems.org和淘寶的，改為ruby-china源
gem sources --remove https://rubygems.org/
gem sources --remove https://ruby.taobao.org
gem source -a https://gems.ruby-china.com
3
驗證是否當作功替代Ruby的默認源
gem sources -l
最后只保留：
https://gems.ruby-china.com
4
更新Mac 的Gem，Gem是辦理Ruby庫和法式的尺度包
sudo gem update --system
或者（Mac OSX 10.11之后）
sudo gem update -n /usr/local/bin —system
然后輸入辦理員權限暗碼（看不到輸入成果的，輸完暗碼之后直接回車）
5
完當作安裝CocoaPods
sudo gem install cocoapods
或者（Mac OSX 10.11之后）
sudo gem install -n /usr/local/bin cocoapods

為iOS項目添加CocoaPods辦理庫

1
查找本身需要添加的第三方庫
pod search + 庫名
如輸入：pod search AFNetworking 后，期待返回所有合適搜刮前提的成果。可以直接操縱的是：pod 'AFNetworking', '~> 3.1.0'
2
找到項目文件路徑
在終端輸入cd+空格，然后拖動項目文件夾到終端，主動生當作路徑。
3
建立并編纂Podfile文件（可以終端操作，也可以直接手動操作）
終端輸入：vim podfile 或者 pod init（保舉）
編纂文件，沒有文件就主動在當前目次添加一個文件再編纂。輸入內容：
platform :ios, '8.0'
target “target名稱” do
pod 'AFNetworking', '~> 3.1.0'
end
按Esc退出編纂，然后按Shift +冒號，輸入wq退出文件編纂。
4
為項目導入第三方庫和相關依靠庫
終端輸入：pod install
然后耐煩期待下載第三方庫，若是文件年夜，可能要花長時候。終端會打印進度的。
5
至此，添加已經完當作。可以看到項目目次里面多了4個文件，今后運行工程都利用.xcworkspace文件，而不再用.xcodeproj了。

移除CocoaPods

1
編纂Podfile文件，斷根里面所有庫，然后終端輸入：pod install。這時會清空第三方庫和相關依靠庫。
2
刪除之前的4個文件，Podfile、Podfile.lock、Pods文件夾和.xcworkspace文件。
3
然后打開.xcodeproj，刪除項目中的libpods.a和Pods.xcconfig引用。
4
TARGETS - Build Phases 刪除有關pods的選項，至此完當作刪除。

常見問題

1
Error fetching http://ruby.taobao.org/:
bad response Not Found 404 (http://ruby.taobao.org/specs.4.8.gz)
申明：
鏈接不到Ruby淘寶源，常見的404錯誤，可能因為https替代http了。所以gem sources -a http://ruby.taobao.org/ 需要替代當作：gem sources -a https://ruby.taobao.org/
2
ERROR: While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/update_rubygems
申明：
Mac OSX 10.11不克不及利用sudo gem update —system了，需要替代當作：sudo gem update-n /usr/local/bin —system
3
ERROR: While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/pod
申明：
Mac OSX 10.11不克不及利用sudo gem install cocoapods了，需要替代當作：sudo gem install -n /usr/local/bin cocoapods
4
[!] Unable to add a source with url `https://github.com/CocoaPods/Specs.git` named `master-1`. You can try adding it manually in `~/.cocoapods/repos` or via `pod repo add`.
申明：
因為安裝了多個Xcode導致路徑變了，需要變換路徑：sudo xcode-select -switch /Applications/Xcode6.4/Xcode.app
5
The dependency `` is not used in any concrete target
申明：
Podfile進級之后到1.0.0版本，Pod里的內容必需明白指出所用第三方庫的target，所以在podfile文件需要明白：
target “YOUR_TARGRT_NAME” do
...
end
6
Error installing cocoapods:activesupport requires Ruby version >= 2.2.2.
申明：
在安裝cocoapods過程中提醒需要Ruby的版本在2.2.2以上。
查看當前Ruby版本，輸入指令：ruby -v
解決方式：
經由過程rvm安裝新版Ruby，輸入指令：curl -L get.rvm.io | bash -s stable
重裝rvm，輸入指令：rvm reload
然后安裝Ruby，輸入指令：rvm install ruby
若是呈現：Requirements installation failed with status: 1.則需要輸入：
第一行：ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
第二行：rvm autolibs read-only # read more here:https://rvm.io/rvm/autolibs
第三行，再次安裝：rvm install ruby
然后終端就瘋狂的起頭下載了。
7
[!] Unable to find a pod with name, author, summary, or description matching `xxx`
申明：
搜刮庫：pod search xxx報錯；
是search_index.json這個文件的原因，可以將其刪除，然后從頭生當作便可解決此問題。
解決方式：
輸入指令：rm ~/Library/Caches/CocoaPods/search_index.json
完當作即可從頭搜刮。