[TOC]
# 1. 什么是 Podfile？
Podfile 是一个规范，用于描述一个或多个 Xcode 项目的目标依赖关系。 该文件应该简单地命名为 Podfile 。 指南中的所有示例均基于 CocoaPods 1.0 及更高版本。
Podfile 可以非常简单，例如将 Alamofire 添加到单个目标中：
~~~
target 'MyApp' do
use_frameworks!
pod 'Alamofire', '~> 3.0'
end
~~~
一个链接到应用程序及其测试包的更复杂的 Podfile 的示例:
~~~
source 'https://github.com/CocoaPods/Specs.git'
source 'https://github.com/Artsy/Specs.git'
platform :ios, '9.0'
inhibit_all_warnings!
target 'MyApp' do
pod 'GoogleAnalytics', '~> 3.1'
# Has its own copy of OCMock
# and has access to GoogleAnalytics via the app
# that hosts the test target
target 'MyAppTests' do
inherit! :search_paths
pod 'OCMock', '~> 2.0.1'
end
end
post_install do |installer|
installer.pods_project.targets.each do |target|
puts target.name
end
end
~~~
如果您希望多个目标共享相同的 pods，请使用 `abstract_target`。
~~~
# There are no targets called "Shows" in any Xcode projects
abstract_target 'Shows' do
pod 'ShowsKit'
pod 'Fabric'
# Has its own copy of ShowsKit + ShowWebAuth
target 'ShowsiOS' do
pod 'ShowWebAuth'
end
# Has its own copy of ShowsKit + ShowTVAuth
target 'ShowsTV' do
pod 'ShowTVAuth'
end
end
~~~
在 Podfile 的根部有隐含的抽象目标，所以你可以将上面的例子写成：
~~~
pod 'ShowsKit'
pod 'Fabric'
# Has its own copy of ShowsKit + ShowWebAuth
target 'ShowsiOS' do
pod 'ShowWebAuth'
end
# Has its own copy of ShowsKit + ShowTVAuth
target 'ShowsTV' do
pod 'ShowTVAuth'
end
~~~
## 1.1 从 0.x 迁移到 1.0
我们有一篇[博客文章](http://blog.cocoapods.org/CocoaPods-1.0/)解释深度变化。
## 1.2 指定 pod 版本
从项目开始时，您很可能会想要使用最新版本的Pod。 如果是这种情况，只需省略版本要求即可。
~~~
pod 'SSZipArchive'
~~~
在稍后的项目中，您可能想要冻结到特定版本的 Pod，在这种情况下，您可以指定该版本号。
~~~
pod 'Objection', '0.9'
~~~
除了没有版本或特定版本，还可以使用逻辑运算符：
* `'> 0.1'` 任何高于 0.1 的版本
* `'> = 0.1'` 版本 0.1 和任何更高版本
* `'<0.1'` 低于 0.1 的任何版本
* `'<= 0.1'` 版本 0.1 和任何更低的版本
除了逻辑运算符 CocoaPods 还有一个乐观的运算符 `〜>` ：
* `'〜> 0.1.2'` 版本 0.1.2 和版本高达 0.2，不包括 0.2 和更高版本
* `'〜> 0.1'` 版本 0.1 和版本高达 1.0，不包括 1.0 和更高版本
* `'〜> 0'` 版本 0 和更高版本，这基本上与没有它相同。
有关版本控制策略的更多信息，请参阅：
* [语义版本](http://semver.org/)
* [RubyGems 版本控制策略](http://guides.rubygems.org/patterns/#semantic-versioning)
* 谷歌有一个关于它如何工作的伟大视频：["CocoaPods and the Case of the Squiggly Arrow (Route 85)"](https://www.youtube.com/watch?v=x4ARXyovvPc)
# 2. 使用机器本地文件夹中的文件
如果你想开发Pod与其客户端项目，你可以使用` :path`。
~~~
pod 'Alamofire', :path => '~/Documents/Alamofire'
~~~
使用此选项，CocoaPods将假定给定的文件夹是Pod的根目录，并将直接从Pods项目中的文件链接文件。 这意味着您的编辑将在CocoaPods安装之间持续存在。 引用的文件夹可以是您最喜欢的SCM的 checkout，甚至可以是当前仓库的git子模块。
> 请注意，Pod 文件的 podspec 应该位于指定的文件夹中。
## 2.1 资源仓库的根目录中的 podspec
有时你可能想要使用 Pod 的最新版本，特定版本或你自己的分支。 如果是这种情况，您可以使用您的 pod 声明来指定。
要使用仓库的主分支：
~~~
pod 'Alamofire', :git => 'https://github.com/Alamofire/Alamofire.git'
~~~
要使用repo的不同分支：
~~~
pod 'Alamofire', :git => 'https://github.com/Alamofire/Alamofire.git', :branch => 'dev'
~~~
要使用仓库标签：
~~~
pod 'Alamofire', :git => 'https://github.com/Alamofire/Alamofire.git', :tag => '3.1.1'
~~~
或者指定一个提交：
~~~
pod 'Alamofire', :git => 'https://github.com/Alamofire/Alamofire.git', :commit => '0f506b1c45'
~~~
但是，需要注意的是，这意味着该版本将不得不满足其他 Pod 的其他依赖项。
预计 podspec 文件位于 repo 的根目录中，如果此库的 repo 中没有 podspec 文件，则必须使用下面各节中概述的方法之一。
# 3. 外部资源
* [Non-trivial Podfile in Artsy/Eigen](https://github.com/artsy/eigen/blob/master/Podfile)
* [Podfile for a Swift project in Artsy/Eidolon](https://github.com/artsy/eidolon/blob/master/Podfile)
