基于MSys2/MinGW64：CMake打包自研静态库与OpenSSL静态库方案问询

一、先确认你的前置条件是否正确 #

你通过MSys2/MinGW64编译得到OpenSSL静态库（libcrypto.a、libssl.a）的做法完全可行，但有个关键细节需要验证：编译OpenSSL时是否明确指定了静态编译选项。

编译OpenSSL静态库时，必须在配置阶段加上no-shared参数，示例命令如下：

./Configure mingw64 no-shared --prefix=/path/to/your/install
make
make install

只有这样得到的libcrypto.a和libssl.a才是不依赖任何动态库的纯静态库。如果没加no-shared，可能会生成依赖libcrypto-1_1-x64.dll这类动态库的"伪静态库"，后续合并后还是需要部署动态库，这点一定要确认。

只要你是用上述方式编译的OpenSSL静态库，你的前置条件就是完全正确的。

二、合并静态库的CMakeLists.txt写法 #

下面是完整的CMake配置示例，包含自研库编译、OpenSSL静态库引入、合并成单一静态库这几个核心步骤：

1. 基础CMake配置 #

cmake_minimum_required(VERSION 3.18)
project(merged_static_lib C)

# 指定C标准（根据你的自研库需求调整）
set(CMAKE_C_STANDARD 11)
# 强制使用MinGW工具链（如果CMake未自动检测到，手动指定路径）
set(CMAKE_C_COMPILER x86_64-w64-mingw32-gcc)
set(CMAKE_CXX_COMPILER x86_64-w64-mingw32-g++)

# 全局配置：禁用动态编译，强制静态链接
set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -static")
set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -static")

2. 编译自研静态库 #

假设你的自研库源码都放在src/目录下，源文件为my_lib.c、my_utils.c：

# 收集自研库所有源文件
file(GLOB MY_LIB_SOURCES src/*.c)
# 编译出自研静态库
add_library(my_lib STATIC ${MY_LIB_SOURCES})

# 引入OpenSSL的头文件路径（替换成你实际的OpenSSL安装路径）
target_include_directories(my_lib PRIVATE /path/to/openssl/install/include)

3. 引入OpenSSL静态库 #

直接指定静态库路径，避免CMake自动匹配到动态库：

# 指定OpenSSL静态库的安装路径
set(OPENSSL_LIB_PATH /path/to/openssl/install/lib)
# 导入libcrypto.a静态库
add_library(openssl_crypto STATIC IMPORTED)
set_target_properties(openssl_crypto PROPERTIES
    IMPORTED_LOCATION ${OPENSSL_LIB_PATH}/libcrypto.a
)

4. 合并两个静态库为一个 #

利用MinGW的ar命令合并静态库，通过CMake自定义命令和目标实现自动化：

# 定义合并后的静态库名称和输出路径
set(MERGED_LIB_NAME merged_my_lib)
set(MERGED_LIB_PATH ${CMAKE_BINARY_DIR}/${MERGED_LIB_NAME}.a)

# 自定义合并命令：用ar工具将自研库和libcrypto.a合并
add_custom_command(
    OUTPUT ${MERGED_LIB_PATH}
    COMMAND ${CMAKE_AR} crs ${MERGED_LIB_PATH} 
            $<TARGET_FILE:my_lib> 
            ${OPENSSL_LIB_PATH}/libcrypto.a
    DEPENDS my_lib openssl_crypto
    COMMENT "Merging my_lib and libcrypto.a into ${MERGED_LIB_NAME}.a"
)

# 自定义目标，让CMake自动触发合并操作
add_custom_target(merged_lib ALL DEPENDS ${MERGED_LIB_PATH})

5. 示例：用合并后的库编译测试应用 #

如果你需要验证合并后的库是否可用，可以添加一个测试程序：

# 测试程序源文件
add_executable(test_app test/test_app.c)
# 链接合并后的静态库
target_link_libraries(test_app PRIVATE ${MERGED_LIB_PATH})
# 链接OpenSSL依赖的Windows系统库（静态链接必须加）
target_link_libraries(test_app PRIVATE ws2_32 crypt32)
# 确保测试程序在合并库生成后再编译
add_dependencies(test_app merged_lib)

三、注意事项 #

• 工具链一致性：务必确保CMake使用的是MSys2/MinGW64下的gcc和ar，不要混用VS的工具链，否则会出现兼容性错误。
• 扩展合并范围：如果你的自研库还依赖libssl.a，只需把${OPENSSL_LIB_PATH}/libssl.a也加入到合并命令的参数中即可。
• 系统依赖处理：OpenSSL静态库在Windows下依赖ws2_32（网络功能）和crypt32（系统加密API），后续用合并库编译应用时，必须链接这两个系统静态库，否则会出现未定义符号错误。

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