在Windows上面使用QT5 (without QTcreator or VS 2017)

在Windows上面使用QT5 (without QTcreator or VS 2017)

本文环境：

最新版 QT 5.12.1

Windows 10 64位

仅考虑动态链接，静态链接不在本文讨论范围内。

因为嫌弃QT Creator的丑陋和VS 2017的笨重，我决定使用VS Code + 命令行来开发QT应用。

从网上搜索到的教程大多是使用QT Creator或者VS 2017的，我想用VS Code + 命令行来开发QT。本文大体内容网上都可以搜到，但却没人告诉我要在windows配置环境变量。我之前因为配置环境没弄好，卡了好几个小时。最后还是自己摸索着弄好了。

Note：以下教程中的版本号可能有变化，自己对照着来就好了。

第一步：安装QT

1. 从QT下载适用于windows的最新版(5.12.1)离线安装包，开始安装

2. 安装时在Qt 5.12.1栏目下面选中MinGW 7.3.0 64-bit：

   

   在Qt 5.12.1栏下选中 MinGW 7.3.0 65-bit

3. 在Tools栏目下面，取消勾选Qt Creator CDB Debugger Support, 然后勾选MinGW 7.3.0 64-bit, 开始安装。

在Tools栏下选中 MinGW 7.3.0 65-bit

第二步：配置环境变量

添加环境变量

我的安装路径为H:\Qt\Qt5.12.1，安装好后，

1. 为mingw预编译好的QT动态链接库路径为H:\Qt\Qt5.12.1\5.12.1\mingw73_64.
2. mingw编译器路径为H:\Qt\Qt5.12.1\Tools\mingw730_64.

分别将H:\Qt\Qt5.12.1\5.12.1\mingw73_64\bin 以及 H:\Qt\Qt5.12.1\Tools\mingw730_64\bin加入环境变量。

如果电脑上此前安装过mingw并为其配置了环境变量，最好删掉原来的环境变量）

检验环境变量

检验刚刚环境变量的配置是否成功，打开新的cmd或者powershell窗口（在加入环境变量后需要重启cmd或powershell才能生效）

1. 检查qmake命令，输入where qmake，可能有多个结果，只需确保首选路径是刚刚安装好的QT路径即可，即H:\Qt\Qt5.12.1\5.12.1\mingw73_64\bin。

   

2. 分别检验mingw32-make, g++, gcc，首选路径应该位于H:\Qt\Qt5.12.1\Tools\mingw730_64\bin中。

   

如果找不到qmake的路径或者没有输出结果，请重启cmd或powershell

第三步：第一个Hello World GUI程序

1. 编写Hello World

新建一个文件夹example, 在该文件夹里创建名为hello.cpp的文件，填入如下内容：

#include <QApplication>
#include <QPushButton>

int main(int argc, char **argv)
{
    QApplication app (argc, argv);
    QPushButton button ("Hello world !");
    button.show();
    return app.exec();
}

2. 初始化QT项目

在example目录中打开一个命令行窗口，输入qmake -project，会在目录下生成一个与当前目录同名的pro文件，在这里是example.pro。

.pro文件是QT项目的配置文件，可以指定项目的名称、项目所用到的c++源码等等。

我们的GUI程序中使用到了QT Widgets模块，因为qmake -project不会自动导入Qt Widgets模块, 我们需要在example.pro文件中加入一行代码QT += widgets。

此时，example.pro里面的内容应该变为：

######################################################################
# Automatically generated by qmake (3.1) Thu Mar 7 14:03:07 2019
######################################################################

TEMPLATE = app
TARGET = example
INCLUDEPATH += .

# The following define makes your compiler warn you if you use any
# feature of Qt which has been marked as deprecated (the exact warnings
# depend on your compiler). Please consult the documentation of the
# deprecated API in order to know how to port your code away from it.
DEFINES += QT_DEPRECATED_WARNINGS

# You can also make your code fail to compile if you use deprecated APIs.
# In order to do so, uncomment the following line.
# You can also select to disable deprecated APIs only up to a certain version of Qt.
#DEFINES += QT_DISABLE_DEPRECATED_BEFORE=0x060000    # disables all the APIs deprecated before Qt 6.0.0

# Input
SOURCES += hello.cpp

QT += widgets

PS：如果你不加入QT += widgets，在编译时，会出现fatal error: QApplication: No such file or directory的报错：

PPS：为什么应该加入QT += widgets？我们的App中，导入了QApplication类(#include <QApplication>)，在官网查看QApplication类的文档，可以看到文档的起始处，表格里面有qmake: QT += widgets，所以

在Tools栏下选中 MinGW 7.3.0 65-bit

PPPS：每次修改QT的.pro配置文件后，需要执行mingw32-make clean清理之前的编译残留文件，并重新运行qmake生成新的Makefile。

PPPPS：新增源代码文件后，需要手动将源文件名加入.pro文件中，或者重新运行qmake -project命令，生成新的.pro文件。

3. 编译及运行

首先，在hello目录下执行qmake命令，这样会生成相应的Makefile文件。

然后，在hello目录下执行mingw32-make命令，开始编译，最后会生成一个release文件夹，里面就是一个我们的可执行文件example.exe了。双击example.exe我们就可以看到Hello World啦！

第一个QT5 App：Hello, World !

PS: mingw32-make release和mingw32-make debug分别生成release和debug版本的可执行文件，mingw32-make默认指代mingw32-make release。

第四步：分发应用

我们在上一步得到了单个可执行文件example.exe，是不是意味着我们就可以分发我们的应用了呢？非也。这个example.exe依赖了我们本机上的QT动态链接库，如果是在其他没有安装QT的电脑上，这个小小的可执行文件是运行不了的。

还好，QT为我们提供了打包动态链接库的工具——windeployqt，使用这个工具，我们就可以将动态链接库与我们的可执行文件打包在一起了。

windeployqt的默认路径为H:\Qt\Qt5.12.1\5.12.1\mingw73_64\bin\windeployqt.exe，由于我们之前为这个目录添加了环境变量，我们可以直接使用windeployqt命令运行该工具。

打包动态链接库

在release目录里，打开一个命令行窗口，执行windeployqt命令，它会自动扫描并添加我们的可执行文件依赖的动态链接库。

将release整个目录搞成一个压缩包，发给你的小伙伴，他们也能愉快的运行你的程序啦。

windeployqt不会自动打包C++运行库，不过一般电脑上都有，在极少部分新系统上，可能无法运行。你不嫌麻烦的话，可以利用dependeny walker添加C++ Runtime.

参考资料

• C++ Tutorial: Create QT applications without QTCreator
• Qt Windows 命令行编译环境搭建