M1 Macbook Air用VSCode构建Flutter Android项目报错：android.jar不存在

问题核心 #

构建时提示缺少/Users/gimmingi/Library/Android/sdk/platforms/android-31/android.jar，原因是项目编译配置指定了API 31，但本地未安装该版本的Android SDK平台包。

解决方案 #

方案1：通过Android Studio安装API 31 SDK

• 打开Android Studio，点击顶部菜单 Tools > SDK Manager
• 切换到SDK Platforms标签，找到Android 12 (API 31)，勾选该选项后点击Apply完成安装
• 安装完成后重启VS Code，重新运行Flutter项目

方案2：通过命令行安装API 31 SDK

• 终端执行命令确认Android许可证：

  flutter doctor --android-licenses
  

• 执行命令安装API 31平台包（确保sdkmanager在系统PATH中，或进入~/Library/Android/sdk/tools/bin目录执行）：

  sdkmanager "platforms;android-31"
  

方案3：修改项目编译版本（匹配已安装的SDK）

如果不想安装API 31，可以修改项目配置使用已安装的SDK版本（比如你已有的API 33）：

• 打开项目目录下的android/app/build.gradle文件
• 找到以下配置项，将版本号改为33：

  android {
      compileSdkVersion 33
      defaultConfig {
          targetSdkVersion 33
      }
  }
  

• 保存文件后，执行flutter clean清理缓存，再重新运行项目

额外注意 #

• M1 Mac设备确保安装的Android SDK是arm64架构版本，Android Studio默认会适配M1芯片下载对应版本
• 若使用Android 10（API 29）模拟器，也可将compileSdkVersion和targetSdkVersion改为29，需确保已安装API 29的SDK平台包

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