LOCATION¶
目标在磁盘上的只读位置。
对于导入的目标,此只读属性返回目标提供的未指定配置 <CONFIG>
的 LOCATION_<CONFIG>
属性的值。
对于非导入的目标,提供此属性是为了与 CMake 2.4 及更低版本兼容。它旨在获取可执行目标的输出文件位置,以便在 add_custom_command()
中使用。路径可能包含特定于构建系统的部分,该部分在构建时被替换为正在构建的配置(例如 VS 中的 $(ConfigurationName)
)。在 CMake 2.6 及更高版本中,add_custom_command()
会自动识别其 COMMAND
和 DEPENDS
选项中的目标名称,并计算目标位置。在 CMake 2.8.4 及更高版本中,add_custom_command()
识别 generator expressions
以在命令中的任何位置引用目标位置。因此,创建自定义命令不需要此属性。
读取此属性后,请勿设置影响目标位置的属性。 这些属性包括名称与 (RUNTIME|LIBRARY|ARCHIVE)_OUTPUT_(NAME|DIRECTORY)(_<CONFIG>)?
、(IMPLIB_)?(PREFIX|SUFFIX)
或 "LINKER_LANGUAGE" 匹配的属性。 不遵守此规则不会被诊断出来,并使目标的位置未定义。