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