FASTBuild¶
版本 4.2 中添加。
生成一个 fbuild.bff 文件，该文件可用于使用 FASTBuild 构建项目。
用法¶
调用 cmake(1) 时指定生成器
cmake [<options>] -G FASTBuild -B <path-to-build> [-S <path-to-source>]
这会将一个名为 fbuild.bff 的 FASTBuild 配置文件写入 <path-to-build>。
注意
此生成器还为 Visual Studio 和 Xcode 生成 IDE 项目文件，这些文件位于
<path-to-build>/VisualStudio– Visual Studio 解决方案和项目<path-to-build>/XCode– Xcode 工作区和项目
这些 IDE 文件可以通过构建 xcode 或 solution 目标来生成，并将使用 FASTBuild 作为后端进行构建。
缓存¶
要启用 FASTBuild 缓存，请使用 CMAKE_FASTBUILD_CACHE_PATH 变量或 FASTBUILD_CACHE_PATH 环境变量设置缓存路径。
然后使用 -cache 标志进行构建
cmake --build <path-to-build> -- -cache
编译器行为变量¶
以下变量控制在生成的 fbuild.bff 中如何发出编译器节点。这些设置可能会影响构建确定性、调试信息路径、包含处理和编译器参数格式
配置变量¶
可以使用以下变量来配置此生成器
目标属性¶
以下目标属性可用于在每个目标基础上微调行为
FASTBUILD_CACHING– 禁用特定目标的缓存。FASTBUILD_DISTRIBUTION– 禁用特定目标的分布式编译。
注意事项¶
此生成器不支持目录作为自定义命令的输出。如果您确实指定了一个目录作为输出，它应该被标记为
SYMBOLIC属性，以避免不正确的行为。强烈建议自定义命令只指定一个输出。如果指定了多个输出，生成器将发出一个额外的规则在构建时检查输出。这会增加开销，并且是必需的，因为 FASTBuild 原生只支持每个自定义步骤一个输出。
示例¶
cmake [<options>] -G FASTBuild -B <path-to-build> -DCMAKE_BUILD_TYPE=Release
cmake --build <path-to-build> --target my_app
这将在 <path-to-build> 中生成 fbuild.bff，并使用 FASTBuild 来构建 my_app 目标。