Qt | windows Qt6.5.3安卓环境搭建成功版(保姆级教程)

01、第一章 Qt6.5.3安装 资源

Qt 国内下载地址清华大学开源软件镜像站	mirrors.tuna.tsinghua.edu.cn/qt/archive/...
Qt 阿里云盘下载	Qt 安卓开发www.alipan.com/s/kNaues6CH... ，无需下载极速在线查看，视频原画倍速播放。

大部分网友说通过以下方式打开.exe文件安装更快，但是我这样做提示错误，所以我是直接点击安装的，通过华为手机USB连接电脑，苹果手机分享热点给华为，下载挺快，十几分钟吧。步骤如下：

1.把下好的安装器拖到命令窗口里，如图：

2.在路径后加上：

qt-unified-windows-x64-4.6.0-online.exe --mirror https://mirrors.tuna.tsinghua.edu.cn/qt

如图：

02、Qt6.5.3安装

【1】我已经安装过了，这里就通过MaintenanceTool.exe工具演示安装过程，双击打开

【2】点击MaintenanceTool.exe和qt-unified-windows-x64-4.6.0-online.exe有些界面相同。

【3】不让官方烦你

【4】安装路径选择

【5】安装组件最为重要，因为有MaintenanceTool.exe维护工具嘛（后续再打开下载其他组件），所以如果难等，第一次下载必须的即可。例如安装如下：

【1】安卓【2】MinGW【3】Qt Creator

【6】选择开源协议，商用务必注意律师函

LGPL（Lesser General Public License）是一个开源软件许可证，它是GNU通用公共许可证（GPL）的一个分支。LGPL许可证的主要目的是允许开发人员使用LGPL许可证下的软件组件来构建他们的商业应用程序，同时确保这些组件不会与专有软件捆绑在一起。以下是LGPL许可证的一些主要特点：

1. 兼容性：LGPL许可证允许将LGPL软件与其他非LGPL软件一起使用，只要不将这些组件用于创建专有软件。

2. 版权声明：LGPL许可证要求任何对LGPL软件的修改都必须以相同的许可证（LGPL）发布。

3. 专利授权：LGPL许可证要求所有在LGPL软件中使用或实现的专利都必须公开披露。

4. 限制商业使用：虽然LGPL许可证允许商业公司使用LGPL软件，但它禁止将这些软件用于创建专有软件或限制其他开发者使用这些组件的权利。

5. 源代码保留：LGPL许可证要求分发LGPL软件的源代码，以便其他人可以对软件进行修改和重新分发。

6. 维护和支持：LGPL许可证要求维护和更新LGPL软件，以确保其长期可用性和兼容性。

7. 转让限制：LGPL许可证禁止将LGPL软件或其修改的商业权利转让给第三方。

总的来说，LGPL许可证提供了一种相对灵活的方式来共享和改进开源软件，同时保护开发者和公司的知识产权。

【7】开始安装

03、安装完成后的一些环境配置

【1】通过这里查看安装的位置

【2】添加桌面快捷方式，打开文件位置，这里以Qt Creator为例，其他以此类推。

我是将所有Qt工具放在了文件夹，方便操作

安装成功的界面

查看版本

【3】添加环境变量，win+r输入sysdm.cpl

点击path

这里Qt安卓所需的Qt6.5.3、java 11 JDK 可以参考

04、Qt 安卓环境安装 JDK

java 11安装：

如果需要配置Android 开发环境，需要安装Java JDK(注意的是：java版本不能过高或过低，会出现各种问题，建议用Java 11。QCreate 会根据相应的组件配置SDK、NDK。亲测jdk-8uxx会报错，手动配SDK、NDK会出错。) 如果Windows是64位，必须按相应的位数安装软件。

我安装了java11 和 java17 都可以吧

java 11 官网	www.oracle.com/java/techno...
java 17 官网	www.oracle.com/java/techno...
java JDK安装方式多种，涉及商用的最好网上查查，选择开源的版本，避免律师函	adoptium.net/zh-CN/temur...

【1】我安装的是jdk 11 可以通过win + r命令查看cmd

查看路径，两个java.exe 分别是11 和 17

安装默认下一步即可，最好默认在C盘不然自己配置环境变量比较难。

打开Qt 配置JDK

如果你下载了Qt Creator，想直接安装java JDK看3后面的那个网络图标，点击可以去安装。其他的类似。

05、Qt 安卓环境安装 SDK和NDK

大部分网友都没有利用Qt Creator工具，慢慢的去其他网站下载拼凑，其实可以直接通过Qt Creator进行安装。但是我还是给出其他网站的下载地址

SDK	www.androiddevtools.cn/
NDK	developer.android.google.cn/ndk/downloa...
android studio 这个工具最全能可以下载SDK、NDK、和安卓虚拟机，就是假的桌面手机，用于调试，但是最新版安装会出现一些版本不兼容的问题。主要用来安装虚拟机	developer.android.google.cn/studio?hl=z...
我的方法直接采用Qt Creator安装SDK和NDK	具体如下

【1】设置SDK：主要用于下载SDK和NDK,记得先创建空的目录AndroidSDK,在点击设置。选择"设备"->"Android"->JDK位置，通过"浏览"按钮，将JDK位置设置为刚刚安装的JDK路径

设置Android SDK

Qt本身带了配置Android SDK的工具的，配置JDK位置的图中，下面一行就是Android SDK，这里的路径可以不做修改，直接点击"设置SDK"按钮，会提示"是否下载并安装安卓SDK到xxx路径"，点击是即可开始下载安卓SDK

之后会提示："确实安卓SDK所必要的包，是否安装缺失包"，点击"确认"

跳出安卓SDK管理器后，所有的都点"是"，就开始安装了（到这里都不需要梯子）

安装完成后，会自动开始设置安卓OpenSSL，这里基本都会失败，而且是可选项，可以直接取消掉。但是我的是成功的，更多还是网络问题。大家可以试一试。

【2】先设置空目录也行，直接下载OpenSSL也行。试一试

【3】通过SDK管理器可以更新SDK和NDK路径，也可以手动添加。

NDK

SDK

刷新成功后的界面，出现这个界面，说明你的Qt 安卓环境已经成功百分之99了，后续安装 安卓虚拟机进行调试就可以了。

06、Qt官方文档提供的 Qt for Android

打开Assistant 6.5.3 (MinGW 11.2.0 64-bit)，查看Qt官方文档怎么解释配置Qt的。

Qt 6.5支持以下开发环境和目标系统配置：

此Qt版本支持以下配置：

自动化测试中使用的目标设备,红框是我尝试的测试虚拟机，可行。点击这些文字可以进入各个手机品牌的官网。

注：上述内容仅作参考，我实际并未采取Qt官方推荐的版本。

07、Qt 配置安卓测试虚拟机

在上述下载好JDK、SDK、NDK后，可以通过SDK管理器是否有相关的虚拟机。

这里包含的所有安卓虚拟机调试工具，包括PC端虚拟机和手机端USB调试。

如果你没有这个界面那就继续下载这个工具。

08、Android Studio 安装

需要申明，这个是备选方案，如果可以直接通过上述实现，没必要给自己挖坑。

【1】developer.android.google.cn/studio?hl=z...

【2】这是我下载的版本android-studio-2024.1.1.11-windows.exe

【3】双击.exe一直下一步即可。我安装完后的目录

【4】可把Android Studio添加到桌面，方法上面介绍过。

【5】这里一定要按我的方法设置，不然你会懵逼，打开SDK Manager

【6】第一点击Edit 下载，记得创建空的目录，并命名SDK

但是我下载的这个版本的Android API 35 版本已经超出了Qt 官方文档范围API 26 to API 33 ,不知道是不是这样，不过我还是下载了，电脑双内存不带虚的，哈哈哈

这是下载后的目录

【7】只有先下载上述，才可以进行以下两项选择

【8】这里有一点疑问的是，Qt SDK管理器里面的虚拟机和这个的是不是一样的我没试过。如果要在这里下载对应的SDK 勾选后点击应用就会跳转自动下载。

比如我要卸载Android 12.0 ("s")

【9】安装SDK Tools , 以下是我安装的。

【10】安装完后，点击返回，这个时候你会发现之前灰色的Vitual Device Manager 变为可按了，主要设置调试机。

点击+创建一个

在windws我一般选择 x86 Images

真机调试，我选择

安装后，点击这里弹出模拟机，才说明你安装成功了。

例如这里我之前写的，ph13

x30i

OK，到这里我们已经完成了99%，下面我们通过创建一个安卓APP，来加深印象和解决一些问题。

09、Qt Creator 创建安卓APP 准备

这里是PC 模拟机 。不是真实的USB调试机。

【1】先在设备创建模拟机，点击SDK管理器，点击需要下载的工具，点击应用就会自动下载。

【2】以下模拟机其实下载一个就行，我把我安装的列给大家参考。

【3】设置调试设备，没有设置模式只有这两个。

设置后

点击启动AVD可以打开模拟机，后面你点击运行也是同理。

【4】配置构建套件，没配置前可能是感叹号，运行不了，各种报错。

如果进入这里，没有安卓的 Run device 那就点击管理去添加。

开启向导，进行选择

【5】注意注意，很多人到这步就卡死了，原因就是没有选对真正的模拟机。默认这个是不行的。

我这里必须选择pixel_x类型的，因为下载的时候就决定了，具体看上面的内容，每一步都很关键。

架构（ABI）:

x86	32位 如 win7
x86_64	64位 win10-win11
armeabi-v7a	不稳定 USB真机调试
arm64-v8a	推荐 USB真机调试

目标API:是在SDK管理器下载的

我们以这个为例，创建一个APP

10、Qt 安卓APP创建 PC 模拟机调试

【1】创建APP

选择 x_86_64

点击完成，在点击Debug按钮

点击管理选择我们刚才创建的ph15pro

点击运行，第一次运行时，如果有提示错误，点击逃过就行，或者清除构建，重新构建。

稍等片刻后，运行如下：

【2】常见错误，例如这里选择的不是x_86_64而是这个，就会报错。

快速创建一个项目，并运行。错误如下，主要的平台导致。

【3】关于大部分网友说的SDK目录的cmdline-tools版本过高的问题，导致SDK识别失败。因为我们最后还是采纳了采用Qt Creator自带的SDK设置，SDK和NDK所以下面这个SDK我其实没用到。但是下载链接我放在了上面，大家自己有需要可以下载试一试。最好按照我的方法。

【4】关于部分网友说的gradle版本高的问题，我是没有遇到。如果遇到下载低版本后，替换这个目录。所谓的用户就是当前使用这台电脑的账号，你的可能是User

点击wrapper , 将下载下来的gradle-7.4.2-bin.zip替换即可。我的这个是自动下载完成的。

其他问题暂时没有遇到，参考了CSDN数十篇文章，终于完成了安卓的PC端调试，辛苦自己了。

11、Qt 安卓APP创建 真机USB调试

真机 华为x30i	Android 版本 12

【1】先打开手机USB调试模式。

以下界面不易展示，需要点击7次左右 版本号 才能开启调试模式

之后在打开系统和更新。

开启USB调试

1、用usb线连接好电脑并进入开发者选项，手机需要勾选USB调试

（打开手机设置-开发人员选项-调试-打开USB调试）

查看是否连接好电脑

以华为Mate 20为例，在开发人员选项中打开"USB调试"开关（建议同时打开"仅充电"模式下允许ADB调试，防止USB调试自动关闭）：

手机上可能会提示"usb连接仅限充电模式"，此处应该将"只充电"改为"媒体设备（MTP）"模式或者传输文件 ，也可以在USB模式界面找到 【选择USB 配置 】设置MTP

打开cmd，输入"adb devices"可检测手机是否正常连接：

我的adb是安装SDK时，自动安装了，如果你没有自己网上找吧。

>adb    //查看是否安装好，会有相关提示信息>adb kill-server    //关闭>adb start-server    //开启

如果通过adb devices 没有手机信息确认是否安装了：Google USB Driver

点击右键去安装驱动程序

尝试了几十种网上的方法，均已失败告终，先更新内容吧，后面解决了在补充，成功的同志私信我。

总结

【1】首先/优先尝试Qt官方的方法

【2】其次/尝试我的方法

【3】尝试网友的方法

【4】有很多细节，有些坑你不得不踩，加油吧！！！

【5】希望能帮助和我一样的小白。

故我在

Qt历险记

一名技术分享师，分享方向:->Qt（C/C++、linux、STM32、MySql/Sqlite3、TCP/UDP)，设计方面->Ai、PS、visio、AD、Protues。