在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的报错:
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 releasemingw32-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.

参考资料

posted @ 2019-03-08 18:30  OhMyGakki  阅读(639)  评论(0编辑  收藏  举报