Mac端BeeWare运行安卓项目无法获取Android模拟器列表解决方案

报错常见原因 #

该报错触发逻辑是Briefcase在启动流程中调用Android SDK工具查询本地模拟器列表时，未拿到有效返回结果，常见诱因包括：

• Android SDK路径未正确配置到环境变量，Briefcase无法定位到模拟器执行文件
• Android Emulator等核心SDK组件未安装、或安装文件损坏
• MacOS安全机制拦截了SDK工具的执行权限
• 本地未创建可用的安卓虚拟设备（AVD），或已有AVD配置损坏
• Briefcase版本过旧，与新版Android SDK存在适配问题
• Java运行环境版本不兼容，导致SDK工具调用失败

分步排查解决 #

1. 校验基础环境配置
   终端执行briefcase doctor，检查输出中Android SDK、Java环境、模拟器相关依赖项是否全部通过校验。如果提示SDK路径缺失，编辑对应shell配置文件（默认zsh环境对应~/.zshrc，bash环境对应~/.bash_profile）添加如下配置：

   export ANDROID_SDK_ROOT=$HOME/Library/Android/sdk
   export PATH=$ANDROID_SDK_ROOT/emulator:$ANDROID_SDK_ROOT/platform-tools:$ANDROID_SDK_ROOT/cmdline-tools/latest/bin:$PATH
   

   保存后执行source <你编辑的配置文件路径>让配置生效，完全退出终端重开后再尝试命令。
   注：MacOS上Android Studio默认SDK安装路径为$HOME/Library/Android/sdk，如果自定义过SDK安装路径，请替换为实际路径
2. 验证模拟器组件可用性
   终端直接执行emulator -list-avds，看是否能正常输出已创建的模拟器名称列表：
   • 如果提示command not found，回到上一步检查环境变量配置是否正确
   • 如果命令执行报错，打开Android Studio，进入SDK设置的SDK Tools标签页，卸载Android Emulator组件后重新勾选安装，同步确认Android SDK Platform-Tools、项目对应版本的SDK Platform、Build-Tools都已安装
3. 修复MacOS权限拦截
   如果执行emulator -list-avds时弹出“无法打开，因为无法验证开发者”的系统提示，执行如下命令移除SDK目录的检疫标记：

   sudo xattr -dr com.apple.quarantine $ANDROID_SDK_ROOT/emulator
   

   输入当前系统用户密码执行完成后，再重新执行emulator -list-avds验证是否正常。
4. 确认存在可用虚拟设备
   如果emulator -list-avds执行后无任何输出，说明本地未创建可用AVD。打开Android Studio的Device Manager，新建虚拟设备，选择x86_64架构、API级别33及以上的系统镜像完成创建，先手动启动一次模拟器确认可以正常进入安卓系统，再关闭模拟器。
5. 兼容问题修复
   上述步骤都验证通过仍报错的，先升级Briefcase到最新版本：

   pip install --upgrade briefcase
   

   升级后清理安卓构建缓存再重新运行：

   briefcase clean android
   briefcase run android
   

   命令执行过程中出现模拟器选择提示时，选择之前创建的可用AVD即可正常启动项目。

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