Windows下MinGW编译静态Qt5 I

女爷i 2022-08-08 17:54 268阅读 0赞

译自 [http://wiki.qt.io/Building\_a\_static\_Qt\_for\_Windows\_using\_MingW][http_wiki.qt.io_Building_a_static_Qt_for_Windows_using_MingW]。非专业翻译，掺杂个人理解，有删减。

注：仅支持Qt5，Win7或更高版本的系统。

# WHY #

qt.io下载的Qt安装包for windows是动态链接的，安装过程中一并安装了DLL文件。在动态环境下生成的Qt应用程序将动态调用这些DLL文件。

在开发、调试过程采用动态库真真是极好的，因为一切都是现成的，可以直接享用。

**然而**，如果现在要把程序部署到没有安装Qt的系统中，情况就复杂了——必须把程序调用的DLL一股脑部署过去。就算你祭出经典的 [DLL Dependency Walker][]神器，也不一定能分析出程序依赖的所有库文件。（译注：我都是用最笨的方法，反复地尝试，把缺失的dll文件拷贝过去，直到程序能正常工作。如果你有更好的办法，请告诉我）

**所以**，部署静态版本的应用程序更省事。

而构建应用程序的静态版，需要：Qt动态环境 + Qt静态版本。

下面将介绍如何用Windows PowerShell脚本，自动下载、构建和安装Qt静态开发环境。

注意：Qt4及更早的版本在Windows下构建、安装静态版本存在点问题。而Qt5对Windows下静态编译的支持度更好，本文即是基于Qt5。

# **MinGW vs. MSVC** #

Qt安装包有MinGW版和Microsoft Visual Studio版，它们互相不兼容、不可混用。择一而用之。

本文讲述如何用MinGW编译静态版Qt。如果用MSVC，可以参考下述的大致思路，但操作方法断然是有差别的。

# **目标环境** #

要在Windows下开发Qt程序，且后续部署到Windows平台，推荐按以下方式搭建开发环境：

*  动态版，安装路径C:\\Qt
 *  静态版，安装路径C:\\Qt\\Static。安装方法遵循本文描述的步骤。

动态版用来开发和调试。包括Qt命令行工具，GUI工具如Qt Creator, Assistant, Linguist等。

开发调试完成后，用静态版进行部署。静态版只有命令行工具。至于为什么不构建静态版的GUI工具，理由至少有二：

> 一是部署应用程序的工作通常都是用脚本自动完成的，不需要GUI工具；
> 
> 二是构建Qt Creator静态版不很可行，因为插件(plugins)不支持静态环境。

# **限制** #

静态编译应用程序让部署更简单，但也存在一些限制。记得预先检查是否符合这些限制条件：

1.  许可问题（略）
2.  静态编译的程序不支持动态模块化方法。 //不支持自定义DLL？。。。

另外还要注意：

*  静态版的可执行文件比动态版体积大。不过由于动态版要同时部署DLL，所以总的体积来说，静态版更小。
 *  静态版将解除对Qt或MinGW的DLL依赖。但不能解除对Windows DLL的依赖，比如kernel32.dll, user32.dll（略）

# **准备工作** #

## 1 安装Qt动态版 ##

> 从 [qt.io][]下载"Qt 5.5.0 for Windows 32-bit (MinGW 4.9.2, 959MB)"。你可以选择其他版本，但建议：待编译的源代码版本号＝安装包版本号。
> 
> 安装到默认路径（C:），安装时勾选Tools下面的MinGW选项。

## 2 Windows PowerShell ##

> 要求安装PowerShell 3.0或更高的版本。Win8已自带，Win7从 [微软][Link 1]下载安装（译注：打开后按照页面指引选择版本）。WinXP、Vista不支持PowerShell 3.0，因此本文的脚本不支持Win7以前的版本。

## 3 7-Zip ##

> 确保已 [下载][Link 2]安装7-Zip。

# **构建Qt静态环境** #

## 1 下载、运行，搞定 ##

> [下载][Link 3]并执行脚本windows-build-qt-static.ps1。
> 
> 上述链接从一个小型开源工程 [QtIMovie][]的git库直接获取脚本。你可以瞅一眼这个工程，里面包含一些构建脚本示例。
> 
> 右键单击 **windows-build-qt-static.ps1**，选择“使用PowerShell运行”。
> 
> 脚本将会执行以下步骤：

1.  下载Qt源代码
2.  用动态版本中的MinGW构建Qt静态版本。构建库和命令行工具（qmake, moc, uic, lupdate, lrelease等）。
3.  默认安装静态版Qt到C:\\Qt\\Static。

> Qt 框架 复杂，代码量相当大，脚本的执行可能需要若干小时，请耐心等待。

## 2 命令行运行 ##

> 除了右键“使用PowerShell运行”，也可以从PowerShell启动windows-build-qt-static.ps1:
> 
> windows-build-qt-static.ps1  \[-QtSrcUrl  *url*\] \[-QtStaticDir  *directory*\] \[-QtVersion  *string*\] \[-MingwDir  *directory*\] \[-NoPause\]

## 3 命令行参数说明 ##

> \-QtSrcUrl  *url*
> 
> 指定Qt源文件URL。脚本默认包含最新版本的URL硬编码。
> 
> 也可以直接修改脚本：
> 
> $QtSrcUrl = "http://download.qt-project.org/official\_releases/qt/5.5/5.5.0/single/qt-everywhere-opensource-src-5.5.0.7z",
> 
>   
> 
> 
> \-QtStaticDir  *directory*
> 
> 指定安装Qt静态环境的根目录。默认为C。
> 
>   
> 
> 
> \-QtVersion  *string*
> 
> 指定Qt版本号。默认情况下，脚本会从Qt源文件名称中获取版本号。假如真有辣么一天Qt源文件名的格式变了，你可能得显式指定这个参数值。
> 
>   
> 
> 
>   
> 
> 
> \-MingwDir  *directory*
> 
> 指定MinGW环境的根目录。默认使用已安装的Qt中自带的MinGW。
> 
>   
> 
> 
> \-NoPause
> 
> 执行结束后不等待用户 *回车*。
> 
>   
>

[http_wiki.qt.io_Building_a_static_Qt_for_Windows_using_MingW]: http://wiki.qt.io/Building_a_static_Qt_for_Windows_using_MingW
[DLL Dependency Walker]: http://www.dependencywalker.com/
[qt.io]: http://qt.io/download
[Link 1]: http://www.microsoft.com/en-us/download/details.aspx?id=34595
[Link 2]: http://www.7-zip.org/
[Link 3]: https://sourceforge.net/p/qtlmovie/code/ci/master/tree/build/windows-build-qt-static.ps1?format=raw
[QtIMovie]: http://sourceforge.net/projects/qtlmovie/