EXCLUDE_FROM_ALL

将此目标属性设置为 true(或 false)值,以将目标从包含目录及其祖先目录的“all”目标中排除(或包含)。如果排除,例如在包含目录或其祖先目录中运行 make 将默认不会构建该目标。

如果未设置此目标属性,则该目标将包含在包含目录的“all”目标中。此外,除非设置了 EXCLUDE_FROM_ALL 目录属性,否则它将包含在其祖先目录的“all”目标中。

EXCLUDE_FROM_ALL 设置为 false 或根本未设置时,作为执行 make install 或其用于所用 CMake 生成器的等效操作的一部分,目标将被更新。

如果目标的 EXCLUDE_FROM_ALL 设置为 true,它仍然可以列在 install(TARGETS) 命令中,但用户有责任确保在执行安装时目标的构建工件不会丢失或过时。

此属性可以使用带有语法 $<...> 的“生成器表达式”。有关可用表达式,请参阅 cmake-generator-expressions(7) 手册。

只有 “Ninja Multi-Config” 生成器支持按配置而异的属性值。对于所有其他生成器,此属性的值对于所有配置都必须相同。