Window下QtForAndroid Qt5.12.12 安卓开发环境搭建超详细步骤

admin管理员组

文章数量:1122850

一、简介

• 搭建 Qt For Android 开发环境需要安装的软件有：

jdk_8.0.1310.11_64.exe
android-studio-2024.1.2.12-windows.exe
zh.241.230.zip（非必须，android-studio-2024.1.2.12汉化插件）
qt-opensource-windows-x86-5.12.12.exe

二、软件下载

如果需要自己到官网下载，需要在 Qt 官网上看一下 Qt For Android 的描述，必须使用与 Qt 相对应的 Adnroid NDK 版本，否则会出现问题。

2.1 官方下载方式

• 此方式不推荐使用（建议直接查看接百度云共享下载）

2.1.1 Java SDK

• JDK下载地址: JDK8
  
• 选择Window版本的下载：

2.1.2 Android Studio

• AndroidStudio下载地址： Android Studio
• 选择Window版本的下载：

2.1.3 Android Studio 汉化（非必须）

• 汉化插件下载地址：汉化插件

注意：中间是一栏写明这个插件适合哪个版本的 Android Studio

2.1.4 Qt5.12.12

• Qt5.12.12下载地址: Qt5.12.12离线安装包

注意：Qt5离线安装包目前在国内已经被屏蔽了，无法下载，直接访问会显示Download from your IP
address is not allowed；这个需要自行百度解决，下载如下图版本

2.2 百度云共享下载

• 百度云共享地址：Qt5.12.12安卓开发环境

链接：https://pan.baidu/s/1_1aODBUWKUK8q1NODLtNtw?pwd=6xct 提取码：6xct

• 下载如下图文件即可，qt-unified-windows-x64-online.exe为Qt在线安装工具可按照个人需求按需下载

三、软件安装

3.1 JDK安装

• 双击下载的JDK安装程序下一步即可

• 此处可按照需求修改JDK安装位置

• 等待提取安装程序完成

• 这里可再次更改位置

• 等待安装完成

• 安装完成后点击关闭即可

注意：如果安装在默认位置无需配置JDK环境变量，若不是请自行百度JDK环境变量配置

• 可参考此链接配置JDK环境：JDK环境变量配置

3.2 Qt5.12.12 安装

注意：建议先断网这样在使用离线安装包时不需要登录Qt账号

• 双击下载的t-opensource-windows-x86-5.12.12.exe安装包

• 点击下一步

• 此处可以选择安装的Qt位置

• 展开Qt5.12.12的模块安装选项

3.2.1 为安卓开发配置开发模块

• 红色为安卓开发需要的其他 ，可按照自己需要安装模块

• 同意开源协议点击下一步

• 等待安装完成

• 点击结束此时会自动打开Qtcreator

3.2.2 配置安卓SDK管理工具

• 选择配置安卓,也可通过工具>外部>configure>设备>Android进入安卓开发配置界面

• 若jdk安装没有问题，绿色框选部分会显示正常，此时可以进行安卓配置若不正常请重新安装配置jdk
• 选择浏览设置安卓SDK相关工具的安装位置
• 选择设置SDK，Qtcreator会帮做我们自动下载SDK管理工具

• 这里选择yes

• 等待SDK管理工具下载完成

• SDK管理工具下载完成后提示下载SKD其他模块,此处一定注意出现提示下载AndroidSDK时一定不要选择yes,不要用Qtcreator下载安卓SDK

• 选择NO之后出现绿色框中内容就可以下载android-openssl

等待android-openssl下载完成

• 如果无法自动下载可以到github手动下载
• 手动下载 android-openssl 到SDK目录下
  
• 自动下载或者手动下载完成后出现以下绿框部分则为配置成功，然后点击OK关闭Qtcreator
  

3.3 Android Studio 安装

• 双击下载的android-studio安装包点击下一步

• 默认选择，点击下一步

• 这里可以设置安装路径，可按照需要去选择

• 点击安装

• 安装成功时选择下一步

• 点击完成后会自动打开配置向导

• 此处提示发送使用的信息给谷歌，点击 Don’t send

• 欢迎页面，这个图片是提示Android能做的事情有手机、穿戴设备、TV、车载，还有智能设备等，点击 Next

• 提示没有SDK，让你设置代理，这里不设置，点击 Cancel

• Android Studio默认会把你的SDK下载放在C盘，这里你需要选择Custom，然后点击
  Next

• 这里选择SDK的安装目录，这里一定要设置为步骤3.2.2中Qtcreator中配置的SKD位置

• Qtcreator中配置的位置

• 给Android模拟器进行内存设置，推荐4G，这里直接Next

• 点击继续

• 安装Android虚拟器管理驱动，点击Next即可

• 点击接受安卓SDK协议

• 点击接受intel协议

• 点击结束开始安装SDK

• 等待下载完成然后点击结束

• 下载结束后会进入起始页面，点击进入SDK管理页面

• 进入SDK配置页面选择红色框选内容 ，不要关闭此界面

3.3.1 Android SDK相关组件和Qt5.12.12匹配确认

• 打开 Qtcreator安装路径下的sdk_definitions.json文件
• 例如 D:\Qt\Qt5.12.12\Tools\QtCreator\share\qtcreator\android （根据自己安装路径来）
• 可以看到QtCreator默认推荐ndk，build-tools等软件的版本

3.3.2 下载需要的SDK Platforms

• 回到AndroidStudio的SDK配置页面下载以下内容
• 分别选择安卓11.0和安卓8.0
  

3.3.3 下载需要的SDK Tools

• 选择 build-tools 30.0.2和28.03

• 选择NDK 21.3.6528147

- 选择cmdline-tools 8.0 （此处一定要选择8.0不要选择latest）

• 选择谷歌usb驱动和其他相关工具（一般情况下除了usb驱动其他的在向导页面已经下载好了）

• 点击OK开始进入下载页面

• 等待下载完成

• 点击完成

3.4 Android Studio 汉化 （非必须）

• 进入起始页（若按照上步骤完成SDK下载后会自动进入此页面）

3.4.1 安装汉化插件

• 进入其实也得插件页面选择设置

• 选择从磁盘安装插件

• 选择汉化插件（此插件要和AndroidStudio版本匹配）

• 选择重启IDE

• 重启后进入起始页就是汉化版本了

3.5 SDK匹配问题处理（重点查看）

此问题是很多人无法成功配置Qt5.12.12安卓开发环境的主要问题，因为我们使用的是JDK8，Qt5.12.12默认配置里的cmdline-tools版本是lates版本而现在的cmdline-tools的lates版本过高JDK无法支持，所以需要改为8.0版本使用

• 打开 Qtcreator的设备>Android界面 Qtcreator会提示以下问题

• 点击yes 然后再下载确认界面点击显示细节可以看出提示缺少cmdline-tools
  - 注意看完细节后点击Cancel取消下载不然会出其他问题
• 此时关闭 Qtcreator

• 进入我们设置的AndroSDK目录位置找到cmdline-tools文件夹，可以看到里面有我们先前下载好的8.0版本的cmdline-tools

• 进入文件夹确认cmdline-tools的版本

• 若版本无误退回到上一级目录将8.0文件夹名改为latest

• 然后我们找到安装Qt5.12.12的用户目录的sdk_definitions.json文件（需要打开Window的查看隐藏文件功能 ）
• 文件路径例如 C:\Users\Administrator\AppData\Roaming\QtProject\qtcreator\android 其中USers后面的那个账号路径和自己电脑账号有关

• 将sdk_definitions.json文件中的latest改为8.0然后保存退出

• 重新打开 Qtcreator进入Android的配置页面可以看到配置已无错误，且SDK Version
  显示为8.0（这里SDK版本号就是cmdline-tools版本号，我觉得这应该是Qtcreator的一个bug）

• 进入Kits套件界面也可以看到安卓相关的开发套件已经可以使用

3.6 补充安装CMake（若不使用CMake管理工程可以不执行此项）

3.6.1下载CMake

• cmak下载地址： CMake

• 下载Window版本的安装包，版本可以自己按需选择

3.6.2 安装CMake

• 双击安装程序

• 同意条款选择下一步

• 选择添加到环境选择下一步 （可以按需选择创建桌面快捷方式）

• 选择安装位置选择下一步

• 点击安装

• 点击完成

• 重启打开Qtcreator进去Kits套件界面可以看到识别出来的CMake工具

三、重点问题说明

安装时一定按照步骤一步一步来，重点关注加粗内容和注意项，亲测可以成功安装使用。
特别注意安卓SDK的配置步骤，Qtcreator除了第一次提示下载SDK管理工具和android-openssl外其他的都在AndroidStudio中下载，不要在Qtcreator下载NDK，Build-tools等SDK相关模块。

本文标签： 步骤环境详细QtForAndroidwindow