Windows 11下Flutter执行flutter doctor --android-licenses遇SDK许可证兼容错误

问题场景 #

在Windows 11系统使用Flutter 3.24.5，已安装最新版Android Studio、Flutter及命令行工具，且部署了Android 14.0（UpsideDownCake）API级别35 Revision 3。执行flutter doctor --android-licenses时触发以下错误：

Warning: This version only understands SDK XML versions up to 3 but an SDK XML file of version 4 was encountered. This can happen if you use versions of Android Studio and the command-line tools that were released at different times.
Warning: Errors during XML parse:
Warning: Additionally, the fallback loader failed to parse the XML.

该问题仅影响Android模拟器和物理设备的应用运行，Chrome环境下flutter run可正常执行。

解决方案 #

1. 统一命令行工具与Android Studio版本 #

• 打开Android Studio，进入Settings > Appearance & Behavior > System Settings > Android SDK > SDK Tools
• 勾选Show Package Details（显示包详情）
• 找到Android SDK Command-line Tools，卸载所有旧版本，仅保留最新稳定版
• 点击Apply完成安装，重启Android Studio

2. 手动替换命令行工具（SDK管理器安装无效时） #

• 下载与当前Android Studio版本完全匹配的命令行工具压缩包
• 定位本地Android SDK路径（默认路径：C:\Users\<你的用户名>\AppData\Local\Android\Sdk）
• 进入cmdline-tools目录，删除原有子目录（如latest或旧版本文件夹）
• 将下载的压缩包解压到cmdline-tools下，并重命名解压后的文件夹为latest
• 确认环境变量ANDROID_HOME指向SDK路径，且%ANDROID_HOME%\cmdline-tools\latest\bin已添加到系统PATH

3. 清理并重建SDK配置文件 #

• 关闭Android Studio及所有终端窗口
• 进入SDK路径下的platforms\android-35目录，备份后删除source.properties和package.xml文件
• 重新打开Android Studio，进入SDK管理器点击Apply，让系统重新生成配置文件
• 再次执行flutter doctor --android-licenses尝试接受许可证

4. 临时降级SDK平台版本（Workaround） #

若上述方法无效，可暂时降级SDK平台：

• 在SDK管理器SDK Platforms中取消勾选Android 14.0（API35），勾选Android 13.0（API34）
• 安装完成后执行flutter doctor --android-licenses完成许可证操作，之后再尝试升级回API35

5. 验证修复结果 #

执行以下命令确认修复状态：

flutter doctor
flutter doctor --android-licenses

许可证正常接受后，测试flutter run在Android设备/模拟器上的运行情况。

内容的提问来源于stack exchange，提问作者bardia