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()
识别 生成器 表达式
,以便在命令中的任何位置引用目标位置。因此,此属性对于创建自定义命令是不必需的。
在读取此属性之后,请勿设置影响目标位置的属性。这包括名称与 (RUNTIME|LIBRARY|ARCHIVE)_OUTPUT_(NAME|DIRECTORY)(_<CONFIG>)?
、(IMPLIB_)?(PREFIX|SUFFIX)
或 “LINKER_LANGUAGE” 匹配的属性。如果不遵守此规则,则不会进行诊断,并且会使目标位置未定义。