EXCLUDE_FROM_ALL¶
将此目标属性设置为真(或假)值,以将目标从其所在目录及其祖先目录的“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”生成器支持按配置变化的属性值。对于所有其他生成器,此属性的值必须对所有配置都相同。
另请参阅¶
要从整个目录子树中排除目标,请参阅
EXCLUDE_FROM_ALL
目录属性。要将目标从 Visual Studio 解决方案构建中排除,请使用
EXCLUDE_FROM_DEFAULT_BUILD
。