[TOC]
# 1. 什么是 CocoaPods
CocoaPods 為您的 Xcode 項目管理庫依賴項。
項目的依賴項在一個名為 Podfile 的文本文件中指定。 CocoaPods 將解決庫之間的依賴關系,獲取所得到的源代碼,然后將它們鏈接到一個 Xcode Workspace 中以構建您的項目。
最終目標是通過創建更集中的生態系統來提高第三方開源庫的可發現性和參與度。
# 2. 入門
## 2.1 安裝
CocoaPods 是用 Ruby 構建的,它可以在 macOS 上使用默認的Ruby來安裝。您可以使用Ruby版本管理器,但是我們建議您使用 macOS 上的標準 Ruby,除非您知道自己在做什么。
使用默認的Ruby安裝將要求您在安裝 gem 時使用 sudo。(不過,這只是gem安裝期間的一個問題。)
> 1. Gem 是 Ruby 模塊 的包管理器,叫做 Gems。gem 命令用于構建、上傳、下載以及安裝 Gem 包。
> 2. sudo 命令以系統管理者的身份執行指令
~~~
$ sudo gem install cocoapods
~~~
如果您在安裝過程中遇到任何問題,請訪問[本指南](https://guides.cocoapods.org/using/troubleshooting#installing-cocoapods)。
## 2.2 Sudo-less 安裝
如果您不希望授予此進程的 RubyGems 管理權限,那么可以通過將 `--user-install` 標志傳遞給 `gem install` 或通過配置 RubyGems 環境,讓 RubyGems 安裝到您的用戶目錄中。 后者在我們看來是最好的解決方案。 為此,請創建或編輯主目錄中的 .profile 文件,并添加或修改它以包含以下行:
~~~
export GEM_HOME=$HOME/.gem
export PATH=$GEM_HOME/bin:$PATH
~~~
請注意,如果您選擇使用 `--user-install` 選項,則仍然必須配置 `.profile` 文件以設置 PATH 或使用完整路徑前置的命令。 你可以通過命令 `gem which cocoapods` 找到 gem 安裝的地方。 例如,
~~~
$ gem install cocoapods --user-install
$ gem which cocoapods
/Users/eloy/.gem/ruby/2.0.0/gems/cocoapods-0.29.0/lib/cocoapods.rb
$ /Users/eloy/.gem/ruby/2.0.0/bin/pod install
~~~
## 2.3 更新 CocoaPods
要更新 CocoaPods,只需再次安裝 gem
~~~
$ [sudo] gem install cocoapods
~~~
或者預發布版本
~~~
$ [sudo] gem install cocoapods --pre
~~~
如果您最初使用 sudo 安裝了 cocoapods gem,則應該再次使用該命令。
稍后,當您通過 `installing pods` 積極使用 CocoaPods 時,如果CocoaPods X.X.X現有新版本可用,您將收到通知,請更新消息。
### 2.3.1 使用 CocoaPods Fork
有兩種方法可以做到這一點,使用 [Gemfile](https://guides.cocoapods.org/using/a-gemfile.html)(推薦)或使用正在討論或實施階段的 [development build](https://guides.cocoapods.org/using/unreleased-features) 。
# 3. 外部資源
* [CocoaPods at Treehouse](http://teamtreehouse.com/library/ios-tools/cocoapods/cocoapods)