部署 Qt 应用程序

部署 Qt 应用程序无需任何 C++ 编程。您只需按照本文档中描述的步骤，以发布模式构建 Qt 和您的应用程序即可。

静态库与共享库

部署应用程序有两种方式：

• 静态链接
• 共享库（Mac 平台上的框架）

静态链接会生成一个独立的可执行文件。其优点是只需部署少量文件；缺点是可执行文件体积庞大且缺乏灵活性（即应用程序或 Qt 的新版本发布时，需要重复整个部署过程），并且无法部署插件。

要部署基于插件的应用程序，可以使用共享库方法。共享库还能生成体积更小、更灵活的可执行文件。例如，采用共享库方法后，用户可以独立升级应用程序所使用的 Qt 库。

您可能希望采用共享库方法的另一个原因是，若想在一系列应用程序中使用相同的 Qt 库。事实上，如果您下载 Qt 的二进制安装包，获得的 Qt 就是以共享库形式提供的。

共享库方法的缺点是需要部署的文件会更多。有关详细信息，请参阅《创建共享库》。

部署 Qt 库

除非 Qt 是系统库的一部分，否则必须随您的应用程序一起重新分发。至少需要重新分发应用程序所用库的运行时文件。不过，通过静态链接，Qt 运行时文件可以编译到可执行文件中。

通常，您应部署 Qt 构建中使用的所有插件，但可排除那些您已确定对应用程序及其用户非必需的插件。

例如，您可能需要部署支持 JPEG 和 Qt SQL 驱动程序的插件，但也应部署用户可能需要的插件，包括无障碍辅助功能相关的插件。有关插件的更多信息，请参阅《如何创建 Qt 插件》。

使用 Qt Qml 的应用程序还需随附其所使用的QML 模块。

在使用共享库方法部署应用程序时，必须确保 Qt 库使用正确的路径来查找 Qt 插件、文档、翻译等。为此，您可以使用qt.conf 文件。有关详细信息，请参阅《使用 qt.conf》。

根据具体配置，还必须一并分发编译器专用的库。有关详细信息，请参阅Linux、Windows 和macOS 的平台特定应用程序依赖项。

许可

Qt 的某些库基于第三方库，而这些第三方库并未采用与 Qt 相同的双许可模式。因此，在部署使用这些库的应用程序时必须格外谨慎，特别是在应用程序与这些库进行静态链接的情况下。有关详细信息，请参阅《Qt 中使用的第三方代码》。

QtNetwork 的某些配置在运行时会使用OpenSSL。OpenSSL库的部署受许可和出口限制的双重约束。有关详细信息，请参阅“安全套接层（SSL）类”。

平台特定注意事项

不同平台部署 Qt 应用程序的步骤各不相同：

• Linux 版 Qt
• 适用于 Windows 的 Qt
• 适用于 macOS 的 Qt
• 适用于 Android 的 Qt
• 适用于 HarmonyOS 的 Qt