[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)