Cordova冷启动黑屏求助：运行cordova emulate android提示快照不存在

我碰到过不少开发者在Ubuntu 16.04环境下用Cordova跑API 26模拟器时遇到这个问题，其实本质是模拟器找不到有效的快照文件，导致冷启动流程卡壳，最终黑屏。结合你的环境，给你几个逐层排查的解决方案：

1. 先试试强制跳过快照启动 #

这是最快的临时解决办法，直接让模拟器忽略快照，强制冷启动：
在你的Cordova项目根目录执行：

cordova emulate android -- --no-snapshot

或者直接用模拟器命令启动（先通过avdmanager list avd找到你的AVD名称）：

emulator -avd <你的AVD名称> -no-snapshot-load

如果能正常启动，说明就是快照文件的问题，后续可以考虑重建快照或调整AVD配置。

2. 删除并重建API 26的AVD #

如果强制启动还是不行，大概率是AVD的配置或快照文件损坏了，直接重建最稳妥：

• 打开Android Studio的AVD Manager，或者用命令行列出所有AVD：

  avdmanager list avd
  

• 删除出问题的API 26 AVD：

  avdmanager delete avd -n <目标AVD名称>
  

• 重新创建一个新的API 26 AVD：
  创建时注意不要勾选“启用快速启动”（这个选项依赖快照），或者直接选择“冷启动”作为启动方式；如果需要快照功能，创建完成后先手动启动一次模拟器，让它自动生成初始快照。

3. 修复Ubuntu下的文件权限问题 #

Ubuntu的用户权限经常会导致模拟器无法读写快照文件，这也是常见诱因：

• 找到AVD的存储目录，默认在~/.android/avd/
• 给这个目录及所有子文件设置当前用户的权限：

  sudo chown -R $USER:$USER ~/.android/avd/
  

• 重启模拟器，再尝试Cordova的命令。

4. 补全Ubuntu依赖库+更新SDK组件 #

API 26的模拟器对Ubuntu的系统依赖有要求，缺失部分库也会导致黑屏：

• 安装必要的依赖包：

  sudo apt-get update && sudo apt-get install lib64stdc++6 libqt5widgets5
  

• 打开Android SDK Manager，确保API 26的系统镜像（System Image） 是完整安装的，同时把Emulator组件更新到最新版本，旧版本和Ubuntu 16.04可能存在兼容性bug。

5. 极端情况：清除模拟器数据后重启 #

如果上面的方法都没用，可以尝试清除模拟器的所有数据，恢复到出厂状态：

emulator -avd <你的AVD名称> -wipe-data

这个命令会清除模拟器里的所有应用和设置，相当于重装系统，之后再启动Cordova项目应该就能正常运行了。

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