如何在CMake中添加从模板生成链接脚本文件的步骤？

要让CMake在链接前自动从模板生成最终的链接脚本，核心是正确建立生成文件与目标的依赖关系，以下是两种可靠实现方案：

方案一：文件级依赖（推荐） #

通过add_custom_command(OUTPUT)直接关联生成的链接脚本与可执行目标，CMake会自动处理生成时机：

# 1. 定义从模板生成链接脚本的命令
add_custom_command(
  OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/my_linkerscript.ld
  # 这里以CMake自带的configure_file为例替换模板占位符，也可换成sed等自定义命令
  COMMAND ${CMAKE_COMMAND} -E configure_file
    ${CMAKE_CURRENT_SOURCE_DIR}/my_linkerscript.ld.in
    ${CMAKE_CURRENT_BINARY_DIR}/my_linkerscript.ld
    @ONLY
  DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/my_linkerscript.ld.in
  COMMENT "Generating linker script from template"
)

# 2. 定义可执行目标
add_executable(my_app main.c)

# 3. 将生成的链接脚本添加为目标依赖，确保链接前先生成文件
target_sources(my_app PRIVATE ${CMAKE_CURRENT_BINARY_DIR}/my_linkerscript.ld)

# 4. 设置链接选项，指向构建目录下的最终链接脚本
target_link_options(my_app PRIVATE -T${CMAKE_CURRENT_BINARY_DIR}/my_linkerscript.ld)

方案二：目标级依赖（适合多目标共享生成文件） #

通过自定义目标管理链接脚本生成，再让可执行目标依赖该自定义目标：

# 1. 创建生成链接脚本的自定义目标
add_custom_target(generate_linker_script
  COMMAND ${CMAKE_COMMAND} -E configure_file
    ${CMAKE_CURRENT_SOURCE_DIR}/my_linkerscript.ld.in
    ${CMAKE_CURRENT_BINARY_DIR}/my_linkerscript.ld
    @ONLY
  DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/my_linkerscript.ld.in
  COMMENT "Generating linker script from template"
)

# 2. 定义可执行目标
add_executable(my_app main.c)

# 3. 让可执行目标依赖自定义生成目标
add_dependencies(my_app generate_linker_script)

# 4. 设置链接选项
target_link_options(my_app PRIVATE -T${CMAKE_CURRENT_BINARY_DIR}/my_linkerscript.ld)

关键注意事项 #

• 绝对路径优先：始终用CMAKE_CURRENT_SOURCE_DIR（源码目录）和CMAKE_CURRENT_BINARY_DIR（构建目录）指定文件路径，避免out-of-source构建时出现路径错误。
• 依赖必须明确：add_custom_command的DEPENDS要包含模板文件，确保模板修改时自动重新生成链接脚本；生成的文件必须与可执行目标建立关联（要么加入target_sources，要么通过add_dependencies绑定），否则CMake不会触发生成命令。
• 链接选项指向正确文件：链接时必须使用构建目录下的最终生成文件，而非源码目录的模板文件。

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