2.5 KiB
Android 环境配置结果
验证日期：2026-10-12（Asia/Shanghai）。本轮完成开发环境配置，业务代码与 APK 尚未生成。
已完成
| 组件 | 结果 |
|---|---|
| Flutter / Dart | Flutter 3.47.7 stable，Dart 3.13.5，版本命令通过 |
| Java | Microsoft OpenJDK 17.0.20.1，已由 Flutter 指定为构建 JDK |
| Android 平台 | API 36，Build Tools 36.0.0，Platform Tools 37.0.1 |
| Android 命令行工具 | 22.0；新版官方 Android CLI 已初始化，用于 SDK 下载 |
| 原生构建工具 | NDK 28.2.13676358、CMake 3.22.1，与当前 Flutter 配套 |
| SDK 许可 | 所需 Android SDK 许可均已接受 |
| Flutter Android 检查 | flutter doctor -v 的 Android toolchain 项通过 |
| 模拟器 | hepan_everyday，Pixel 7，Android 16 / API 36，Google APIs x86_64 |
| 硬件加速 | WHPX 已安装且可用 |
| 模拟器启动 | 系统启动成功，sys.boot_completed=1；读取系统版本为 16、SDK 为 36 |
| 构建仓库 | 成功下载 Google 官方仓库的 Android Gradle Plugin 9.1.0 描述文件 |
Flutter、Java、Android 命令行工具初始安装包均通过 SHA-256 校验。SDK 组件通过 Google 官方 Android CLI 安装。项目工具、Gradle/Pub 缓存、AVD 数据主要放在项目 .tools/ 内，已从版本控制排除；Flutter 保存了指向这些目录的用户级路径配置。
使用
在项目目录打开 PowerShell，激活本终端的开发环境：
. ./scripts/android-env.ps1
flutter doctor -v
启动已创建的模拟器：
. ./scripts/android-env.ps1
emulator -avd hepan_everyday
模拟器验证结束后已关闭；下次使用时手动启动即可。当前没有连接 Android 真机。
已观察到的其他检查结果
完整 Flutter doctor 还提示未安装 Windows 桌面开发所需的 Visual Studio；本项目现阶段以 Android 为目标。
Flutter doctor 对 https://maven.google.com/ 的连通性探测超时。直接从 Android 构建实际使用的 https://dl.google.com/dl/android/maven2/ 成功下载了 AGP 9.1.0 描述文件。后续仍需以真实 APK 构建验证全部 Gradle 依赖下载，不能据此宣称 APK 已能成功构建。
首次创建 AVD 时，旧 avdmanager 提示系统镜像目录的可选 devices.xml 不存在；Pixel 7 内置设备配置仍成功创建，随后通过了实际系统启动验证。
完整本地诊断日志位于 .tools/flutter-doctor.txt、.tools/android-sdk-install.txt、.tools/emulator-stdout.txt 和 .tools/emulator-stderr.txt。