3.5 KiB
3.5 KiB
页面与导航
导航使用 Navigation3 的 NavBackStack。目的地定义在 Navigation.kt 的 Destination,分发在 App.kt 的 ScreenContent。所有 Destination 必须在 navSerializersModule 注册,否则进程被杀后无法还原返回栈。
三个 MainDestination(今日课表、周课表、我的)切换时会 backStack.clear() 再压入,底部栏无横向滑动动画。其余页面压栈,横向滑入/滑出。
1. 目的地一览
| Destination | 类型 | 界面 | 用户入口 |
|---|---|---|---|
TodaySchedule |
主 Tab | TodayScheduleScreen |
底部「今日课表」;启动页可设为它 |
CourseSchedule |
主 Tab | WeeklyScheduleScreen |
底部「课表」;默认启动页 |
Settings |
主 Tab | SettingsScreen |
底部「我的」 |
TimeSlotSettings |
子页 | TimeSlotManagementScreen |
我的 → 自定义时间段 |
ManageCourseTables |
子页 | ManageCourseTablesScreen |
我的 → 管理课表 |
CourseTableConversion |
子页 | CourseTableConversionScreen |
我的 → 课表导入/导出 |
NotificationSettings |
子页 | NotificationSettingsScreen |
我的 → 课程提醒设置 |
MoreOptions |
子页 | MoreOptionsScreen |
我的 → 更多 |
QuickActions |
子页 | QuickActionsScreen |
我的 → 快捷操作 |
TweakSchedule |
子页 | TweakScheduleScreen |
快捷操作 → 调课 |
QuickDelete |
子页 | QuickDeleteScreen |
快捷操作 → 快速删除课程 |
CourseManagementList |
子页 | CourseNameListScreen |
我的 → 课程管理 |
CourseManagementDetail(courseName) |
子页 | CourseInstanceListScreen |
课程管理 → 点某一门 |
StyleSettings |
子页 | StyleSettingsScreen |
我的 → 个性化配置 |
ThemeSettings |
子页 | ThemeSettingsScreen |
更多 → 主题设置 |
BackupAndRestore |
子页 | BackupScreen |
课表导入/导出 → 备份与恢复 |
WebView(initialUrl) |
子页 | WebViewScreen |
课表导入/导出 → 正方教务导入;默认 about:blank |
AddEditCourse(courseId) |
子页 | AddEditCourseScreen |
周课表点空白格/课程;课程管理添加。courseId == null 为新建 |
2. 「我的」页结构
常规设置
- 显示非本周课程(开关,写入全局 DataStore)
- 是否显示周末(写入当前课表
CourseTableConfig) - 设置开学日期
- 本学期总周数(默认 20)
- 当前周数(手动改会反推开学日期;可选「假期中」)
- 每周起始日(周一或周日)
- 快捷操作
高级功能
- 课表导入/导出
- 课程提醒设置
- 管理课表
- 课程管理
- 自定义时间段
- 个性化配置
- 更多(关于、启动页面、主题)
3. 导入导出页结构
- 正方教务导入 →
Destination.WebView() - 课程文件导入(JSON,覆盖指定课表)
- 课程文件导出(
starschedule_<时间戳>.json) - 日历文件导出(
starschedule_<时间戳>.ics,可选 1–60 分钟提醒) - 备份与恢复 →
BackupAndRestore
4. 新增页面步骤
- 在
Destination增加@Serializable类型(带参数用data class)。 - 在
navSerializersModule的polymorphic里subclass(...)。 - 在
App.kt的ScreenContent增加when分支。 - 从已有 Screen 用
onNavigate(Destination.Xxx)跳转。 - 用户可见标题、说明写进
composeResources/values/strings.xml。
主 Tab 必须实现 MainDestination,并在 AdaptiveNavigationScaffold 的 Tab 列表里出现,否则底部栏对不上。