Podfile文件解释和使用 – CocoaPods教程

上一章CocoaPods教程请查看：CocoaPods使用详细步骤解释

什么是Podfile文件？

Podfile是描述一个或多个Xcode项目的target的依赖性的规范。该文件应该简单地命名为Podfile。指南中的所有示例都是基于CocoaPods 1.0及以上版本的。

Podfile文件可以很简单，下面的例子向一个target中添加一个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'

# 拥有自己的OCMock副本
# 并通过托管测试target的应用程序访问GoogleAnalytics

   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

如果你想要让多个target共享一些pod，可以使用abstract_target：

# Xcode中并没有叫做'Shows'的target
abstract_target 'Shows' do
   pod 'ShowsKit'
   pod 'Fabric'

   # 有自身的ShowsKit + ShowWebAuth
   target 'ShowsiOS' do
      pod 'ShowWebAuth'
   end

   # 有自己的ShowsTV + ShoTVAuth
   target 'ShowsTV' do
      pod 'ShowTVAuth'
   end
end

在Podfile的根目录中有一个隐式的抽象目标，因此可以将上面的示例写成：

pod 'ShowsKit'
pod 'Fabric'

# ShowKit + ShowWebAuth
target 'ShowsiOS'
   pod 'ShowWebAuth'
end

# ShowsKit + ShowTVAuth
target 'ShowsTV' do
   pod 'ShowTVAuth'
end

指定pod版本

在开始一个项目时，你可能希望使用最新版本的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及以上，这基本上和不指定版本号是相同的。

~>运算符类用于指定版本区间，顺便说一下版本号x.y.z，x表示重大更新的迭代版本号，y表示项目添加了一些新功能，z表示修复版本号，一般是修复项目的bug。

使用计算机本地文件夹中的文件。

如果你想与它的客户端项目一起开发一个Pod，你可以使用:path。

pod 'Alamofire', :path => '~/Documents/Alamofire'

使用此选项CocoaPods将假定给定文件夹是Pod的根文件夹，并将从那里直接链接到Pods项目中的文件。这意味着你的编辑将在CocoaPods安装之间保持不变。被引用的文件夹可以是你最喜欢的SCM的签出，甚至是当前repo的git子模块。

请注意，Pod文件的podspec应该在指定的文件夹中。

来自库repo根目录下的podspec

有时你可能想要使用一个pod边缘版本，一个特定的修订或你自己的fork。如果是这种情况，你可以使用pod声明来指定。

使用仓库的主分支master:

pod 'Alamofire', :git => 'https://github.com/Alamofire/Alamofire.git'

使用仓库的不同分支：

pod 'Alamofire', :git => 'https://github.com/Alamofire/Alamofire.git', :branch => 'dev'

使用仓库的某一个tag：

pod 'Alamofire', :git => 'https://github.com/Alamofire/Alamofire.git', :tag => '3.1.1'

或者使用一个指定的提交commit：

pod 'Alamofire', :git => 'https://github.com/Alamofire/Alamofire.git', :commit => '0f506b1c45'

但是，需要注意的是，这意味着该版本必须满足其他Pod对Pod的任何其他依赖关系。

podspec文件应该在repo的根目录中，如果这个库的repo中还没有podspec文件，那么您必须使用下面小节中列出的方法之一。