LOCATION

目标在磁盘上的只读位置。

对于导入的目标,此只读属性返回目标提供的未指定配置 <CONFIG>LOCATION_<CONFIG> 属性值。

对于非导入目标,此属性是为了与 CMake 2.4 及更早版本兼容而提供的。它旨在获取可执行目标输出文件的位置,以便在 add_custom_command() 中使用。路径可能包含构建系统特定的部分,该部分在构建时会替换为正在构建的配置(例如 VS 中的 $(ConfigurationName))。在 CMake 2.6 及更高版本中,add_custom_command() 会自动识别其 COMMANDDEPENDS 选项中的目标名称,并计算目标位置。在 CMake 2.8.4 及更高版本中,add_custom_command() 会识别 生成器表达式,以在命令中的任何位置引用目标位置。因此,创建自定义命令不需要此属性。

读取此属性后,请勿设置影响目标位置的属性。这些属性包括名称匹配 (RUNTIME|LIBRARY|ARCHIVE)_OUTPUT_(NAME|DIRECTORY)(_<CONFIG>)?(IMPLIB_)?(PREFIX|SUFFIX) 或 "LINKER_LANGUAGE" 的属性。不遵守此规则将不会被诊断,并使目标位置未定义。