Qt 6.3 Windows10下部署Android项目到USB设备失败 求助环境配置

问题1：Gradle版本不兼容导致编译失败（androiddeployqt 退出码14） #

根因 #

Qt 6.3 配套的Android Gradle插件最低要求Gradle 7.0.2版本，初始使用的Gradle 5.6.4不满足版本校验规则，触发com.android.internal.version-check插件拦截。

修复操作 #

• 打开构建目录下的配置文件：C:\Users\o\Documents\build-TrackGate-Android_Qt_6_3_0_Clang_armeabi_v7a-Debug\android-build\gradle\wrapper\gradle-wrapper.properties
• 修改distributionUrl配置项，将原Gradle 5.6.4的地址替换为Gradle 7.0.2对应的分发包地址
• 修正Qt Creator的JDK配置：进入工具->选项->设备->Android配置页，JDK路径直接指向JDK 11.0.15的根目录即可，无需单独配置jre路径——Gradle 7.0.2可直接适配无内置jre的JDK 11版本，无需额外安装独立jre包
• 清空构建缓存：删除android-build目录下所有已生成的缓存文件，重新执行qmake后触发构建

版本匹配说明：Qt 6.3与你当前安装的NDK 22.1.7171670、Android SDK Platform 32、Android Studio Chipmunk 2021.2.1为官方验证兼容组合，无需调整上述组件版本，避免引入额外兼容性问题。

问题2：ADB连接异常导致部署失败（androiddeployqt 退出码16） #

根因 #

adb进程无法正常访问已USB连接的测试设备，导致无法拉取设备端系统依赖文件、无法向设备安装APK，通常由adb服务冲突、设备调试授权未完成、权限不足导致。

修复操作 #

• 打开Windows命令提示符，执行adb devices查看设备状态：
  • 若设备DVKS100I21060300956状态显示为unauthorized，在测试设备弹出的USB调试授权窗口勾选「始终允许此计算机调试」后确认
  • 若设备不在列表中，依次执行以下命令重启adb服务：

  adb kill-server
  adb start-server
  

  重启后再次执行adb devices确认设备正常显示，状态为device
• 调整设备USB配置：将USB连接模式从「仅充电」切换为「文件传输（MTP）」模式，关闭电脑上所有可能占用adb端口的程序（包括第三方手机助手、Android Studio设备监控进程、其他Android调试工具）
• 统一adb版本：确认Qt Creator Android配置页中指定的SDK路径下platform-tools\adb.exe，与系统环境变量中调用的adb程序为同一版本，避免多版本adb冲突导致设备识别异常
• 修复权限问题：右键点击Qt使用的adb.exe程序，选择属性->兼容性，勾选「以管理员身份运行此程序」，同时给Qt Creator主程序开启相同的管理员权限，重启Qt Creator后重试，解决adb拉取system分区文件时的权限不足问题
• 部署前先手动卸载测试设备上已安装的同包名旧版测试应用，避免签名冲突导致安装失败
• 若执行adb pull系统文件仍然报错，进入测试设备的开发者选项，开启「USB调试（安全设置）」相关权限，解除system分区的读取限制后重试。

内容的提问来源于stack exchange，提问作者Mafona Pius Pascal Thobakgale