在 Windows 上部署 Qt 5 应用程序

Question

我已经用 QML（Qt 5 的一部分）编写了几个应用程序。在我之前提出的问题 (https://softwareengineering.stackexchange.com/questions/213698/deploying-qt-based-app-on-mac-os-x) 中，我找到了在 OS X 上部署我的应用程序的解决方案（使用 macdeployqt 工具）。

在 Windows 上部署 Qt4 应用程序很容易：

1. 你是在发布模式下编译的。
2. 您复制了必要的库 (DLL)。
3. 您进行了测试，并且成功了。

不幸的是，这种方法在 Qt5 中不起作用（我什至在 qwindows.dll 文件中包含了平台文件夹，但它不起作用）。经过几天的尝试，我放弃并编译了Qt5的静态版本。

再次，它没有工作。该应用程序可以在安装了 Qt 的 PC 上运行，但在“干净”的 PC 上会崩溃。附带说明一下，Windows 8/8.1 系统不会发出警告或消息通知我有关应用程序崩溃的信息。但在 Windows 7 中，一条消息通知我应用程序崩溃了。

我已尝试运行 Dependency Walker (depends.exe)，我的应用程序静态构建中的所有库似乎都很好。

在 Windows 8 中，我没有收到任何错误。但是在对depends.exe 中的应用程序进行分析后，我收到了源自QtGui.dll 的访问冲突。确切的错误是

在地址 0x61C2C000 的“QT5GUI.DLL”中发生第二次机会异常 0xC0000005（访问冲突）。

我是否缺少某些东西（比如额外的 DLL 或配置文件）？

申请信息：

• 使用 Qt 5.2.1 编写和编译
• 使用 Quick/QML。
• 使用网络模块。
• 使用 webkit 模块。
• 使用蓝牙模块。
• QML 文件是用 Quick 2.2 编写的

Answer 1

在 Qt 论坛中挖掘了几个小时后，我发现我需要将“qml”文件夹（通常位于 C:/Qt/5.2.1/qml）复制到应用程序的根目录。这样做之后，我的应用程序的动态和静态版本都可以在 vanilla 系统上运行。

---

程序目录（MinGW 4.8 32 位，动态）：

正如hyde 所说，使用windeployqt 工具（<qt path>\<version>\bin\windeployqt.exe）将必要的文件复制到应用程序的文件夹中。之后，将所需的 QML 组件从 <qt path>\<version>\qml\ 复制到应用程序的文件夹中。生成的文件夹应类似于：

• 平台（文件夹）
• QtQuick（文件夹）
• QtQuick.2（文件夹）
• 您需要的任何其他 QML 组件
• app.exe
• icudt51.dll
• icuin51.dll
• icuuc51.dll
• libgcc_s_dw2-1.dll
• libstdc++-6.dll
• libwindthread-1.dll
• Qt5Core.dll
• Qt5Gui.dll
• Qt5Qml.dll
• Qt5Quick.dll
• Qt5Network.dll
• Qt5Widgets.dll

---

程序目录（静态）

静态编译应用程序，然后将所需的 QML 组件从 <qt path>\<version>\qml\ 复制到应用程序的文件夹中。生成的文件夹应类似于：

• QtQuick（文件夹）
• QtQuick.2（文件夹）
• 您需要的任何其他 QML 组件
• app.exe

---

我认为崩溃的原因是Qt5Gui.dll（动态和静态）在运行时“尝试”加载 QtQuick* 文件夹，但找不到它们（因此在加载期间导致应用程序崩溃）。

Answer 2

从 Qt 5.2 开始，您可以使用 windeployqt 工具。只需从命令行运行它即可获得帮助。但基本用法是，给它.exe文件，它会复制Qt依赖项。

您将需要使用--qmldir 选项让该工具知道您的 QML 文件在哪里，以便它可以找出所需的 QML 依赖项。

关于测试的注意事项：为确保您拥有一切，请在没有 Qt SDK 的计算机上进行测试，或者暂时重命名 Qt 目录。否则应用程序可能会从那里找到丢失的文件...