Android Studio 模拟器

编辑

学习如何设置 Android 模拟器以在虚拟 Android 设备上测试您的应用。


如果您没有可用于测试的 Android 设备,我们建议使用随 Android Studio 附带的默认模拟器。如果您在设置过程中遇到任何问题,请按照本指南中的步骤进行操作。

安装 Watchman 和 JDK

先决条件

使用包管理器,例如 Homebrew,安装以下依赖项。

安装依赖项

1

使用工具如 Homebrew 安装 Watchman

Terminal
brew install watchman

2

使用 Homebrew 安装名为 Azul Zulu 的 OpenJDK 发行版。该发行版提供适用于 Apple Silicon 和 Intel Mac 的 JDK。

在终端中运行以下命令:

Terminal
brew install --cask zulu@17

安装 JDK 后,在 ~/.bash_profile(如果使用 Zsh,请在 ~/.zshrc 中)添加 JAVA_HOME 环境变量:

export JAVA_HOME=/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home

先决条件

使用包管理器,例如 Chocolatey,安装以下依赖项。

安装依赖项

安装 Java SE Development Kit (JDK)

Terminal
choco install -y microsoft-openjdk17

安装依赖项

1

按照 Watchman 文档中的说明 从源代码编译和安装它。

2

安装 Java SE Development Kit (JDK)

您可以从 AdoptOpenJDK 或您的系统打包程序下载并安装 OpenJDK@17

设置 Android Studio

1

下载并安装 Android Studio

2

打开 Android Studio 应用程序,您将看到 SDK Components setup 屏幕。点击 Next 继续安装 Android SDK 和 Android SDK 平台。再次点击 Next 验证设置并安装。

3

默认情况下,Android Studio 将安装最新版本的 Android SDK。但是,要编译 React Native 应用,需要 Android 15 (VanillaIceCream) SDK。

打开 Android Studio,转到 Settings > Languages & Frameworks > Android SDK。在 SDK Platforms 选项卡下,在 Android 15 (VanillaIceCream) 下,选择 Android SDK 平台 35Android 35 的源代码

4

然后,点击 SDK Tools 选项卡,确保您至少安装了一版 Android SDK Build-ToolsAndroid Emulator

5

复制或记住框中显示的 Android SDK Location

6

将以下行添加到您的 /.zprofile~/.zshrc (如果您使用 bash,则为 ~/.bash_profile~/.bashrc)配置文件中:

Terminal
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/platform-tools

7

在您当前的 shell 中重新加载路径环境变量:

Terminal
# for zsh
source $HOME/.zshrc

# for bash
source $HOME/.bashrc

8

最后,确保您可以从终端运行 adb

故障排除:Android Studio 未识别 JDK

如果 Android Studio 无法识别您通过 homebrew 安装的 JDK,您可以创建一个 Gradle 配置文件以明确设置 Java 路径:

  1. 在您的主目录中创建一个 Gradle 属性文件:

    Terminal
    touch ~/.gradle/gradle.properties
  2. 将以下行添加到 gradle.properties 文件中,用您的实际 Java 安装路径替换路径:

    gradle.properties
    java.home=/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home
  3. 如果您的项目目录中已有 .gradle 文件夹,请删除它并在 Android Studio 中重新打开项目:

    Terminal
    rm -rf .gradle

这应该解决 Android Studio 无法检测到您 JDK 安装的问题。

1

下载 Android Studio

2

打开 Android Studio 安装程序。在 Select components to install 下,选择 Android Studio 和 Android 虚拟设备。然后,点击 Next

3

在 Android Studio 安装向导中,选择 Install Type,选择 Standard 并点击 Next

4

Android Studio 安装向导将要求您验证设置,例如 Android SDK 的版本、平台工具等。在您验证后点击 Next

5

在下一个窗口中,接受所有可用组件的许可证。

6

默认情况下,Android Studio 将安装最新版本的 Android SDK。但是,要编译 React Native 应用,需要 Android 15 (VanillaIceCream) SDK。

打开 Android Studio,转到 Settings > Languages & Frameworks > Android SDK。在 SDK Platforms 选项卡下,在 Android 15 (VanillaIceCream) 下,选择 Android SDK Platform 35Sources for Android 35

7

然后,点击 SDK Tools 选项卡,确保您至少安装了一版 Android SDK Build-ToolsAndroid Emulator

8

工具安装完成后,配置 ANDROID_HOME 环境变量。转到 Windows Control Panel > User Accounts > User Accounts(再次)> Change my environment variables,点击 New 创建新的 ANDROID_HOME 用户变量。该变量的值将指向您的 Android SDK 路径:

如何找到已安装的 SDK 位置?

默认情况下,Android SDK 安装在以下位置:

%LOCALAPPDATA%\Android\Sdk

要在 Android Studio 中手动查找 SDK 位置,转到 Settings > Languages & Frameworks > Android SDK。查看 Android SDK Location 旁边的地址。

9

要验证新的环境变量是否已加载,打开 PowerShell,并复制粘贴以下命令:

Terminal
Get-ChildItem -Path Env:

该命令将输出所有用户环境变量。在此列表中,查看是否已添加 ANDROID_HOME

10

要将平台工具添加到路径中,转到 Windows Control Panel > User Accounts > User Accounts(再次)> Change my environment variables > Path > Edit > New,并将平台工具的路径添加到列表中,如下所示:

如何找到已安装的平台工具位置

默认情况下,平台工具安装在以下位置:

%LOCALAPPDATA%\Android\Sdk\platform-tools

11

最后,确保您可以从 PowerShell 运行 adb。例如,运行 adb --version 查看您的系统正在运行哪个版本的 adb

设置模拟器

1

在 Android Studio 主屏幕上,点击 More Actions,然后在下拉菜单中选择 Virtual Device Manager

2

点击 Create device 按钮。

3

Add device 下,选择您想要模拟的硬件类型。我们建议测试多种设备,但如果您不确定从哪里开始,Pixel 系列中的最新设备可能是一个不错的选择。

4

选择要在模拟器上加载的操作系统版本(可能是系统映像之一),并下载该映像(如果需要)。

5

更改任何其他设置,然后按 Finish 创建模拟器。您现在可以通过在 AVD 管理器窗口中点击播放按钮随时运行此模拟器。

故障排除

多个 adb 版本

系统中存在多个 adb 版本可能会导致以下错误:

Terminal
adb server version (xx) doesn't match this client (xx); killing...

这是因为您系统中的 adb 版本与 Android SDK 平台工具中的 adb 版本不匹配。

1

打开终端并检查系统上的 adb 版本:

Terminal
adb version

2

从 Android SDK 平台工具目录中检查:

Terminal
cd ~/Library/Android/sdk/platform-tools
./adb version

3

adb 从 Android SDK 目录复制到 usr/bin 目录:

Terminal
sudo cp ~/Library/Android/sdk/platform-tools/adb /usr/bin