EXCLUDE_FROM_ALL

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

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

EXCLUDE_FROM_ALL 设置为 false 或根本不设置时,作为执行 make install 或其在所使用 CMake 生成器中的等效项的一部分,该目标将更新至最新状态。

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

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

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