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() 识别 generator expressions 以在命令中的任何位置引用目标位置。因此,创建自定义命令不需要此属性。

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