CMAKE_Swift_COMPILATION_MODE

在 3.29 版本中添加。

指定 Swift 如何编译目标。此变量用于初始化目标上的 Swift_COMPILATION_MODE 属性，因为它们是在创建时。

允许的值为

incremental

分别编译模块中的每个 Swift 源文件，从而在构建中实现更好的并行性。编译器将额外的信息发到构建目录中，从而在重建之间对源文件进行小更改时，提高重建性能。这是在项目更改上迭代时使用的最佳选项。

wholemodule

全模块优化编译速度最慢，但会生成最优化的库。整个上下文被加载到编译器的单个实例中，因此模块中的源文件之间没有并行性。

singlefile

分别编译 Swift 模块中的每个源文件，从而实现更好的并行性。与 incremental 构建模式不同，编译器在构建期间不会发出额外的信息，因此在对源文件进行小更改后重建不会更快。除非要解决编译器错误，否则应谨慎使用此选项，首选 incremental 构建。

使用 generator expressions 以支持按配置指定。例如，以下代码

set(CMAKE_Swift_COMPILATION_MODE
  "$<IF:$<CONFIG:Release>,wholemodule,incremental>")

在构建发布配置时将默认 Swift 编译模式设置为 wholemodule 模式，在其他配置中设置为 incremental 模式。

如果未设置此变量，则不会自动设置 Swift_COMPILATION_MODE 目标属性。如果该属性未设置，则 CMake 使用默认值 incremental 来构建 Swift 源文件。

注意

仅当策略 CMP0157 在启用 Swift 语言的第一个 project() 或 enable_language() 命令之前设置为 NEW 时，此属性才生效。