Mac单独安装Android Emulator启动AVD报错求助

我之前在Mac上折腾单独装Android Emulator而不装完整Android Studio的时候，也踩过一模一样的坑，给你梳理下靠谱的解决步骤：

1. 先确认Emulator相关组件是否安装完整 #

你已经能正常使用avdmanager和sdkmanager，那先检查下核心的emulator组件和系统镜像有没有装全：

sdkmanager --list_installed

如果输出里找不到emulator或者system-images相关条目，就执行以下命令补装（这里以API 30的Google镜像为例，你可以换成自己需要的API版本）：

sdkmanager "emulator" "platform-tools" "system-images;android-30;google_apis;x86_64"

2. 补全环境变量，让emulator命令能被识别 #

你只配置了ANDROID_SDK_ROOT，但emulator的可执行文件在$ANDROID_SDK_ROOT/emulator目录下，得把这个路径加到PATH里才能全局调用：
打开你的shell配置文件（用zsh就编辑~/.zshrc，bash就编辑~/.bash_profile），添加以下内容：

export ANDROID_SDK_ROOT="/usr/local/share/android-sdk"
export PATH="$ANDROID_SDK_ROOT/emulator:$ANDROID_SDK_ROOT/platform-tools:$PATH"

然后执行source ~/.zshrc（对应你的配置文件）让变更生效，之后再试试emulator -version，应该就能正常识别命令了。

3. 修复PANIC: Broken AVD system path错误 #

这个错误大多是AVD配置文件的路径指向不对，或者SDK目录权限有问题：

• 检查AVD配置文件：打开/Users/<你的用户名>/.android/avd/test.avd/config.ini，找到image.sysdir.1这一行，确认它的路径是$ANDROID_SDK_ROOT/system-images/<你的API版本>/<镜像类型>/x86_64/，比如：

  image.sysdir.1=system-images/android-30/google_apis/x86_64/
  

  如果路径不对，手动修改成正确的路径即可。
• 修复SDK目录权限：brew安装的android-sdk偶尔会出现权限不足的情况，执行以下命令确保你拥有该目录的读写权限：

  sudo chown -R $USER:admin /usr/local/share/android-sdk
  

4. 测试启动AVD #

做完以上步骤后，尝试直接启动AVD：

emulator -avd test

如果还是有问题，可以尝试手动指定系统镜像路径启动：

emulator -avd test -sysdir $ANDROID_SDK_ROOT/system-images/android-30/google_apis/x86_64/

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