Ubuntu WSL运行Meteor安卓命令报x86模拟器引擎缺失错误

这个报错核心是两个问题：

1. 环境变量PATH顺序配置错误，系统优先调用了$ANDROID_HOME/tools目录下的老旧遗留模拟器启动脚本，该脚本已经不再内置x86架构CPU的模拟引擎，新版Android SDK的模拟器程序实际存放在$ANDROID_HOME/emulator目录下，你之前验证AVD列表时就是在tools目录下执行的旧脚本，刚好触发这个问题。
2. WSL2环境默认未开启嵌套虚拟化与KVM加速，就算路径修正后也无法正常运行x86架构的安卓模拟器。

1. 修正环境变量加载顺序 #

PATH是按配置的先后顺序查找可执行文件的，你当前配置把tools目录放在了emulator目录前面，系统永远会优先加载旧版失效的模拟器脚本。修改你的shell配置文件（~/.bashrc/~/.zshrc，根据你用的shell选择）里的Android相关配置为以下内容，确保emulator目录在tools目录之前：

export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
export ANDROID_HOME=/etc/Android/Sdk
export ANDROID_SDK_ROOT=/etc/Android/Sdk
export PATH=/home/user/.meteor:$PATH
# emulator路径必须放在tools前面
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/build-tools
export PATH=$PATH:$ANDROID_HOME/cmdline-tools/latest/bin
export PATH=$PATH:$ANDROID_HOME/platform-tools
export ANDROID_BIN=/opt/android-studio-2021.2.1/android-studio/bin

保存后执行source ~/.bashrc（对应zsh就执行source ~/.zshrc）让配置生效，执行which emulator验证，输出结果必须是/etc/Android/Sdk/emulator/emulator，如果显示路径在tools目录下，说明配置未生效，重新检查PATH顺序。

2. 补全模拟器相关SDK组件 #

配置生效后，不要进入tools目录操作，直接在任意路径执行以下命令验证AVD识别情况：

emulator -list-avds

正常会输出你创建的Pixel_5_API_30设备。如果仍然提示组件缺失，执行以下命令补全模拟器和对应API30的x86系统镜像：

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

3. 配置WSL2嵌套虚拟化支持 #

x86安卓模拟器依赖硬件虚拟化加速，WSL2默认未开启该能力，按以下步骤配置：

• 关闭所有WSL窗口，在Windows端打开管理员权限的PowerShell，执行wsl --shutdown关闭WSL实例
• 打开Windows当前用户目录（一般是C:\Users\你的Windows用户名），新建名为.wslconfig的文件，写入以下配置：

[wsl2]
nestedVirtualization=true

• 保存文件后重新打开WSL终端，安装KVM相关依赖：

sudo apt update && sudo apt install -y qemu-kvm libvirt-daemon-system libvirt-clients bridge-utils
sudo adduser $USER kvm

• 重启WSL后执行kvm-ok验证，输出KVM acceleration can be used即代表硬件加速配置正常。

4. 验证模拟器运行后再执行meteor命令 #

先手动启动模拟器，确认能正常进入系统桌面：

emulator -avd Pixel_5_API_30

等模拟器完全启动后，再执行meteor run android-device，命令会自动识别到正在运行的模拟器并部署应用，不会再出现之前的PANIC报错。

• 永远不要调用$ANDROID_HOME/tools目录下的emulator脚本，该脚本是SDK历史遗留的兼容入口，已经停止维护，所有模拟器操作都使用$ANDROID_HOME/emulator目录下的可执行程序。
• 必须等模拟器完全启动进入桌面后再执行meteor相关命令，否则meteor识别不到运行中的设备会尝试重新调用错误路径的旧模拟器脚本，再次触发报错。

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