Visual Studio Code中.NET MAUI项目Android SDK识别异常求助

问题原因 #

VS Code的.NET MAUI扩展未正确识别Visual Studio for Mac已安装的Android SDK路径，或是缺失build-tools/34.0.0组件导致检查不通过，另外SDK许可未完全同步也可能引发该提示。

解决步骤 #

1. 配置VS Code识别已有SDK路径 #

• 打开VS Code，按下Cmd + ,打开设置界面
• 在搜索框输入android.sdkPath，将路径手动设置为：/Users/name/Library/Developer/Xamarin/android-sdk-macosx
• 搜索java.home，确认路径为：/Library/Java/JavaVirtualMachines/microsoft-11.jdk/Contents/Home
• 保存设置后关闭VS Code

2. 手动安装缺失的必填组件 #

• 打开终端，进入SDK命令行工具目录：

  cd /Users/name/Library/Developer/Xamarin/android-sdk-macosx/cmdline-tools/7.0/bin
  

• 安装build-tools/34.0.0：

  ./sdkmanager "build-tools;34.0.0"
  

• 接受所有SDK许可（若执行失败，先删除/Users/name/Library/Developer/Xamarin/android-sdk-macosx/licenses文件夹再重试）：

  ./sdkmanager --licenses --verbose
  

3. 验证安装并重启VS Code #

• 执行以下命令确认组件已安装：

  ./sdkmanager --list | grep "build-tools;34.0.0"
  

• 完全关闭VS Code后重新打开项目，检查提示是否消失

4. 可选：安装安卓模拟器镜像（如需使用模拟器） #

• 执行命令安装指定系统镜像：

  ./sdkmanager "system-images;android-34;google_apis;x86_64"
  

• 再次执行许可命令确保镜像安装完成

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