CMake如何配置POST_BUILD命令实现每次构建都复制资源目录到输出文件夹

业内通用实现逻辑 #

CMake中处理资源文件一般分为两个阶段：

• 构建阶段：将资源同步到构建输出目录，保证本地调试运行时可正常读取
• 安装阶段：将资源随二进制文件一起安装到指定的系统路径，保证发布后正常使用

构建阶段同步资源方案 #

方案1：资源变更时自动同步（业内首选，性能最优） #

仅在资源文件有修改时执行复制操作，兼顾性能和资源一致性，是大多数项目的选择：

# 收集所有资源文件，注意使用绝对路径避免歧义
file(GLOB_RECURSE SHADER_RESOURCES "${CMAKE_CURRENT_SOURCE_DIR}/shaders/*")

# 定义资源复制专用目标，ALL参数表示该目标会加入默认构建流程
add_custom_target(copy_shader_resources ALL
  # 先创建目标目录避免复制失败
  COMMAND ${CMAKE_COMMAND} -E make_directory "${CMAKE_CURRENT_BINARY_DIR}/shaders"
  # 复制整个shaders目录到构建输出目录
  COMMAND ${CMAKE_COMMAND} -E copy_directory
          "${CMAKE_CURRENT_SOURCE_DIR}/shaders"
          "${CMAKE_CURRENT_BINARY_DIR}/shaders"
  # 绑定资源依赖，只要有资源变更就会触发复制
  DEPENDS ${SHADER_RESOURCES}
  COMMENT "同步着色器资源到构建目录"
)

# 可选：绑定到你的可执行目标，保证构建可执行文件前先完成资源同步
add_dependencies(你的可执行目标名 copy_shader_resources)

方案2：强制每次构建都同步资源（满足强需求） #

如果要求无论资源、代码是否变更，只要执行构建命令就强制同步最新资源，可以用以下写法，兼容所有CMake版本：

# 定义永远触发的复制命令
add_custom_command(
  OUTPUT force_copy_shaders
  COMMAND ${CMAKE_COMMAND} -E make_directory "${CMAKE_CURRENT_BINARY_DIR}/shaders"
  COMMAND ${CMAKE_COMMAND} -E copy_directory
          "${CMAKE_CURRENT_SOURCE_DIR}/shaders"
          "${CMAKE_CURRENT_BINARY_DIR}/shaders"
  COMMENT "强制同步最新着色器资源"
)
# 绑定到默认构建流程
add_custom_target(copy_shader_resources ALL DEPENDS force_copy_shaders)
# 绑定可执行目标依赖
add_dependencies(你的可执行目标名 copy_shader_resources)

原理是force_copy_shaders这个文件永远不会被生成，CMake每次构建都会判定该任务过期，强制执行复制命令。 #

安装阶段资源部署方案 #

如果需要执行安装操作时同步部署资源，可以使用install命令：

include(GNUInstallDirs)
# 将shaders目录安装到可执行文件所在的同级目录
install(DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}/shaders/"
        DESTINATION "${CMAKE_INSTALL_BINDIR}/shaders")

可根据实际需求调整DESTINATION的路径规则。 #

常见错误方案原因说明 #

• 直接调用file(COPY)属于CMake配置阶段命令，仅在CMake运行配置流程时执行一次，后续构建阶段不会触发，自然无法同步资源更新。
• 绑定到目标的POST_BUILD命令仅在目标本身需要重新编译链接时执行，目标无变更时会直接跳过，不符合不依赖代码变更同步资源的需求。

内容的提问来源于stack exchange，提问作者activedecay