50 lines
2.5 KiB
Markdown
50 lines
2.5 KiB
Markdown
# 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`。
|