<什么是 Podfile？
Podfile 是一个规范，用于描述一个或多个 Xcode 项目的目标的依赖项。该文件应简单地命名为 Podfile。指南中的所有示例均基于 CocoaPods 1.0 及更高版本。
Podfile 可以非常简单，它将 Alamofire 添加到单个目标
target 'MyApp' do
use_frameworks!
pod 'Alamofire', '~> 3.0'
end
一个更复杂的 Podfile 示例，它链接了一个应用程序及其测试包
source 'https://cdn.cocoapods.org/'
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
如果您希望多个目标共享相同的 Pod，请使用
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
<从 0.x 迁移到 1.0
我们有一篇 博客文章，详细解释了这些更改。
<指定 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 版本和高达 1.0 的版本，不包括 1.0 及更高版本
有关版本控制策略的更多信息，请参阅
- 语义版本控制
- RubyGems 版本控制策略
- Google 有一个很棒的视频，介绍了它的工作原理："CocoaPods 和波浪箭头案例（第 85 号公路）"。
- 请注意，视频中关于
~> 1的信息不正确。
- 请注意，视频中关于
<使用本地计算机上的文件夹中的文件。
如果您想与客户端项目同时开发 Pod，可以使用
:path。
pod 'Alamofire', :path => '~/Documents/Alamofire'
使用此选项，CocoaPods 会假设给定文件夹是 Pod 的根目录，并将直接从 Pods 项目中的该文件夹链接文件。这意味着您的编辑内容将在 CocoaPods 安装之间保留。引用的文件夹可以是您最喜欢的 SCM 的检出，甚至可以是当前存储库的 git 子模块。
<来自库存储库根目录中的 podspec。
有时您可能希望使用 Pod 的最新版本、特定修订版或您自己的分支。如果是这种情况，您可以在 Pod 声明中指定。
要使用存储库的
master分支
pod 'Alamofire', :git => 'https://github.com/Alamofire/Alamofire.git'
要使用存储库的不同分支
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 对该 Pod 的任何其他依赖项。
podspec 文件预期在存储库的根目录中，如果此库在其存储库中还没有 podspec 文件，您将必须使用以下部分中概述的方法之一。