Qt最新版5.13在Windows环境静态编译安装和部署的完整过程(VS 2017/VS 2019)

文章目录

为什么要静态编译
1.源码下载
2. 编译工具下载
- ActivePerl
- Python
- Ruby
- 编译环境选择
3.编译
- 1.修改源码里的qtbase\mkspecs\common\msvc-desktop.conf文件
- 2.配置config文件：
- 3.make
- 4.make install
4.添加到Qt Creator
5.小结

我把在编译好的64位Qt文件放到了GitHub上：zhang0peter/qt-5.13: qt windwos static link

我的个人博客：zhang0peter的个人博客

为什么要静态编译

在默认情况下，用QtCreator编译程序时，使用的是动态编译。编译好的程序在运行时需要另外加上相应的Qt库文件，一大堆dll文件。如果想将生成的程序连同所需要的库一起完整地打包成一个可执行程序，那就需要使用静态编译。Qt官方不提供静态编译好的安装包，所以需要我们在自己的电脑上静态编译。而且exe文件会比动态编译的要小上很多。

1.源码下载

Qt最新版5.13.0的源码下载地址：Index of /archive/qt/5.13/5.13.0/
2019-6-18： Qt 5.13.0版本出来
选择文件：

文件大小794M，解压后2.2 G。

2. 编译工具下载

Qt官方文档要求编译工具：Qt for Windows - Requirements | Qt 5
打开源码目录下的README文件，查看Windows环境下编译需要安装的工具：

ActivePerl

ActivePerl下载地址：Download and Install Perl: ActivePerl | ActiveState
选择最新的版本 5.28

然后注册，再下载：

安装时默认会添加ActivePerl到环境变量。
测试添加是否成功：

Python

同样的方法，下载Python：Download and Install Python: ActivePython | ActiveState
安装时默认会添加Python到环境变量。
测试添加是否成功：

Ruby

Ruby下载地址：RubyInstaller for Windows

安装时默认会添加Ruby到环境变量。
测试添加是否成功：

编译环境选择

在Windows上，有两个预构建环境可供选择：一个是MinGW，另一个是Microsoft Visual Studio(MSVC)。这两个环境不兼容，无法混合。你必须选择一个。
这两者的区别如下：

当你的项目使用MinGW编译的使用，想要用一个MSVC编译生成的库时就会有问题。使用MinGW编译项目的时候，所使用的Lib也要是MinGW编译的。如果你只是开发Window平台的软件时，最好用Qt MSVC组合，这样可以使用大量的第三方lib，还有很多的构建指令，毕竟window上MSVC才是王道。

我选择MSVC，打开安装VS时自带安装的MSCV：VS 2017的开发人员命令提示符

3.编译

在D盘新建一个目录用来存放编译好的内容：D:\qt
在VS 2017的开发人员命令提示符的命令行里进入Qt源代码目录：

1.修改源码里的qtbase\mkspecs\common\msvc-desktop.conf文件

修改-MD为-MT

D的意思是动态编译(dynamic)，T的意思是静态编译（static）。
这一步官方教程没有要求，但其他人的很多教程里都有写，我就加上了

2.配置config文件：

配置命令如下：

configure.bat -static -prefix "D:\qt" -confirm-license -opensource  -debug-and-release -platform win32-msvc  -nomake examples -nomake tests  -plugin-sql-sqlite -plugin-sql-odbc -qt-zlib -qt-libpng -qt-libjpeg -opengl desktop -mp

具体含义如下：

configure.bat
-static //指明是静态编译
-prefix "D:\qt" //指明安装的目录
-confirm-license -opensource  //指明是开源版本的qt
-debug-and-release //指明需要debug版和release版，可以单独选择release版
-platform win32-msvc  //指明使用msvc编译
-nomake examples -nomake tests  //不编译样例
-plugin-sql-sqlite -plugin-sql-odbc -qt-zlib -qt-libpng -qt-libjpeg //可选插件
-opengl desktop
-mp //多核编译

3.make

上面提到过在Windows上，有两个预构建环境可供选择：一个是MinGW，另一个是Microsoft Visual Studio(MSVC)。
我选择的是msvc环境，使用命令nmake即可进行编译。

nmake

但是MSVC自带的nmake没有多线程编译功能，有一个替代功能的软件jom可以进行nmake的多线程编译。
jom的下载地址：Jom - Qt Wiki

运行命令：

D:\jom_1_1_3\jom.exe

我的CPU是i7-6700HQ，CPU100%运行，花费了大约3个小时。

make完成后源码和编译后的共有17.1G大小。

4.make install

因为jom是多线程的运行，但我需要用电脑，所以我使用nmake单线程install:

nmake install

安装完成后，QT的文件夹有2.98G的大小

4.添加到Qt Creator

这里需要说明一下，Qt Creator现在已经不能直接下载最新版本，需要在线安装：Index of /archive/online_installers/3.1
下载后安装最新版的Qt Creator4.9
①添加Qt Versions：

②新建一个构建套件，Qt版本选择刚添加的静态版，其他选项与动态版相同即可。

成功：

一个exe的大小是11M，包括了所有需要的内容。

5.小结

我的个人博客：zhang0peter的个人博客

Qt5.13.0的静态编译的过程还算顺利，需要注意的是编译前要仔细阅读官方文档，毕竟很多教程不是最新的，但官方文档一般都是最新的。