Windows 下 Qt 配置 Android 开发环境

晴空慕雪

已于 2025-05-17 18:38:27 修改

阅读量1.6k

点赞数 13

CC 4.0 BY-SA版权

文章标签： windows qt android

于 2025-02-17 16:47:38 首次发布

本文链接：https://blog.youkuaiyun.com/float_stone/article/details/145681119

Windows 下 Qt 配置 Android 开发环境

一、准备
二、下载
三、解压缩
四、环境变量
五、运行命令行
六、Qt设置
七、构建
八、说明

一、准备

提前准备

Windows 10 Pro 22H2
Qt 5.14.2
OpenJDK 17
cmdline-tools
android-ndk-r20b
android-sdk

系统

Windows 10 专业版

Qt版本

下载 Qt 最后一个有离线安装包的版本 Qt 5.14.2 。

JDK、SDK及NDK

JDK 要下载 17 版本的，因为 JDK8 版本太低，可能会有问题；
由于不使用 Android Studio，所以 SDK 我们需要从官网下载 cmdline-tools ；
NDK 需要对应 Qt 版本来使用，这里官方推荐 r20b ，如下图：

二、下载

Qt 下载地址：https://download.qt.io/archive/qt/5.14/5.14.2/，下载 exe 文件；由于 Qt 屏蔽了中国大陆的 IP ，所以这里需要魔法上网。
JDK17 下载地址：https://www.openlogic.com/openjdk-downloads，下滑并选择 17 、 Windows 、 x86 64-bit 、 JDK ，点击下载 zip 压缩包。
SDK 下载官方提供的命令行工具（官网）：https://developer.android.google.cn/studio?hl=zh-cn，下滑找到仅限命令行工具，下载 Windows 的 zip 压缩包。
另在 https://www.androiddevtools.cn/ 页面中下滑找到 SDK Tools ，找到版本 24.4.1 ，下载 Windows 的 zip 压缩包。(包名应该是 commandlinetools-win-11076708_latest.zip)
NDK 从官网下载：https://github.com/android/ndk/wiki/Unsupported-Downloads#ndk-20b-downloads，往下找到 r20b ，根据需求选择 32-bit 或 64-bit 。

三、解压缩

在 C:\ 下创建 Android 文件夹；
解压缩 jdk 压缩包到 C:\Android\ 目录下；
解压缩 cmdline-tools 压缩包到 C:\Android\ 目录下；
在 C:\Android\cmdline-tools\ 目录下创建 latest 文件夹，将 cmdline-tools 目录下原来所有的文件移动到 latest 文件夹下(cmdline-tools 是 sdk 解压后的目录名称)；
解压缩 android-sdk_r24.4.1-windows.zip ，将里面的 tools 文件夹复制到 C:\Android\cmdline-tools\ 目录下；
解压缩 ndk 压缩包到 C:\Android\ 目录下。

四、环境变量

右击此电脑->属性->高级系统设置->高级->环境变量；
在下方系统变量，点击新建，变量名：ANDROID_NDK_HOME ，变量值：C:\Android\android-ndk-r20b ，点击确定；
点击新建，变量名：ANDROID_SDK_ROOT ，变量值：C:\Android\cmdline-tools ，点击确定；
再次点击新建，变量名：JAVA_HOME ，变量值：C:\Android\openlogic-openjdk-17.0.14+7-windows-x64 ，点击确定；
下滑找到 Path 变量，点击编辑，点击右上角的新建，输入 %JAVA_HOME%\bin ，点击确定；
再次点击新建，输入 %ANDROID_SDK_ROOT%\platform-tools ，后面一路点击确定。

如下图：
系统变量
环境变量

五、运行命令行

打开 PowerShell ，进入 C:\Android\cmdline-tools\latest\bin\ 目录下，运行命令：

# 查看可安装的包
.\sdkmanager.bat --sdk_root=C:\Android\cmdline-tools --list

# 下载对应的包
.\sdkmanager.bat --sdk_root=C:\Android\cmdline-tools --install "platform-tools" "platforms;android-30" "build-tools;30.0.0"

输入 y ，按回车，等一会文件就下载好了。

六、Qt设置

打开 Qt -> 工具 -> 选项 -> 点击左侧的设备 -> Android
JDK location 路径设置为：C:\Android\openlogic-openjdk-17.0.14+7-windows-x64；
Android SDK 路径设置为：C:\Android\cmdline-tools;
Android NDK 路径设置为：C:\Android\android-ndk-r20b;
点击下方的 SDK Manager ，再点击右下角的 Native SDK Manager… ，在弹出的 Android SDK Manager 界面中，会自动勾选缺失的文件，点击下方的 Install 按钮，在弹出的二级页面中，手动勾选右侧的 Accept Licence ，点击 Install ，等文件下载好，至此，配置已全部完成。

七、构建

在 Qt 的欢迎页面 -> 示例中，选择 Qt 5.14.2 for Android ，随便找一个 demo 测试一下。
在构建时，可能会因为下载不了 gradle 而导致失败，gradle 下载地址：https://services.gradle.org/distributions/，将 zip 压缩包放进 C:\Users\xxx.gradle\wrapper\dists\gradle-7.4.2-bin\ 下的一长串字符文件夹下即可。