Qt静态编译那些坑，你踩过几个？

Qt静态编译那些坑，你踩过几个？

引用

CSDN

等

9

来源

1.

https://blog.csdn.net/weixin_38120390/article/details/137545233

2.

https://blog.csdn.net/BJ4015/article/details/140711732

3.

https://cloud.baidu.com/article/3319045

4.

https://blog.csdn.net/xie__jin__cheng/article/details/142359372

5.

https://cloud.baidu.com/article/3291046

6.

https://blog.csdn.net/allenli0413/article/details/137591703

7.

https://blog.csdn.net/m0_60030015/article/details/138647199

8.

https://www.cnblogs.com/Koomee/p/18237400

9.

https://my.oschina.net/emacs_8812562/blog/17322212

在Qt开发中，静态编译是一种重要的技术手段，它允许开发者将所有依赖库打包进一个独立的可执行文件中，从而实现跨平台部署。然而，在实际开发过程中，开发者经常会遇到各种令人头疼的问题。本文将结合实际案例，详细解析Qt静态编译中常见的错误及其解决方案，帮助读者避免这些坑。

LNK2019链接器错误

这是Qt静态编译中最常见的错误之一。通常发生在使用OpenGL相关功能时，错误信息类似于：

error LNK2019: unresolved external symbol __imp__glBegin referenced in function "public: virtual void __thiscall COpenGlTools::paintGL(void)" (?paintGL@COpenGlTools@@UAEXXZ)

这个错误的原因是缺少必要的静态库。解决方法如下：

1. 打开项目属性页 -> 链接器 -> 常规 -> 附加库目录，添加静态库所在目录，例如：

   C:\Program Files (x86)\Windows Kits\10\Lib\10.0.19041.0\um\u0064
   

2. 在链接器 -> 输入 -> 附加依赖项中添加以下库：

   OpenGL32.Lib
   GLU32.Lib
   

完成上述配置后，重新生成解决方案即可解决问题。

'_uuidof'未声明错误

在使用Direct3D等API时，可能会遇到'_uuidof'未声明的错误。解决方法如下：

1. 打开相应的源代码文件，例如qsgd3d12engine.cpp

2. 将_uuidof替换为__uuidof

3. 在相关头文件中（如qsgd3d12engine_p_p.h）添加必要的包含：

   #include <d3d12sdklayers.h>
   

4. 将静态变量声明修改为内联静态：

   static inline const int MAX_SWAP_CHAIN_BUFFER_COUNT = 4;
   static inline const int MAX_FRAME_IN_FLIGHT_COUNT = 4;
   

Qt的一大优势是其跨平台特性，但静态编译会带来一些平台相关的挑战。

Windows和Linux的差异

• 可执行文件格式：Windows使用PE格式，Linux使用ELF格式
• 库依赖：需要为每个平台单独编译和链接静态库
• 编译器选择：Windows下可使用MSVC或MinGW，Linux下使用GCC或Clang

配置不同平台的编译环境

在Qt Creator中，可以通过以下步骤配置不同平台的编译环境：

1. 打开项目配置 -> Build & Run
2. 在qmake参数中添加-static标志
3. 确保使用正确的静态编译器
4. 在Deploy steps中包含所有必要的静态库

优化程序大小

• 按需编译：只编译项目实际需要的Qt模块
• 去除不必要的依赖：检查并移除未使用的第三方库
• 使用UPX压缩：对最终的可执行文件进行压缩

版本兼容性问题

• 保持库版本一致：确保所有静态库的版本与Qt版本兼容
• 测试不同平台：在目标平台上进行充分测试，确保没有版本冲突

跨平台开发技巧

• 使用交叉编译：为不同平台创建独立的构建配置
• 编写可移植代码：利用Qt的跨平台API，减少平台相关代码
• 持续集成：设置CI环境，自动检测跨平台兼容性问题

通过遵循上述建议，开发者可以有效地避免Qt静态编译中常见的陷阱，创建出更加健壮和可移植的应用程序。虽然静态编译会带来一些额外的工作量，但其带来的便利性和灵活性对于许多项目来说是值得的。