Podfile 是什么？
Podfile 是一个说明文件，他描述了一个或多个 Xcode 工程中的 targets 的依赖。该文件应该简单的命名为 Podfile。本篇指导中的所有示例，都是基于 CocoaPods 1.0 版本的。

一个 Podfile 可以是非常简单的，一下将 Alamofire 添加到了一个单独的 target 中：
target 'MyApp' do
use_frameworks!
pod 'Alamofire', '~> 3.0'
end
注：由于 CocoaPods 是基于 ruby 开发的，这儿的这段代码，实际上是 ruby 语言中的 ‘闭包’。至于，ruby 语言不是这个系列的主题，之后会有新的系列介绍我学习，使用 ruby 的情况。

一下是一个比较复杂的 Podfile 链接了一个 app 和 他的测试包（test bundle）：
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
译者注：
1、source 'https://github.com/CocoaPods/Specs.git' 和 source 'https://github.com/Artsy/Specs.git' 这两行是表示 specs 文件的位置（url）。CocoaPods 其实是维护了一个 Specs 的索引，所有的 CocoaPods 中的 pod 中的 Spec 都包含在这个索引中，而 pod 中的源代码并没有包含在这个索引里。当你在自己的电脑上安装 CocoaPods 的时候，这份索引就复制到了你的电脑上。当你在命令行中运行 pod search xxx 的时候，实际上就是在这个索引中寻找 pod。pod install 的时候，实际上是根据 Podfile 提供要安装的 pod 名，版本；Podfile.lock 提供版本限定，然后找到相应的 spec ，通过 spec 中的描述，来进行安装的。
2、可以建立自己的 spec 索引。
3、post_install 是在 pod install ，安装完 pod 之后，执行的一段代码。这里执行的，是将安装的所有的 pod 打印名称。这实际上是一个 hook，你可以根据自己的需要自定义行为。

如果你想要将同样的 pod ，给多个 targets 分享，请使用一个 abstract_target （抽象的 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 的根部，隐含了 abstract target ，所以你也可以将上面的例子写成这样：
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

将 CocoaPods 从 0.x 迁移到 1.0 版本：
这有个博客，解释了底层的改变（http://blog.cocoapods.org/CocoaPods-1.0/）

指定 pod 版本：
当你开始开始做一个工程的时候，你理所当然的想要使用一个 pod 最新的版本。如果是这样的场景，你只要简单的省略掉版本要求（version requirements）就行：
pod 'SSZipArchive'

一段时间后，你可能想要将一个 pod 锁定在一个指定的版本上。这时，你可以指定该 pod 的版本号：
pod 'Objection', '0.9'

除开不指定版本，或者指定一个版本，你也可以使用逻辑操作符：
'> 0.1' —— 任何大于 0.1 的版本，不包括 0.1
'>= 0.1' —— 任何大于 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.2 的版本 （也就是 0.1.2 <= version < 0.2）
'~> 0.1' —— 从 0.1 到 1.0 的版本，不包括 1.0 和 高于 1.0 的版本 （也就是 0.1 <= version < 1.0）
'~> 0' —— 大于 0 的所有版本，这么写的话，和没写这句话等效

从本地文件中使用文件：
如果你想要连同客户端工程开发一个 pod ，你可以使用 :path
pod 'Alamofire', :path => '~/Documents/Alamofire'
通过使用这个选项，CocoaPods 将会认定你所提供的文件夹是 pod 的根目录，并将这个文件夹中的文件直接链接到 Pods 工程中。这意味着，你对 pod 的编辑在之后的历次 CocoaPods 安装（CocoaPods installations）中都是持续不变的（因为，此时这个 pod 引用的是你指定的文件夹中的文件，这些文件变了，pod 才会变）。这个引用文件夹，可以是你最喜欢的 SCM 的一份检出，或者甚至是当前仓库的一个 git 子模块。
注意，这个 pod 的 podspec 文件需要包含在你指定的文件夹内。

从一份位于 library 仓库根源的 podspec：
有时，你可能想要使用一个 pod 的尖端版本（bleeding edge version），一个指定的修改或者你自己拥有的 fork。如果是这样的情况，你可以通过你的 pod declaration 来指定。
使用 repo 的 master 分支：
pod 'Alamofire', :git => 'https://github.com/Alamofire/Alamofire.git'

使用 repo 的一个不同的分支：
pod 'Alamofire', :git => 'https://github.com/Alamofire/Alamofire.git', :branch => 'dev'

使用 repo 的一个 tag：
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 所指定的版本，要满足所有 Pod 中的其他 pod 对于该 pod 的依赖。
podspec 文件，需要放在 repo 的根目录下。