CMake构建过程中动态添加链接器选项的实现方法

需求背景 #

需要在静态库链接时保留部分未引用符号，需通过--undefined=symbol选项告知链接器，但这些符号无法提前枚举，只能通过ELF段和名称前缀，借助nm工具在构建时解析得到。核心问题是如何将PRE_LINK自定义命令的输出结果传递给GCC的链接命令，以及CMake是否支持根据一个命令的构建时输出调整另一个命令的调用参数。

已尝试的非CMake方案 #

• --whole-archive：可保留所有符号，但嵌入式项目需严格控制符号范围，仅保留指定段符号，因此不适用。
• 重新打包目标文件：计划将特殊符号单独放入目标文件，再用--whole-archive包含，但objcopy操作需同步移动.data段，可能破坏链接结构，未成功。
• --retain-symbols-file：若该选项仅保留指定符号而不删除其他符号则完全匹配需求，但实际会移除所有未指定符号，不符合要求。
• 通配符匹配：现代LLVM支持--undefined=prefix*的通配符写法，但项目依赖的GCC 8.4.0不支持该特性。

CMake实现方案 #

可以通过PRE_LINK自定义命令生成参数文件+链接命令读取参数文件的方式实现，具体步骤如下：

1. 编写符号提取脚本 #

创建shell脚本（例如extract_symbols.sh），输入静态库文件路径，用nm解析并过滤出目标符号，生成--undefined=symbol格式的选项并保存到临时文件：

#!/bin/bash
INPUT_LIB="$1"
OUTPUT_OPT_FILE="$2"

# 替换为你的实际过滤规则：匹配指定ELF段和符号前缀
nm -g "$INPUT_LIB" | grep -E "你的段标识|^[0-9a-f]+ . [A-Z] 你的符号前缀" | awk '{print "--undefined="$3}' > "$OUTPUT_OPT_FILE"

给脚本添加可执行权限：chmod +x extract_symbols.sh

2. 在CMake中配置PRE_LINK命令 #

针对需要处理的目标（静态库或最终可执行文件），添加PRE_LINK命令，在链接前调用脚本生成链接选项文件：

# 指定脚本路径
set(SYMBOL_EXTRACT_SCRIPT "${CMAKE_CURRENT_SOURCE_DIR}/extract_symbols.sh")

# 假设目标为静态库mylib，若为可执行文件则替换为对应的目标名
add_custom_command(
    TARGET mylib
    PRE_LINK
    COMMAND "${SYMBOL_EXTRACT_SCRIPT}" "$<TARGET_FILE:mylib>" "${CMAKE_CURRENT_BINARY_DIR}/link_options.txt"
    COMMENT "Extracting required symbols for linking..."
)

3. 修改链接命令读取参数文件 #

GCC支持通过@文件名的方式读取命令行参数，因此给目标添加该选项，让链接器加载生成的选项文件：

set_target_properties(mylib PROPERTIES
    LINK_FLAGS "@${CMAKE_CURRENT_BINARY_DIR}/link_options.txt"
)

关键说明 #

• PRE_LINK命令的执行时机是在目标链接操作之前，确保生成的选项文件能被链接命令正确读取。
• 若最终链接的是可执行文件（而非静态库本身），则需将PRE_LINK命令和LINK_FLAGS配置到可执行文件目标上，而非静态库目标。
• 需根据实际项目调整脚本中的过滤规则，确保准确提取需要保留的符号。

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