2.8 KiB
2.8 KiB
星课表(starschedule)
面向高校师生的 Android 课程表。由拾光课程表精简而来:只保留课表核心能力,教务导入只适配正方,界面仅简体中文。
| 项 | 值 |
|---|---|
| 显示名 | 星课表 |
| 工程名 | starschedule |
| 安装包名 | com.starschedule |
| Kotlin 包名 | com.xingheyuzhuan.shiguangschedule(沿用原工程,未全量改名) |
| 当前版本 | 1.0.0(versionCode 1) |
| 最低系统 | Android 8.0(API 26) |
| 许可证 | Apache 2.0 |
完整文档在 docs/。
能做什么
- 今日课表、周课表(多课表、自定义节次与学期)
- 课程增删改、按名称管理、调课、按周/日批量删除
- 正方教务导入(内置
zhengfang.js,不连外部适配仓库) - JSON 导入导出、ICS 导出、本地 ZIP 与 WebDAV 备份
- 上课提醒、上课勿扰/静音、节假日跳过
- 课表样式与应用主题
- 四种桌面小组件
工程结构
starschedule/
├── app/ # Android 入口、闹钟、WorkManager、小组件
├── shared/ # Compose UI、业务、Room、正方脚本
├── gradle/ # 版本目录与 Wrapper
└── docs/ # 需求、使用、架构、开发说明
Gradle 模块::app、:shared。
构建
需要 JDK 21。在 starschedule/ 目录:
gradlew.bat :app:assembleDebug
./gradlew :app:assembleDebug
产物:app/build/outputs/apk/debug/,按 ABI 分包(armeabi-v7a、arm64-v8a、x86_64)。
依赖解析优先腾讯云 Maven,找不到时回落 Google Maven / Maven Central。详见 构建与发布。
文档索引
| 文档 | 用途 |
|---|---|
| 需求文档 | 范围、功能与非功能需求、验收 |
| 用户使用说明 | 操作步骤 |
| 架构设计 | 模块、分层、关键数据流 |
| 开发文档 | 环境、约定、扩展入口 |
| 页面与导航 | Destination 与界面对照 |
| 数据模型 | Room / DataStore / JSON / 备份 |
| 正方教务导入 | WebView、JS Bridge、脚本 |
| 构建与发布 | Gradle、镜像、打包 |
| 隐私与数据 | 权限与本地数据 |
| 常见问题 | 导入、提醒、小组件排障 |
| 术语表 | 领域名词 |
| 变更记录 | 版本说明 |
与拾光课程表的关系
本仓库是独立工程,工作区里的 shiguangschedule、shiguang_warehouse 仅作参考,运行时不依赖它们。正方脚本已内嵌在 shared/src/commonMain/composeResources/files/zhengfang.js。