Qt for Android配置记录

关键词：Qt、C++、Android

前言

一开始想着弄个安卓软件玩玩，但是不想学 Java，于是乎发现了 Qt for Android。

配置过程

前期准备

使用的是 Qt6.5.3 的 Android 组件。

我尝试过使用 Qt6.6.1 和 Qt5.15.2 的 Android 组件，但不成功，原因未知。

Java 方面，JDK 使用 Java 17，下载地址

这里简单说一下 JDK、SDK 和 NDK：

• JDK：Java Development Kit，是整个Java的核心，其中包括Java编译器、Java运行工具、Java文档生成工具、Java打包工具等
• SDK：Software Development Kit，软件开发工具包
• NDK：Native Development Kit，是 Android 的一个工具开发包

创建 Qt Android 项目

1.新建项目

像之前一样正常新建项目

2.选择安卓构建开发

点击管理，可以进入设置页面。设置好 JDK 路径 和 SDK 路径。

可能还需下载配置安卓 OpenSSL。

设置完成如下图：

3.正常项目开发

完成设置后进入项目，可以进行代码编写和界面设计

release下需要生成 apk 签名：

4.效果展示

编译并连接手机运行，手机打开开发者选项，进入 USB 调试，打开 USB 安装功能（建议打开文件传输功能）。编译过程比较漫长。

问题汇总

1. 编译时下载 gradle 卡住超时退出。

• 解决办法：找到 ..\build-demo-Qt_6_5_3_Clang_arm64_v8a-Debug\android-build\gradle\wrapper 目录下的 gradle-wrapper.properties，使用记事本打开，修改为 distributionUrl=https://mirrors.cloud.tencent.com/gradle/gradle-8.0-bin.zip，然后继续编译生成。

2. 出现红色报错 Failure [INSTALL_FAILED_USER_RESTRICTED: Install canceled by user]。

• 解决办法：确认手机是否进入 USB 调试模式，且打开 USB 安装。