docs: record verified Android toolchain and emulator setup

2026-10-12 22:44:08 +08:00
parent a223798c25
commit 7f5c6df9e6
1 changed files with 49 additions and 0 deletions
@@ -0,0 +1,49 @@
+# 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，激活本终端的开发环境：
+
+```powershell
+. ./scripts/android-env.ps1
+flutter doctor -v
+```
+
+启动已创建的模拟器：
+
+```powershell
+. ./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`。