Podfile语法参考（译）

Posted 2023-05-12

参考技术A

Podfile 是一个规范，描述了一个或多个 Xcode 工程中 targets 的依赖关系。

Podfile 可以非常简单：

更复杂的 Podfile 示例可以是：

整体应用于 Podfile 的配置。

install!

指定 CocoaPods 安装此 Podfile 时要使用的安装方法和选项。

第一个参数表示要使用的安装方法；下一个参数表示安装选项。

目前唯一可接受的安装方法是 cocoapods ，所以你总是将这个值用作第一个参数；但是在将来的版本中可能会提供更多安装方法。

示例：

支持的keys：

以下选项默认值均为 true

:clean

:deduplicate_targets

:deterministic_uuids

:integrate_targets

:lock_pod_sources

:warn_for_multiple_pod_sources

以下选项默认值均为 false

:share_schemes_for_development_pods

:disable_input_output_paths

:preserve_pod_file_structure

Podfile 指定每个用户 target 的依赖关系。

pod

指定项目的依赖项。

一个依赖项通过Pod的名称和可选的版本号定义。

当项目开始的时候，您可能希望使用最新版本的Pod。 如果是这种情况，只需省略版本号即可。

在后续项目中，您可能希望冻结到Pod的特定版本，在这种情况下，您可以指定该版本号。

除了没有版本或特定的版本，也可以使用运算符：

可以指定版本要求列表以进行更细粒度的控制。

有关版本控制策略的更多信息，请参阅：

默认情况下，依赖项安装在 target 的所有构建配置中。 有时出于调试目的或其他原因，仅只能在某个构建配置列表中启用它们。

或者，您可以指定将其包含在单个构建配置中

请注意，除非您已手动为它们指定构建配置，否则传递依赖项包含在所有配置中时。

如果您想为每个 Pod 使用模块化标头，可以使用以下语法：

另外，当你使用 use_modular_headers! 属性时，您可以使用以下方法从模块化标头中排除特定的Pod：

示例：

默认按指定源全局搜索依赖项，也可以给特定依赖项指定源：

在这种情况下，将仅搜索指定的源以查找依赖项，并忽略任何全局源。

通过名称安装Pod时，它将安装 podspec 中定义的所有默认 subspecs 。

您可以使用以下方法安装特定的 subspec ：

您可以指定要安装的子规范集合，如下所示：

依赖性也可以从外部来源获得。

使用本地路径文件

使用 path 选项

使用此选项， CocoaPods 将假定给定的文件夹是 Pod 的根目录，并将直接从 Pods 项目中的链接文件。这意味着您的编辑将持久保存到 CocoaPods 安装。

请注意， Pod 文件的 podspec 应该位于该文件夹中。

来自远程仓库根目录中的podspec

有时您可能想要使用 Pod 的最新版本，或者是特定的版本。 如果是这种情况，您可以使用 pod 声明指定。

使用仓库 master 分支：

使用仓库其他分支：

使用仓库的某个 tag ：

或指定 commit ：

podspec 文件应该位于存储仓库的根目录中，如果该仓库没有 podspec 文件，则必须使用以下方法之一指定。

From a podspec outside a spec repository, for a library without podspec：

podspec

示例：

target示例

inherit!

设置当前目标的继承模式。

有效的模式：

示例：

platform

指定应为其构建静态库的平台，示例：

project

Specifies the Xcode project that contains the target that the Pods library should be linked with.

示例：

inhibit_all_warnings!

屏蔽来自 CocoaPods 库的所有警告。

您可以使用以下内容排除特定Pod被屏蔽：

use_frameworks!

Use frameworks instead of static libraries for Pods.

This group list the options to configure workspace and to set global settings.

workspace

Specifies the Xcode workspace that should contain all the projects.

示例：

Cocoapods的Podfile常见语法总结

source  ‘URL‘ ： 指定镜像仓库的源

platform : ios,  ‘6.0‘  ： 指定所支持系统和最低版本

inhibit_all_warnings! ：屏蔽所有warning

workspace ‘项目空间名‘： 指定项目空间名

xcodeproj ‘工程文件名‘：指定xcodeproj工程文件名

下面都是引入库的语句：

pod  ‘库名‘,   :   引入库，什么版本都可以（一般就是最新版本了）

pod  ‘库名‘, ‘版本‘  ：  引入指定版本的库，下面的运算符可以指定版本的范围：

>   <   >=   <=  ：不解释

~ >  :  从指定版本到倒数第二位版本号升1为止，比如 ‘~> 1.2.1‘是指  1.2.1 <= 版本 < 1.3.0

pod ‘库名‘, :podspec => ‘podspec文件路径‘  :  指定导入库的podspec文件路径

pod ‘库名‘, :git => ‘源码git地址‘  :  指定导入库的源码git地址

pod ‘库名‘, :tag => ‘tag名‘  :  指定导入库的Tag分支