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”生成器支持因配置而异的属性值。对于所有其他生成器,此属性的值对于所有配置都必须相同。