返回

Android模拟器找不到 AVD 系统路径：终极指南

Android

修复 Android 模拟器的 "Cannot find AVD system path. Please define ANDROID_SDK_ROOT" 错误

问题概述

在使用 Android Studio 开发应用程序时，"Cannot find AVD system path. Please define ANDROID_SDK_ROOT" 错误可能会困扰你。这个错误表明 Android 模拟器无法找到 AVD 的系统路径，因为 Android SDK 路径尚未正确定义。

根本原因

这个错误的根源在于 Android Studio 无法找到 Android SDK 的路径。Android SDK 包含创建和管理 AVD 所需的文件和工具。当创建 AVD 时，Android Studio 会在 SDK 路径中查找 AVD 的系统映像。如果没有正确定义 SDK 路径，Android Studio 将无法找到该映像，从而导致上述错误。

逐步解决方案

要解决此错误，你需要确保已正确定义 ANDROID_SDK_ROOT 环境变量。该变量指定 Android SDK 的安装路径，Android Studio 使用该路径来查找 AVD 系统映像和其他必需的文件。

  1. 检查环境变量
  • 在 Windows 上：
    • 右键单击“此电脑”或“我的电脑”，然后选择“属性”。
    • 单击“高级系统设置”，然后在“系统属性”窗口中选择“环境变量”。
    • 在“系统变量”列表中找到“ANDROID_SDK_ROOT”变量。如果未列出，请单击“新建”按钮并创建一个新变量。
    • 在“变量名”字段中输入“ANDROID_SDK_ROOT”，并在“变量值”字段中输入 Android SDK 的安装路径。
  • 在 macOS 上：
    • 打开“终端”应用程序。
    • 键入以下命令并按 Enter 键：
echo $ANDROID_SDK_ROOT

* 如果命令返回 Android SDK 的路径，则已正确设置环境变量。否则，键入以下命令并按 Enter 键创建新变量：

export ANDROID_SDK_ROOT=/path/to/android-sdk
  • 将“/path/to/android-sdk”替换为 Android SDK 的实际安装路径。
  1. 重新启动 Android Studio

在定义或修改 ANDROID_SDK_ROOT 环境变量后，重新启动 Android Studio 以使更改生效。

  1. 验证 SDK 路径

重新启动 Android Studio 后，转到“首选项”>“外观和行为”>“系统设置”>“Android SDK”。验证是否已在“SDK 位置”字段中正确指定了 Android SDK 路径。

  1. 重新创建 AVD

如果上述步骤仍然无法解决问题，请尝试重新创建 AVD。在 Android Studio 中，转到“工具”>“AVD 管理器”，然后单击“创建虚拟设备”。在“创建虚拟设备”窗口中，从下拉列表中选择正确的系统映像，然后单击“完成”。

常见问题解答

  1. 为什么我会遇到 "Cannot find AVD system path. Please define ANDROID_SDK_ROOT" 错误？

    • 这个问题的根源在于 Android Studio 无法找到 Android SDK 的路径，因为它尚未正确定义。

  2. 如何检查 ANDROID_SDK_ROOT 环境变量是否正确设置？

    • 在 Windows 上： 在“系统变量”列表中查找“ANDROID_SDK_ROOT”变量。
    • 在 macOS 上： 键入命令 echo $ANDROID_SDK_ROOT 并按 Enter 键。如果命令返回 Android SDK 的路径，则已正确设置环境变量。

  3. 重新启动 Android Studio 后，我仍然看到错误。该怎么办？

    • 尝试重新创建 AVD。如果仍然有问题，请确保已正确定义 ANDROID_SDK_ROOT 环境变量并已在 Android Studio 中验证 SDK 路径。

  4. 我正在创建一个新的 AVD，但找不到所需的系统映像。

    • 确保已在 SDK 管理器中安装所需的系统映像。如果没有，请下载并安装它。

  5. 我已按照步骤操作，但仍然遇到错误。有什么其他建议吗？

    • 尝试更新 Android Studio 到最新版本或检查 Android 模拟器的文档以获取更多帮助。