QT学习笔记-开发环境编译Qt MySql数据库驱动与交叉编译Qt MySql数据库驱动

0、背景

如果需要在QT程序中实现与MySQL数据库的交互,那么必不可少的一环就是对Qt MySql数据库驱动的编译。

1、基本环境

操作系统:Windows10 专业版 64位
Qt版本:Qt 5.15.2
开发环境Qt安装路径:D:\Qt
交叉编译服务器:Ubuntu 18.4
交叉编译服务器Qt安装路径:/opt/Qt
目标芯片:rk3568
目标平台:arm64

Qt安装时需要勾选安装源码,否则是无法找到Qt的数据库驱动源码的。

2、开发环境编译Qt MySql数据库驱动

2.1 依赖说明

  • mysql.h及相关头文件
  • libmysql.lib

因为在编译Qt MySql驱动源码是需要依赖libmysql.lib和mysql.h头文件,在开发环境中(Windows)我们可以通过安装MySql服务
开发环境中MySQL的安装说明:
版本:5.7
安装目录:C:\Program Files\MySQL\MySQL Server 5.7
libmysql.lib所在目录:C:\Program Files\MySQL\MySQL Server 5.7\lib
mysql.h及相关头文件所在目录:C:\Program Files\MySQL\MySQL Server 5.7\include

2.2 MySQL驱动编译过程

1、驱动源码目录:D:\Qt\5.15.2\Src\qtbase\src\plugins\sqldrivers\mysql
2、在Windows的开始菜单中找到Qt5.15.2(MinGW 8.1.0 64-bit)命令行工具
3、切换到mysql驱动源码目录下:D:\Qt\5.15.2\Src\qtbase\src\plugins\sqldrivers\mysql,然后分别执行以下命令
qmake “INCLUDEPATH+=‘C:\Program Files\MySQL\MySQL Server 5.7\include’” “LIBS+=‘C:\Program Files\MySQL\MySQL Server 5.7\lib\libmysql.lib’” -o Makefile mysql.pro
mingw32-make

qmake "INCLUDEPATH+='C:\Program Files\MySQL\MySQL Server 5.7\include'" "LIBS+='C:\Program Files\MySQL\MySQL Server 5.7\lib\libmysql.lib'" -o Makefile mysql.pro
mingw32-make

4、编译后的输出目录:D:\Qt\5.15.2\Src\qtbase\src\plugins\sqldrivers\plugins\sqldrivers
5、把编译后的输出文件libqsqlmysql.a、qsqlmysql.dll、qsqlmysql.dll.debug复制到D:\Qt\5.15.2\mingw81_64\plugins\sqldrivers目录下
6、编译项目需默认引用的目录:D:\Qt\5.15.2\mingw81_64\plugins\sqldrivers
7、要把对应的dll复制到C:\Windows目录下:libmysql.dll

3、交叉编译Qt MySql数据库驱动

3.1 依赖说明

  • mysql.h及相关头文件
  • libmysqlclient.so(注意是目标系统的库-arm版本的库)

3.3.1 如何在交叉编译服务器上找到mysql.h及相关头文件

1、我的交叉编译服务器用的就是构建目标linux操作系统的编译服务器(ubuntu18.4),可以通过安装libmysqlclient-dev软件包获取mysql.h及相关头文件。
2、首先切换到root用户

sudo -i

输入root用户的密码后就切换到root用户了
3、然后执行以下命令(如果未切换到root用户,则前面加上sudo)

apt-get upgrade
apt-get install -y libmysqlclient-dev

如下图:
在这里插入图片描述
4、安装完毕后就可以在/usr/include/mysql目录下找到mysql.h及相关头文件了,如下图:
在这里插入图片描述

3.3.2 如果在交叉编译服务器上获得目标系统(ARM版本)的libmysqlclient.so库

1、在3.3.1中安装libmysqlclient-dev后,也会在/usr/lib/x86_64-linux-gnu目录下部署libmysqlclient.so,但是这个文件不是arm版本的,因此在交叉编译qt mysql驱动时,是不能引用这个库的。如下图:
在这里插入图片描述
2、因为我的交叉编译服务器就是用的构建linux操作系统的编译服务器,因此在构建目标操作系统时,可以通过buildroot的menuconfig勾选mysql的支持以生成arm版本的libmysqlclient.so,如下图:
在这里插入图片描述
3、勾选mysql support后重新构建目标操作系统后,在buildroot的输出目录下的target/usr/lib目录下就包含arm版本的libmysqlclient.so了,如下图:
在这里插入图片描述

3.2 MySQL驱动交叉编译过程

1、我们知道Qt开发的源码,要生成可执行程序一般要通过2个步骤:

  1. 通过qmake生成Makefile
  2. 通过make对源码进行编译生成动态库和可执行程序

交叉编译的思路:首先我们要明白在开发环境中安装qt时自带的qmake是不能作为交叉编译用的,因为他生成的Makefile中所采用的gcc和g++编译器都是对应x86和windows的。再就是我们如果再交叉编译服务器(X86/Linux)上直接安装Linux版本的qt的话,这个qt自带的qmake也不能作为交叉编译用,因为他生成的Makefile中所采用的gcc和g++编译器都是对应x86和Linux的。因此我们首先要找到对应目标系统(Arm/Linux)的qmake才行。

2、我是通过buildroot构建目标操作系统的,因为要在目标系统中运行qt的程序,因此在构建过程中要把qt的环境编译到目标系统中,构建完毕后会在buildroot目录下生成output目标,我们可以采用这下面的qmake生成采用交叉编译器的Makefile,如下:
在这里插入图片描述

qmake的目录为:SDK/buildroot/output/rockchip_rk3568/host/bin/qmake
其中SDK表示编译目标Linux系统的源码目录
rockchip_rk3568对应的是芯片型号

3、我们先把qt源码部署到交叉编译环境中,如下:
在这里插入图片描述
4、通过vim修改mysql.pro工程文件内容,注释掉QMAKE_USE += mysql,如下:
在这里插入图片描述
然后按ESC,输入wq保存退出。
5、然后我们使用SDK/buildroot/output/rockchip_rk3568/host/bin/qmake生成Makefile,同时要执行包含mysql.h及相关头文件所在的目录且依赖的libmysqlclient.so库的路径,如下:

SDK/buildroot/output/rockchip_rk3568/host/bin/qmake “INCLUDEPATH+=/usr/include/mysql” “LIBS+=SDK/buildroot/output/rockchip_rk3568/target/usr/lib/libmysqlclient.so” -o Makefile mysql.pro
其中SDK表示编译目标Linux系统的源码目录
rockchip_rk3568对应的是芯片型号
SDK/buildroot/output/rockchip_rk3568/target/usr/lib/libmyqlclient.so文件是通过交叉编译工具对libmysqlclient-dev源码编译生成的针对目标系统(Arm/Linux)的库文件。

在这里插入图片描述
6、看一下Makfile的内容:

可以看到,这里的Makefile中指定的gcc/g++编译工具就是交叉编译工具,就是能生成Arm/Linux能运行的。
具体目录为:
SDK/buildroot/output/rockchip_rk3568/host/bin/aarch64-buildroot-linux-gnu-gcc
SDK/buildroot/output/rockchip_rk3568/host/bin/aarch64-buildroot-linux-gnu-g++
其中SDK表示编译目标Linux系统的源码目录
rockchip_rk3568对应的是芯片型号。

在这里插入图片描述
7、这时,再执行make就会采用交叉编译工具aarch64-buildroot-linux-gnu-gcc和aarch64-buildroot-linux-gnu-g++进行编译了,
编译完毕后,会生成libqsqlmysql.so,如下图:
在这里插入图片描述

目录:QtSrc/qtbase/src/plugins/sqldrivers/plugins/sqldrivers
其中QtSrc表示Qt的源码目录。

至此终于生成了支持目标系统(Arm/Linux)能够识别的数据库驱动库libqsqlmysql.so。

4、把数据库驱动部署到目标系统中

1、首先通过MobaXterm以SSH方式连接到目标系统(开发板系统)。
2、在/usr/lib/qt/plugins目录下创建目录sqldrivers。
3、把在交叉编译服务器中生成的QtSrc/qtbase/src/plugins/sqldrivers/plugins/sqldrivers/libqsqlmysql.so文件传到目标系统的/usr/lib/qt/plugins/sqldrivers目录下,如下:
在这里插入图片描述

至此,目标系统就支持Qt程序对postgresql数据库的访问了。

5、QT测试程序访问MySQL数据库

5.1 关键代码

void Widget::on_btnDbTest_clicked()
{
    //以下代码测试访问MySQL数据
    QSqlDatabase  db = QSqlDatabase::addDatabase("QMYSQL");
    db.setHostName("xxx.xxx.xxx.xxx");		//数据库服务器的ip
    db.setPort(3306);						//数据库服务器的端口号
    db.setDatabaseName("mydbname");    //此处写你数据库的名称
    db.setUserName("root");			//写mysql数据库的用户名
    db.setPassword("root@123");			//写mysql数据库的密码

    if (!db.open())
    {
        qDebug() << "数据库连接失败!";
        QSqlError lastError = db.lastError();
        qCritical() << lastError.nativeErrorCode() << ", " << lastError.text();
    }
    else
    {
        qDebug() << "数据库连接成功!";
        QSqlQuery query(db);
        if (query.exec("select * from sys_user"))
        {
            qDebug() << "查询表格UserInfo成功!";
            while(query.next())
            {
                qDebug() << query.value(0).toInt() << ", " << query.value(1).toString() << ", " << query.value(2).toString() << "," << query.value(3).toString();
            }
        }
    }
}

5.2 执行结果

把上面的qt程序交叉编译后放入目标系统(arm),执行效果如下:
在这里插入图片描述