'暗藏'DLL于EXE之内的QT技巧- 静态编译篇

在QT6中将DLL等文件编译到EXE文件中

是的，在QT6中你可以将DLL等依赖文件编译到EXE文件中，这样最终只需要分发一个EXE文件就能运行。有几种方法可以实现这个目标：

方法1：使用静态链接

最彻底的方法是使用静态编译的Qt库：

1. 首先需要从源代码静态编译Qt库（配置时加上 -static 选项）
2. 然后在你的项目中使用静态链接
3. 这样所有Qt库都会被编译进你的EXE文件中

缺点：

• EXE文件会变得很大
• 需要自己编译Qt源代码
• 某些许可证限制（商业应用需要注意LGPL许可证要求）

方法2：使用资源文件嵌入DLL

对于非Qt的第三方DLL，你可以：

1. 将DLL作为资源文件添加到项目中（.qrc文件）
2. 在程序启动时将DLL从资源中提取到临时目录
3. 然后动态加载这些DLL

示例代码：

// 在程序启动时
QFile dllFile(":/resources/mylib.dll");if(dllFile.open(QIODevice::ReadOnly)){
    QTemporaryDir tempDir;
    QString tempPath = tempDir.path()+"/mylib.dll";
    QFile tempFile(tempPath);if(tempFile.open(QIODevice::WriteOnly)){
        tempFile.write(dllFile.readAll());
        tempFile.close();
        QLibrary lib(tempPath);
        lib.load();}}

方法3：使用 windeployqt 和打包工具创建单文件 EXE（方法3详细操作）

以下是使用 Qt 6 的 windeployqt 工具配合打包工具创建单个可执行文件的具体步骤：

第一部分：使用 windeployqt 收集依赖

1. 构建你的 Qt 项目为 Release 版本

   • 在 Qt Creator 中选择 Release 构建
   • 或者使用命令行： qmake && make release

2. 找到生成的 EXE 文件

   • 通常在 release/ 或 build-release/ 目录下

3. 使用 windeployqt 工具收集依赖

   windeployqt --release --no-compiler-runtime --no-translations your_app.exe
   

   参数说明：

   • --release : 只部署 release 版本的库
   • --no-compiler-runtime : 不包含编译器运行时
   • --no-translations : 不包含翻译文件（如需国际化可去掉此选项）

4. 检查生成的文件

   • 这会自动将 Qt DLL、插件和其他必要文件复制到 EXE 所在目录
   • 确保程序能正常运行（双击测试）

第二部分：使用打包工具创建单文件

推荐使用 Enigma Virtual Box （免费工具）：

1. 下载安装 Enigma Virtual Box

   • 官网：

2. 配置打包项目

   • 打开 Enigma Virtual Box
   • 主执行文件：选择你的 your_app.exe
   • 输出文件：设置打包后的 EXE 路径（如 your_app_packed.exe ）

3. 添加文件和文件夹

   • 点击 “Add” 按钮添加所有依赖文件：
     • 所有 DLL 文件
     • platforms/ 文件夹（Qt 平台插件）
     • styles/ 文件夹（如果有使用 Qt 样式）
     • imageformats/ 文件夹（如果有图片处理）
     • 其他资源文件

4. 设置压缩选项

   • 在 “Files Options” 选项卡：
     • 启用 “Compress Files”（压缩文件）
     • 压缩级别选择 “Best”（最佳压缩）

5. 高级选项（可选）

   • 在 “Advanced Options” 选项卡：
     • 启用 “Virtualization”（虚拟化）
     • 启用 “Block Unpacking In Sandbox”（阻止沙箱解包）

6. 开始打包

   • 点击 “Process” 按钮生成单文件 EXE
   • 完成后测试打包的 EXE 是否正常运行

替代工具选项

如果不想用 Enigma Virtual Box，也可以考虑：

1. BoxedApp Packer

   • 商业软件但有免费版
   • 使用简单，支持虚拟文件系统

2. 使用 NSIS 或 Inno Setup 创建安装包

   • 虽然不是单文件，但更专业
   • 可以创建安装程序或自解压包

验证打包结果

1. 将打包的 EXE 复制到一个干净的虚拟机或新系统
2. 运行测试所有功能
3. 使用 Dependency Walker 检查是否还有缺失的依赖

注意事项

• 某些 Qt 插件可能需要特别处理（如数据库插件、多媒体插件）
• 如果使用 OpenGL，确保显卡驱动已安装
• 对于 Windows 10/11，通常不需要打包系统 DLL（如 MSVCRT）
• 杀毒软件可能误报打包后的 EXE，必要时需要添加白名单

这种方法生成的单文件 EXE 在运行时会将所有文件解压到临时目录，然后从那里加载，用户只会看到一个 EXE 文件。

方法4：使用Qt的插件系统

对于Qt插件，可以使用Qt的插件系统并嵌入资源：

Q_INIT_RESOURCE(myresources);
QPluginLoader loader;
loader.setFileName(":/plugins/myplugin.dll");

注意事项

• 静态链接可能涉及许可证问题，特别是LGPL许可证的Qt模块
• 某些DLL可能有动态加载的限制
• 杀毒软件可能会对自解压的EXE文件产生误报

最常用的方案是方法3（打包工具），因为它不需要重新编译Qt且相对简单可靠。