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" 的属性。未能遵循此规则不会被诊断,并将导致目标位置未定义。