48 lines
2.0 KiB
Markdown
48 lines
2.0 KiB
Markdown
# 河畔 Everyday
|
||
|
||
电子科技大学研究生课表 APP。采用 Flutter，优先 Android，后续支持 iOS。
|
||
|
||
当前阶段：Android 开发环境已配置，首版设计文件已确认，实现计划待审核；尚未生成业务代码或 APP 安装包。
|
||
|
||
## 开发环境
|
||
|
||
项目工具与缓存放在 `.tools/`，不会进入版本控制。使用官方发行版及 SHA-256 校验：
|
||
|
||
- Flutter 3.47.7 稳定版，Dart 3.13.5。
|
||
- Microsoft OpenJDK 17.0.20.1。
|
||
- Android 命令行工具 22.0、Android API 36、Build Tools 36.0.0、Platform Tools。
|
||
- Flutter 配套 NDK 28.2.13676358、CMake 3.22.1。
|
||
- 可选 Android Emulator 与 Android 16（API 36）Google APIs x86_64 镜像。
|
||
|
||
在 Windows PowerShell 中，进入本目录后，安装与检查环境：
|
||
|
||
```powershell
|
||
./scripts/setup-android.ps1 -WithEmulator
|
||
```
|
||
|
||
安装时需要访问官方下载源和软件包服务，并接受 Android SDK 开发工具许可。安装日志与许可文本保留在 `.tools/`。安装脚本只在项目内放置工具；Flutter 自身会保存 SDK 路径配置。
|
||
|
||
每次打开新的 PowerShell 终端后激活环境：
|
||
|
||
```powershell
|
||
. ./scripts/android-env.ps1
|
||
flutter doctor -v
|
||
flutter devices
|
||
```
|
||
|
||
真机调试：在 Android 手机打开开发者选项和 USB 调试，通过 USB 连接电脑，在手机上允许电脑调试，然后检查 `flutter devices`。如果 Windows 无法识别手机，根据手机厂商说明安装官方 USB 驱动。不要在聊天中提供学校账号密码。
|
||
|
||
模拟器需 Windows 支持的硬件虚拟化环境；环境检查与设备启动结果记录在 `docs/android-setup-status.md`。安装完成后可使用：
|
||
|
||
```powershell
|
||
. ./scripts/android-env.ps1
|
||
./scripts/create-android-emulator.ps1
|
||
emulator -avd hepan_everyday
|
||
```
|
||
|
||
已创建的虚拟设备会重复使用，不覆盖其数据。
|
||
|
||
## 首版设计
|
||
|
||
见 [已确认的首版设计](docs/superpowers/specs/2026-10-12-hepan-everyday-design.md)与[实现计划](docs/superpowers/plans/2026-10-12-hepan-everyday-android.md)。学校真实课表解析需要在用户本人认证后的页面上验证。
|