如何仅对静态库.a中单个.o文件强制链接而非整个库？

问题场景 #

需要强制链接静态库.a中的特定.o文件（比如Qt的..._qmltyperegistrations.cpp编译出的目标文件，这类文件负责QML类注册，依赖启动时自动执行的代码但无外部引用符号，容易被链接器丢弃），但不想链接整个静态库，且不希望在业务代码中添加dummy变量引用，希望完全通过CMake实现逻辑。

已确认可行的前提：

• 可负责构建静态库
• 可调整构建方式、创建可重定位目标文件
• 可添加包含必要符号引用的目标文件

当前临时方案（可移植性差） #

目前通过提取函数的 mangled 名称，用链接器-u选项强制链接对应的.o文件，但步骤繁琐且依赖特定工具：

execute_process(
   COMMAND ${CMAKE_COMMAND} -E echo "void qml_register_types_ZesFrontend() { }"
   COMMAND ${CMAKE_CXX_COMPILER} -xc++ -S -w -o - -
   COMMAND grep -Po [[^_Z.+(?=:)]]
   OUTPUT_VARIABLE mangled_initializer
)

target_link_options(zes_frontend INTERFACE SHELL:-u "${mangled_initializer}")

更优的CMake实现方案 #

方案1：生成临时引用文件（推荐） #

通过CMake生成临时C++源文件，显式引用目标.o中的关键符号，再将该文件编译链接到项目，避免依赖符号 mangling 和外部工具：

# 生成临时源文件
set(FORCE_LINK_FILE "${CMAKE_CURRENT_BINARY_DIR}/force_link_qml_reg.cpp")
file(WRITE ${FORCE_LINK_FILE} "
// 声明QML注册函数
extern void qml_register_types_ZesFrontend();
// 全局构造函数触发注册代码执行
struct ForceLinkQmlReg {
    ForceLinkQmlReg() {
        qml_register_types_ZesFrontend();
    }
} force_link_qml_reg_instance;
")

# 创建对象库包含临时文件
add_library(force_link_qml_reg OBJECT ${FORCE_LINK_FILE})
# 将对象库链接到主目标
target_link_libraries(your_main_target PRIVATE force_link_qml_reg)

链接器会因引用了qml_register_types_ZesFrontend符号，自动从静态库中提取对应的.o文件，全局构造函数也能确保注册代码在程序启动时执行。

方案2：直接提取静态库中的单个.o文件 #

如果静态库已构建完成，可通过CMake调用ar工具提取目标文件后直接链接：

# 提取静态库中的目标文件
add_custom_command(
    OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/qmltyperegistrations.o"
    COMMAND ar x "${PATH_TO_ARCHIVE}/archive.a" qmltyperegistrations.o
    DEPENDS archive.a
    WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
)
# 将提取的.o文件添加到主目标链接
target_sources(your_main_target PRIVATE "${CMAKE_CURRENT_BINARY_DIR}/qmltyperegistrations.o")

该方案更直接，但需明确.o文件名称，Windows环境下需将ar替换为lib.exe。

总结 #

优先选择生成临时引用文件的方案，它不依赖外部工具和符号 mangling，可移植性更强，完全通过CMake逻辑实现，无需修改业务代码。

内容的提问来源于stack exchange，提问作者Johannes Schaub - litb