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