返回

AEHD 安装失败？8 招解决 Android 模拟器驱动难题

windows

搞定 Android Emulator Hypervisor Driver (AEHD) 安装失败

遇到 Android Emulator Hypervisor Driver (AEHD) 装不上？别急，这事儿挺常见的。尤其是在 Android Studio 的 SDK Manager 里点安装，眼看下载条跑完了，最后却弹出一个类似 Install Android Emulator hypervisor driver (installer) v.X.X.X" failed. Failed to update status to COMPLETE 的错误。这确实让人头疼，特别是当你等着模拟器跑项目的时候。

下面咱们就来分析分析这到底是咋回事，再给出几套实用的解决方案。

啥情况？安装 AEHD 卡住了

简单说，就是在 Windows 上通过 Android Studio 自带的 SDK Manager 安装 AEHD 这个组件时，安装程序走到最后一步失败了。错误信息通常指向 extras;google;Android_Emulator_Hypervisor_Driver 这个包，提示状态无法更新到 COMPLETE。

就像下面这张图里的情况（虽然版本可能不同，但核心问题类似）：

AEHD Installation Error Example
(图片Android Studio SDK Manager 显示 AEHD 安装失败的错误提示)

这表明 SDK Manager 下载了 AEHD 的安装包，但在执行安装脚本或驱动部署时碰到了障碍。

为啥装不上？扒一扒原因

AEHD 安装失败的原因五花八门，不过常见的就那么几个：

  1. CPU 虚拟化技术没开： AEHD 依赖 CPU 的硬件虚拟化支持（Intel 的 VT-x 或 AMD 的 AMD-V/SVM）。如果 BIOS/UEFI 里没启用这个功能，AEHD 自然装不上。
  2. 系统自带的 Hyper-V 或其他虚拟化平台在抢资源： Windows 自带的 Hyper-V、Windows Sandbox、适用于 Linux 的 Windows 子系统 (WSL2)，或者你装的 VirtualBox、VMWare 这类虚拟机软件，它们也会用到硬件虚拟化。有时它们会独占资源，导致 AEHD 无法正常初始化和安装。AEHD 本身是设计来利用 Windows Hypervisor Platform (WHPX) 的，但和老大哥 Hyper-V 的核心功能有时会“打架”。
  3. Windows Hypervisor Platform (WHPX) 配置问题： AEHD 可以利用 WHPX 来运行模拟器。但有时 WHPX 本身的状态（启用或禁用）可能和 AEHD 的安装要求不匹配，或者 WHPX 服务有问题。
  4. 权限不够： 安装驱动程序通常需要管理员权限。如果 Android Studio 或 SDK Manager 没有以管理员身份运行，安装过程可能会因为权限不足而失败。
  5. SDK 组件损坏或安装包不完整： 下载过程中网络中断，或者磁盘问题，可能导致 AEHD 的安装文件损坏或不完整。
  6. 杀毒软件或防火墙捣乱： 某些安全软件可能会把驱动安装行为误判为风险操作，直接拦截掉。
  7. 系统版本或补丁问题： 过于老旧的 Windows 版本或者缺少关键更新，也可能导致兼容性问题。

试试这几招，解决 AEHD 安装难题

了解了可能的原因，就可以对症下药了。下面按推荐尝试的顺序列出几种解决方案：

方案一：检查并开启 CPU 虚拟化

这是最基础也是最常见的原因。

  • 原理： AEHD 需要 CPU 底层提供虚拟化支持才能运行。
  • 操作步骤：
    1. 重启电脑: 在开机自检画面时（通常是显示主板 Logo 的时候），反复按特定键进入 BIOS/UEFI 设置。常用按键包括 Del, F2, F10, F12, Esc 等，具体看你主板或笔记本的说明。
    2. 查找虚拟化选项： 进入 BIOS/UEFI 后，找到跟 CPU相关的设置。选项名称通常包含 Virtualization Technology, Intel Virtualization Technology, VT-x, AMD-V, SVM Mode 等字眼。
    3. 启用设置： 把这个选项的状态改成 Enabled (启用)。
    4. 保存退出： 按 F10 (通常是这个键) 保存更改并退出 BIOS/UEFI，电脑会自动重启。
  • 验证： 重启进入 Windows 后，可以打开任务管理器 (Ctrl+Shift+Esc)，切换到“性能”选项卡，看右侧 CPU 信息里是否有“虚拟化：已启用”的字样。
    Task Manager Virtualization Enabled
  • 额外提示： 不同主板厂商的 BIOS/UEFI 界面差别很大，选项名称和位置也可能不同。实在找不到可以查阅主板或笔记本型号的官方手册，或者在网上搜索 “[你的主板/电脑型号] + enable virtualization”。

方案二：关掉 Hyper-V 及相关 Windows 功能

如果确认 CPU 虚拟化已开启，那冲突大概率来自 Windows 自身的虚拟化功能。

  • 原理： Hyper-V 及其相关特性（如 WSL2 默认使用的虚拟机平台）可能会与 AEHD 争抢底层的虚拟化资源。虽然新版的 AEHD 对与 Hyper-V 共存有所改善，但在很多情况下关闭 Hyper-V 是解决安装问题的有效方法。
  • 操作步骤（任选一种）：
    1. 通过“Windows 功能”界面：
      • 按下 Win + R 键，输入 OptionalFeatures.exe 并回车。
      • 在弹出的“Windows 功能”窗口里，找到并取消勾选 以下几项（如果存在且已勾选的话）：
        • Hyper-V
        • 虚拟机平台 (Virtual Machine Platform)
        • Windows Hypervisor 平台 (Windows Hypervisor Platform) - 注意：这项后面方案三会讨论，这里可以先尝试关掉。
        • Windows Sandbox
        • 适用于 Linux 的 Windows 子系统 (Windows Subsystem for Linux) - 如果你的 WSL 是 WSL2 版本，它依赖虚拟机平台，建议先关掉。
      • 点击“确定”，系统会应用更改，然后提示重启电脑。务必重启 。
        Windows Features Disable Hyper-V
    2. 通过 PowerShell (管理员权限)：
      • 右键点击“开始”按钮，选择“Windows PowerShell (管理员)”或“终端 (管理员)”。
      • 逐条执行以下命令来禁用这些功能： 
        Disable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V-All
Disable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform
Disable-WindowsOptionalFeature -Online -FeatureName WindowsHypervisorPlatform 
# 如果你想保留 WSL1，可以不禁用这个；如果用 WSL2 或者不确定，先禁用
Disable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux 
Disable-WindowsOptionalFeature -Online -FeatureName Containers-DisposableClientVM # 这是 Windows Sandbox
      • 执行完后，系统会提示是否需要重启。输入 Y 并回车确认重启。
  • 安全建议： 如果你确实需要用到 Hyper-V、WSL2 或 Sandbox，装好 AEHD 后可以尝试只开启需要的功能，看看是否能与模拟器共存。但如果模拟器运行不稳，可能还是得关掉这些功能。
  • 进阶：Intel HAXM vs AEHD： 以前 Intel 平台主要用 HAXM。AEHD 是 Google 后来推出的，支持 Intel 和 AMD，并能更好地利用 Windows 的 WHPX。如果你是 Intel CPU，之前可能装过 HAXM。安装 AEHD 前最好先通过控制面板卸载 HAXM，避免潜在冲突。

方案三：调整 Windows Hypervisor Platform (WHPX) 设置

这个比较微妙，有时需要开，有时需要关。

  • 原理： AEHD 设计上可以利用 WHPX 作为 hypervisor。但安装过程本身可能对 WHPX 的状态有特定要求，或者有时 WHPX 服务自身有问题。
  • 操作步骤：
    • 尝试禁用 WHPX 安装： 按照方案二的步骤，确保 “Windows Hypervisor Platform” (WHPX) 是未勾选/禁用 状态，然后重启电脑，再尝试通过 SDK Manager 安装 AEHD。
    • 尝试启用 WHPX 安装： 如果禁用后安装仍然失败，试试反过来。确保 “Windows Hypervisor Platform” (WHPX) 是勾选/启用 状态，重启电脑，再安装 AEHD。
    • 使用 PowerShell 控制 WHPX: 
      # 启用 WHPX
Enable-WindowsOptionalFeature -Online -FeatureName WindowsHypervisorPlatform -All 
# 禁用 WHPX
Disable-WindowsOptionalFeature -Online -FeatureName WindowsHypervisorPlatform
      记得每次更改后都要重启电脑 。
  • 注意： 安装成功后，根据 Android Studio 模拟器的设置，可能还需要调整 WHPX 的状态。通常建议是让 AEHD 和 WHPX 配合使用（即两者都启用）。

方案四：用管理员权限试试

简单但有效。

  • 原理： 驱动安装涉及到系统核心目录和注册表修改，需要管理员权限。
  • 操作步骤：
    1. 关闭正在运行的 Android Studio。
    2. 找到 Android Studio 的快捷方式或可执行文件 (studio64.exe)。
    3. 右键点击，选择“以管理员身份运行”。
    4. 在管理员模式运行的 Android Studio 中，打开 SDK Manager，再次尝试安装 AEHD。
    • 或者，你也可以直接以管理员身份运行 SDK Manager（如果能找到它的独立启动方式，通常在 SDK\tools\bin\sdkmanager.bat，不过通过 Studio 操作更方便）。
  • 安全建议： 仅在需要安装/更新组件时使用管理员权限运行。日常开发工作不需要一直使用管理员权限启动 Android Studio，这能降低潜在的安全风险。

方案五：手动安装 AEHD

如果 SDK Manager 始终搞不定，可以尝试手动运行 AEHD 的安装程序。

  • 原理： 跳过 SDK Manager 的管理流程，直接执行下载好的驱动安装包。
  • 操作步骤：
    1. 找到安装包： AEHD 的安装文件通常被下载到 Android SDK 的目录下。路径一般是 [你的 SDK 路径]\extras\google\Android_Emulator_Hypervisor_Driver。
    2. 在这个目录下找到名为 silent_install.bat 或类似的批处理文件，或者直接找到 intelhaxm-android.exe （如果是旧版或某种变体）或特定版本的安装程序。根据 Google 的文档，新版 AEHD 的独立安装可能需要去官方页面下载。
    3. 尝试运行：
      • 重要： 右键点击 silent_install.bat (或者主安装程序 .exe 文件)，选择“以管理员身份运行”。
      • 按照提示完成安装。如果是一个 .exe 安装程序，可能需要点击几下“下一步”。
    4. 如果找不到本地文件或安装失败： 访问 Android Studio 官方网站 或相关文档，查找是否有提供 AEHD 的独立下载链接。下载后，同样以管理员身份运行安装。
  • 提示： 手动安装后，SDK Manager 可能无法正确识别 AEHD 的安装状态。但只要模拟器能正常以硬件加速模式运行（启动时不报错，性能正常），就说明安装成功了。

方案六：清理 SDK 缓存或重装组件

下载或解压过程中出的问题。

  • 原理： 删除可能损坏的下载文件或旧的安装残留，让 SDK Manager 重新下载和尝试安装。
  • 操作步骤：
    1. 删除 AEHD 目录： 打开你的 Android SDK 路径，找到 extras\google 目录，把里面的 Android_Emulator_Hypervisor_Driver 文件夹整个删掉。
    2. 清除 SDK Manager 缓存（可选）： 在 Android Studio 中，有时清理缓存有帮助 (File > Invalidate Caches / Restart...)。
    3. 重新尝试安装： 重启 Android Studio (最好也用管理员权限启动一次)，打开 SDK Manager，再次勾选 Android Emulator Hypervisor Driver 进行安装。

方案七：暂时关闭安全软件

最后的手段之一。

  • 原理： 有些杀毒软件或防火墙过于“敏感”，可能会阻止驱动的安装过程。
  • 操作步骤：
    1. 临时禁用： 暂时禁用你的杀毒软件和防火墙。具体操作方法请查阅你所用安全软件的文档。通常在系统托盘找到图标右键操作。
    2. 尝试安装： 再次通过 SDK Manager (管理员权限) 安装 AEHD。
    3. 重新启用： 安装成功后，务必立即 重新启用你的杀毒软件和防火墙。
  • 安全警告： 禁用安全软件会增加系统风险。只在确认安装包来源可靠（官方 SDK Manager）且安装完成后立刻恢复防护。如果问题依然存在，记得把安全软件重新打开。

方案八：确保系统是最新状态

兜底方案。

  • 原理： 确保 Windows 系统自身没有因为缺少更新而导致不兼容或 Bug。
  • 操作步骤：
    1. 打开 Windows 设置 (Win + I)。
    2. 进入“更新和安全” > “Windows 更新”。
    3. 点击“检查更新”，安装所有可用的重要更新和可选更新（特别是与 .NET Framework 或系统组件相关的）。
    4. 安装更新后按提示重启电脑。
    5. 再次尝试安装 AEHD。

通常情况下，按照以上顺序排查和尝试，大概率能解决 AEHD 的安装问题。重点关注 CPU 虚拟化是否开启、Hyper-V 及相关功能是否关闭、以及是否使用了管理员权限这几点。