[!info] related notes

• 所属 MOC: frontend-engineering-moc
• 原子概念: adb, android-sdk, android-platform-tools
• 跨平台框架: react-native, expo
• 同族笔记: android

Android 开发环境配置

一句话目标

在 Windows 上配置 Android 原生开发或 React Native / Expo 跨平台开发所需的完整环境。

前置依赖

1. JDK（Java Development Kit）

Android 开发需要 JDK 17+。

# 用 scoop 安装（推荐）
scoop install openjdk17

# 验证
java -version
javac -version

如果用 Android Studio，它自带 JBR（JetBrains Runtime），可跳过手动安装。

2. Node.js（React Native / Expo 需要）

node -v   # 建议 18+
npm -v

安装步骤

方案 A：Android Studio（推荐）

1. 下载 Android Studio
2. 安装时勾选：
   • Android SDK
   • Android SDK Platform
   • Android Virtual Device（AVD 模拟器）
3. 首次启动后在 SDK Manager 中安装需要的 SDK Platform 和 Build Tools

方案 B：仅安装命令行工具（轻量方案）

适用于不需要 IDE、只需 CLI 构建的场景（如 React Native / Expo 项目）。

1. 下载 Android SDK Command-line Tools
2. 解压到固定目录，如 D:\Android\cmdline-tools\latest
3. 安装 SDK 组件：

sdkmanager "platform-tools" "platforms;android-34" "build-tools;34.0.0"

环境变量配置

Windows

ANDROID_HOME = D:\Android\Sdk          # SDK 根目录
JAVA_HOME    = C:\Users\<用户>\scoop\apps\openjdk17\current

PATH 追加：
  %ANDROID_HOME%\platform-tools
  %ANDROID_HOME%\tools
  %ANDROID_HOME%\emulator
  %JAVA_HOME%\bin

验证

adb version
echo %ANDROID_HOME%

模拟器（AVD）

在 Android Studio 中：Tools > Device Manager > Create Device

• 推荐选择 Pixel 系列 + 较新的 API level
• 系统镜像选 x86_64（Intel/AMD）或 arm64（Apple Silicon）

真机调试

1. 手机开启 开发者选项（设置 > 关于手机 > 连点版本号 7 次）
2. 开启 USB 调试
3. 用数据线连接电脑，手机上允许调试授权
4. 验证：

adb devices

React Native / Expo 快速起步

详见 react-native 和 expo。

# Expo（推荐）
npx create-expo-app my-app
cd my-app
npx expo start

# React Native CLI
npx @react-native-community/cli init MyApp
cd MyApp
npx react-native run-android

常见问题

问题	原因	解决
adb devices 无设备	驱动未装 / USB 调试未开	安装 OEM 驱动，确认调试已开启
ANDROID_HOME 未定义	环境变量未设或未重启终端	设置后重启终端
SDK license 未接受	首次用 sdkmanager	运行 sdkmanager --licenses
Gradle 下载慢	默认走 Google 源	在 build.gradle 中换阿里云镜像
模拟器启动失败	HAXM/Hyper-V 冲突	检查 BIOS 虚拟化设置，或改用 Hyper-V