OBJECT_NAME

版本 4.2 中添加。

设置源文件的对象名称（不包含对象扩展名）。 空字符串值会禁用自定义对象命名。 该值必须是相对路径，并且不得包含特殊目录组件（例如 ..）。

请注意，对象名称可能不会在 CMAKE_INTERMEDIATE_DIR_STRATEGY 和 INSTALL_OBJECT_NAME_STRATEGY 策略中按原样使用。 它可以根据策略的要求进行更改，以实现其目标。

在安装对象时，INSTALL_OBJECT_NAME 属性优先。

此属性支持 生成器 表达式，但不允许使用上下文相关的（即，配置相关的）表达式。

注意

CMake 不会对目标内的冲突进行抵抗。 使用此属性时，必须在项目代码中避免冲突。 CMake 有一些它生成的源文件，这些文件也会创建可能与给定自定义名称冲突的对象文件。 这些包括

  • 生成的 PCH 源文件 (cmake_pch)

  • 生成的 Unity 编译文件 (unity_...)

  • Qt 自动生成源文件 (moc_compilations.cpp)

注意

FASTBuild 和 Xcode 生成器不支持此属性，并将忽略它。