学习有关Podfile的所有内容,用于声明项目的依赖项。
什么是Podfile文件
Podfile是描述一个或多个Xcode项目的目标的依赖关系的规范。该文件被简单地命名为Podfile。指南中的所有示例都基于CocoaPods 1.0或更高版本。
一个Podfile可以非常简单,这将Alamofire添加到一个目标:
target 'MyApp' do
use_frameworks!
pod 'Alamofire', '~> 3.0'
end
一个更复杂的Podfile链接an app及其测试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'
# 有自己的OCMock副本
# 并通过该应用访问谷歌分析
# 它承载测试目标
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。
# 在任何Xcode项目中都没有所谓的“Shows”目标
abstract_target 'Shows' do
pod 'ShowsKit'
pod 'Fabric'
# 有自己的ShowsKit + ShowWebAuth副本
target 'ShowsiOS' do
pod 'ShowWebAuth'
end
# 有自己的ShowsKit + ShowTVAuth副本
target 'ShowsTV' do
pod 'ShowTVAuth'
end
end
在Podfile的根目录中有一个隐式的抽象目标,所以你可以把上面的例子写成:
pod 'ShowsKit'
pod 'Fabric'
# 有自己的ShowsKit + ShowWebAuth副本
target 'ShowsiOS' do
pod 'ShowWebAuth'
end
# 有自己的ShowsKit + ShowTVAuth副本
target 'ShowsTV' do
pod 'ShowTVAuth'
end
指定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及以上,这基本上和没有它是一样的
使用计算机本地文件夹中的文件
如果您想与它的客户端项目一起开发一个Pod,您可以使用:path
pod 'Alamofire', :path => '~/Documents/Alamofire'
使用这个选项CocoaPods将假定给定的文件夹是Pod的根文件夹,并将从那里直接链接Pods项目中的文件。
这意味着您的编辑将在CocoaPods安装之间保持。
所引用的文件夹可以是您最喜欢的SCM的签出,甚至可以是当前repo的git子模块。
注意:Pod文件的podspec应该在指定的文件夹中。
来自库repo根目录中的podspec
有时你可能想要使用一个Pod的最新版本,一个特定的版本或者你自己的叉子。如果是这种情况,您可以使用pod声明指定它。
使用repo的主分支:
pod 'Alamofire', :git => 'https://github.com/Alamofire/Alamofire.git'
使用repo的另一个分支:
pod 'Alamofire', :git => 'https://github.com/Alamofire/Alamofire.git', :branch => 'dev'
使用repo的标签:
pod 'Alamofire', :git => 'https://github.com/Alamofire/Alamofire.git', :tag => '3.1.1'
指定提交:
pod 'Alamofire', :git => 'https://github.com/Alamofire/Alamofire.git', :commit => '0f506b1c45'
但是,需要注意的是,这意味着该版本必须满足其他Pods对Pods的任何其他依赖关系。
podspec文件应该位于repo的根目录中,如果这个库的repo中还没有podspec文件,那么您必须使用下面小节中列出的方法之一。