Qt for Android 低功耗蓝牙(BLE)开发环境配置与版本兼容性实战

1. 环境准备与版本选择

最近在做一个安卓端的低功耗蓝牙项目，被Qt for Android的环境配置折腾得够呛。最开始想着用Qt5.14.2，结果发现mingw编译器根本搜不到BLE设备，必须用msvc编译器。网上搜了一圈教程，发现添加组件还挺麻烦的，索性直接升级到Qt6.5。

这里给新手朋友提个醒：Qt版本和JDK、cmdline-tools的版本匹配非常重要。我最后用的是Qt6.5 + openjdk17 + cmdline-tools 12这个组合，实测下来最稳定。如果你用Qt6.8，可能会遇到权限弹窗失效的问题，后面我会详细说这个问题。

安装Qt推荐用在线安装方式，速度慢的话可以加镜像源。我试过阿里云和中科大的镜像，中科大的速度更快一些。安装命令是这样的：

.\qt-online-installer-windows-x64-online.exe --mirror https://mirrors.ustc.edu.cn/qtproject

组件选择方面，除非你做UI设计，否则Qt Design Studio基本用不上，可以去掉节省空间。

2. JDK与cmdline-tools的兼容性问题

配置Android环境时，最大的坑就是JDK和cmdline-tools的版本匹配。我第一次装Qt6.5时，点完"设置SDK"就没反应了，就是因为cmdline-tools版本太新。

关键解决方法：找到sdk_definitions.json文件（可以用Everything搜索），把里面的"latest"改成具体的版本号，比如"9.0"。cmdline-tools版本和JDK的对应关系是这样的：