OBJECT_NAME

版本 4.2 中添加。

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

请注意,对象名称可能不会按原样用于 CMAKE_INTERMEDIATE_DIR_STRATEGYINSTALL_OBJECT_NAME_STRATEGY 策略。根据策略目标的需求,它可能会被更改。

安装对象时,INSTALL_OBJECT_NAME 属性具有优先权。

此属性支持 生成器表达式,但不允许使用上下文敏感(即,与配置相关的)表达式。

注意

CMake 不执行目标内部的冲突检测。使用此属性时,必须在项目代码中避免冲突。CMake 生成的许多源文件也会创建可能与给定自定义名称冲突的对象文件。这些包括:

  • 生成的 PCH 源文件(cmake_pch

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

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

注意

生成器 FASTBuildXcode 不支持此属性,并将忽略它。