如何编译sioClient_tls.lib？集成时链接错误的解决办法

一、链接错误原因与修复 #

你遇到的LNK2019/LNK2001错误，本质是项目与sioclient_tls.lib的编译环境不兼容，未解析的符号均属于MSVC运行时库或C++标准库组件，具体修复步骤如下：

• 统一编译模式：确保项目与库的编译模式完全一致（Debug对应Debug，Release对应Release），混合模式会导致符号不匹配。
• 匹配运行时库：在项目属性的「C/C++ -> 代码生成 -> 运行时库」中，设置与sioclient_tls.lib相同的选项（如库用MT（多线程静态），项目也设为MT；库用MD（多线程动态），项目设为MD）。
• 对齐C++标准版本：在项目属性「C/C++ -> 语言 -> C标准」中，选择与库编译时一致的标准（如C14、C++17）。
• 同步编译器版本：使用与编译sioclient_tls.lib相同版本的MSVC编译器，不同版本的编译器会生成不兼容的符号。
• 补充依赖库：sioclient_tls依赖OpenSSL，需将OpenSSL的libssl.lib和libcrypto.lib添加到项目的「链接器 -> 输入 -> 附加依赖项」中。

二、编译sioclient_tls.lib的步骤 #

以socket.io-client-cpp库为例，编译流程如下：

1. 准备源码与依赖

   • 获取socket.io-client-cpp的官方源码。
   • 提前编译好Boost、OpenSSL和websocketpp，或通过包管理工具安装这些依赖。

2. 用CMake生成VS项目

   • 创建build目录并进入，执行以下CMake命令（根据你的VS版本调整参数）：

     cmake .. -G "Visual Studio 17 2022" -A x64 -DSIO_TLS=ON -DBOOST_ROOT=你的Boost路径 -DOPENSSL_ROOT_DIR=你的OpenSSL路径
     

     • -DSIO_TLS=ON：开启TLS支持，生成sioclient_tls.lib。
     • 替换你的Boost路径和你的OpenSSL路径为实际的依赖安装路径。

3. 编译生成库文件

   • 打开CMake生成的VS解决方案，选择目标编译模式（Debug/Release）。
   • 找到sioclient_tls项目，右键选择「生成」，编译完成后即可在对应目录下得到sioclient_tls.lib。

4. 关键注意事项

   • 编译时的运行时库、C++标准等设置，需与后续要集成的项目完全一致，避免再次出现链接错误。

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