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的应用程序访问GoogleAnalyticstarget 'MyAppTests' do inherit! :search_paths pod 'OCMock', '~> 2.0.1' end endpost_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'

【Podfile文件解释和使用 – CocoaPods教程】使用仓库的某一个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文件,那么您必须使用下面小节中列出的方法之一。

    推荐阅读