[!info] related notes

• 所属 MOC: 前端工程化 MOC
• 原子概念: adb, android-sdk, android-platform-tools
• 跨平台框架: [[react-native-framework|react-native]], expo
• 同族笔记: android

Android 开发环境配置

一句话目标

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

前置依赖

1. JDK（Java Development Kit）

先按目标项目的 Android Gradle Plugin / Gradle 兼容要求选 JDK。JDK 17 是一些项目的要求，不意味着任意更高版本都兼容；以下仅为安装示例。

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

# 验证
java -version
javac -version

Android Studio 自带 JBR，但 IDE 的运行时、Gradle JDK 与终端 JAVA_HOME 不一定相同。若使用内置 JDK，应确认项目构建与命令行指向兼容版本。

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

node -v   # 按 React Native / Expo 版本要求核对，避免沿用旧最低版本
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. 将包内内容放到 SDK 根目录下，确保实际存在 D:\Android\Sdk\cmdline-tools\latest\bin\sdkmanager.bat，避免多嵌套一层 cmdline-tools
3. 配好下面的环境变量后安装所需组件；API 34 与 Build Tools 34.0.0 仅为示例：

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

环境变量配置

Windows

当前 PowerShell 会话示例（替换为实际路径）：

$env:ANDROID_HOME = "D:\Android\Sdk"
$env:JAVA_HOME = "C:\path\to\compatible-jdk"
$env:PATH += ";$env:ANDROID_HOME\platform-tools;$env:ANDROID_HOME\cmdline-tools\latest\bin;$env:ANDROID_HOME\emulator;$env:JAVA_HOME\bin"

长期使用可在 Windows 环境变量界面设置相同内容，再打开新终端。不要混用 cmd 的 %ANDROID_HOME% 与 PowerShell 的 $env:ANDROID_HOME 语法。

验证

adb version
$env:ANDROID_HOME
sdkmanager --list_installed

模拟器（AVD）

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

• 推荐选择 Pixel 系列 + 较新的 API level
• 按宿主 CPU 和可用加速器选择镜像；Windows x86_64 主机通常选择匹配的 x86_64 镜像
• 先核对系统虚拟化与当前 Emulator 支持，旧 HAXM 教程不能直接套用

真机调试

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

adb devices

React Native / Expo 快速起步

以下为创建新项目的示例；现有项目应先遵循锁文件、脚本与框架版本。Expo Go、开发构建及原生构建的依赖要求不同，运行开发服务器不等于已验证 Android 原生工具链。

详见 [[react-native-framework|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 下载慢	分发包、依赖仓库或网络问题	先看具体失败 URL；镜像替换需确认覆盖范围与来源，不盲改所有仓库
模拟器启动失败	虚拟化、镜像或加速器问题	检查 BIOS 虚拟化、当前 Emulator 支持和启动日志

完成验证

• java -version、Gradle JDK 与项目要求一致。
• SDK 根目录下存在项目所需平台与工具包。
• 模拟器或真机在 adb devices -l 中可用。
• 目标项目实际构建、安装并启动成功；仅 adb 能运行不代表整套环境完成。

参考

• Android SDK 工具
• Android 构建的 JDK 选择