This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.
Android Studio 模拟器
编辑页面
了解如何设置 Android 模拟器，以便在虚拟 Android 设备上测试您的应用。
如果你没有可用于测试的 Android 设备，我们建议使用 Android Studio 自带的默认模拟器。如果你在设置过程中遇到任何问题，请按照本指南中的步骤进行操作。
安装 JDK
先决条件
使用 Homebrew 等包管理器来安装以下依赖项。
安装依赖项
1
2
使用 Homebrew 安装名为 Azul Zulu 的 OpenJDK 发行版。该发行版同时为 Apple Silicon 和 Intel Mac 提供 JDK。
在终端中运行以下命令：
- brew install --cask zulu@17安装 JDK 后，在 ~/.bash_profile 中添加 JAVA_HOME 环境变量（如果你使用 Zsh，则添加到 ~/.zshrc 中）：
export JAVA_HOME=/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home
先决条件
使用 Chocolatey 等包管理器来安装以下依赖项。
安装依赖项
安装 Java SE Development Kit (JDK)：
- choco install -y microsoft-openjdk17安装依赖项
1
安装 Watchman 仅对 SDK 55 及更早版本的项目是必需的。
按照 Watchman 文档中的说明 从源代码编译并安装它。
2
安装 Java SE Development Kit (JDK)：
你可以从 AdoptOpenJDK 或你的系统软件包管理器下载并安装 OpenJDK@17。
配置 Android Studio
1
下载并安装 Android Studio。
2
打开 Android Studio 应用。首次启动时会显示 Android Studio Setup Wizard。在 Welcome 界面点击 Next。然后，在 Install Type 下选择 Standard 并点击 Next。
确认设置后点击 Next。接着接受许可协议并再次点击 Next。向导会下载并安装 Android SDK 及其工具。安装完成后点击 Finish。
3
默认情况下，Android Studio 会安装最新版本的 Android SDK。不过，编译 React Native 应用需要 Android 16（Baklava）SDK。
打开 Android Studio，进入 Settings > Languages & Frameworks > Android SDK。在 SDK Platforms 选项卡中，在 Android 16 (Baklava) 下选择 Android SDK Platform 36 和 Sources for Android 36。
4
然后，点击 SDK Tools 选项卡，确保至少安装了一个版本的 Android SDK Build-Tools 和 Android Emulator。
5
复制或记住框中显示的 Android SDK Location 路径。
6
将以下内容添加到你的 /.zprofile 或 ~/.zshrc（如果你使用 bash，则添加到 ~/.bash_profile 或 ~/.bashrc）配置文件中：
- export ANDROID_HOME=$HOME/Library/Android/sdk- export PATH=$PATH:$ANDROID_HOME/emulator- export PATH=$PATH:$ANDROID_HOME/platform-tools7
在当前 shell 中重新加载 path 环境变量：
# for zsh- source $HOME/.zshrc# for bash- source $HOME/.bashrc8
最后，确保你可以在终端中运行 adb。
故障排查：Android Studio 无法识别 JDK
如果 Android Studio 无法识别你通过 homebrew 安装的 JDK，你可以创建一个 Gradle 配置文件来显式设置 Java 路径：
-
在你的主目录中创建一个 Gradle properties 文件：
Terminal-touch ~/.gradle/gradle.properties -
将以下内容添加到 gradle.properties 文件中，并将路径替换为你实际的 Java 安装路径：
gradle.propertiesjava.home=/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home -
如果你的项目目录中已经存在
.gradle文件夹，请删除它，然后在 Android Studio 中重新打开你的项目：Terminal-rm -rf .gradle
这应该可以解决 Android Studio 无法检测到你的 JDK 安装的问题。
1
下载 Android Studio。
2
打开 Android Studio Setup。在 Select components to install 下，选择 Android Studio 和 Android Virtual Device。然后点击 Next。
3
在 Android Studio Setup Wizard 中，在 Install Type 下选择 Standard 并点击 Next。
4
Android Studio Setup Wizard 会要求你确认诸如 Android SDK 版本、platform-tools 等设置。确认后点击 Next。
5
在下一个窗口中，接受所有可用组件的许可协议。
6
默认情况下，Android Studio 会安装最新版本的 Android SDK。不过，编译 React Native 应用需要 Android 16（Baklava）SDK。
打开 Android Studio，进入 Settings > Languages & Frameworks > Android SDK。在 SDK Platforms 选项卡中，在 Android 16 (Baklava) 下选择 Android SDK Platform 36 和 Sources for Android 36。
7
然后，点击 SDK Tools 选项卡，确保至少安装了一个版本的 Android SDK Build-Tools 和 Android Emulator。
8
工具安装完成后，配置 ANDROID_HOME 环境变量。进入 Windows Control Panel > User Accounts > User Accounts（再次）> Change my environment variables，然后点击 New 创建一个新的 ANDROID_HOME 用户变量。该变量的值应指向你的 Android SDK 路径：
9
要验证新的环境变量已加载，请打开 PowerShell，并复制粘贴以下命令：
- Get-ChildItem -Path Env:该命令会输出所有用户环境变量。查看列表中是否已添加 ANDROID_HOME。
10
11
最后，确保你可以在 PowerShell 中运行 adb。例如，运行 adb --version 来查看系统正在使用哪个版本的 adb。
设置模拟器
1
在 Android Studio 主界面上，点击 More Actions，然后在下拉菜单中点击 Virtual Device Manager。
2
点击 Create virtual device。
3
在 Add device 下，选择你想要模拟的硬件类型。我们建议针对多种设备进行测试，不过如果你不确定从哪里开始，Pixel 系列中的最新设备会是一个不错的选择。
4
选择要在模拟器上加载的操作系统版本（通常是某个系统映像），并下载该映像（如果需要）。
5
按需更改其他设置，然后按 Finish 创建模拟器。现在，你可以随时在 Device Manager 窗口中按下播放按钮来运行此模拟器。
故障排除
多个 adb 版本
系统中存在多个 adb 版本可能会导致以下错误：
- adb server version (xx) doesn't match this client (xx); killing...这是因为你系统上的 adb 版本与 Android SDK platform-tools 中的 adb 版本不同。
1
打开终端并检查系统上的 adb 版本：
- adb version2
然后从 Android SDK platform-tool 目录中检查：
- cd ~/Library/Android/sdk/platform-tools- ./adb version3
将 Android SDK 目录中的 adb 复制到 usr/bin 目录：
- sudo cp ~/Library/Android/sdk/platform-tools/adb /usr/bin如何安装特定版本的 Expo Go？
你可以创建一个使用所需 SDK 版本的项目，并在模拟器中打开它，以安装匹配版本的 Expo Go。
# 启动一个 SDK 57 项目- npx create-expo-app --template blank@57# 在模拟器中打开应用，以安装所需的 Expo Go 应用- npx expo start --android或者，你可以通过传入一个 SDK 版本，使用 expo-go CLI 下载特定版本的 Expo Go，或者使用 latest 获取最新的 SDK 版本。此命令会将 Expo Go 应用下载到当前目录，并将其缓存到 ~/.expo 下。
- npx expo-go download android latest