Skip to content

About

一款本地优先的开源 Android 课表工具,重点处理单双周、临时调课、停课补课、节假日和多套作息等复杂安排,让“下一节课”和提醒跟随实际课程变化。支持从教务网页、PDF、Excel、图片及 WakeUp 备份导入课表,并可将14天课程同步到小米手环,离线查看今日与明日课程。

Resources

Stars

4 stars

Watchers

0 watching

Forks

Repository files navigation

van课表

原生 Android 本地课表应用。Kotlin / Compose / Room / DataStore,GPL-3.0-only(含源自 NexioSchedule 的 AGPL-3.0 移植组件与 Apache-2.0 的 softglass)。 Android 手机端与实验性 Xiaomi Vela 手环伴侣端。 仓库包含源码、构建配置、合成样例与脱敏验证资料。本机工具缓存、构建产物、个人课表原件和签名密钥不属于仓库内容。

下载:最新发布页提供手机 APK、源码及 SHA-256 校验。 从源码构建前,请按 SDK 依赖说明取得官方通信 SDK;公开源码不附原始 AAR。

0.5.16 外观设置拆成四个三级页

本版版本号 0.5.16(versionCode 66)。

一级设置页保持原样的 12 个入口(课表配置 / 外观与提醒 / 数据 / 关于 四组),收敛只发生在二级页内部:原先「外观设置」是一整页 6 个面板、十多个滑杆与开关连成的长滚动条,现在二级页只留实时预览卡和四行入口,细节分到四个三级页。

三级页 路由 内容
主题与壁纸 appearanceTheme 深浅色、莫奈取色、壁纸选择 / 清除、亮度与模糊
材质与卡片 appearanceCard 柔光玻璃 / 清透磨砂 / 无材质、顶栏渐进模糊;卡片风格、着色、不透明度、模糊、折射、圆角、对齐、文字颜色与缩放、地点与教师开关
字体与网格 appearanceFont 全局字号、自动适配整周、节次行高
视图与动效 appearanceMotion 显示周末 / 周次进度条 / 非本周课程、自动跳下一周、日列表分组、课间空档、文字与返回动效、自定义时间标签
  • Appearance 签名改为 Appearance(p, vm, nav),schedule 只传给 AppearanceMotionPage(GridTimeline::canCollapseGaps 只在那里用)。
  • 预览卡留在二级页,壁纸位图与材质支持检测在需要的页面各自计算。
  • VanRouteTest 的「所有目的地」清单补上四个新路由,key 往返解析仍成立。
  • 三处插桩测试改为先进入对应三级页:LocalSmokeTest(深色 → 主题与壁纸)、TimetableChromeTest(周次进度条 → 视图与动效)、Version028UiTest(课间空档 → 视图与动效)。
  • 设置页顶部身份卡的空白方块换成日历图标,内边距 18→16/14dp。

0.5.15 修复「这次发布没有附带安装包」

本版版本号 0.5.15(versionCode 65)。

症状:点「检查版本更新」→「立即更新」,提示「这次发布没有附带安装包,只能改用下面的浏览器下载」。

根因:安装包直链只来自 GitHub API(releases/latest),而该接口对未登录请求限制为每小时 60 次。被限流后 UpdateChecker.latestRelease 会依次退回发布动态(releases.atom)和「最新发布页」跳转——这两条渠道都不列附件,于是 AppRelease.apk 为 null,界面就报「没有附带安装包」。实际发布里三个附件都在,是检查渠道拿不到。

修复:UpdateCheck.conventionalApk(tag, version) 按发布资源命名约定(van-schedule-<版本>-arm64.apk)拼出直链,parseAtomRelease 与 parseLatestPageUrl 都带上它。不降低安全性——下载后仍强制 UpdateInstaller.verifyFile 里的签名证书比对,只有原签名发布、能覆盖安装的包才会被接受;摘要与大小拿不到时留空,不编造校验值。

界面文案同步改:拿不到摘要时说明「下载后改用签名校验,一样安全」,只有真的拼不出直链时才说「没有附带安装包」。

测试:新增 3 项领域测试(atomReleaseStillCarriesConventionalApkUrl、latestPageFallbackAlsoCarriesConventionalApkUrl、conventionalApkKeepsTagButNormalizesVersion),domain 从 130 增至 133 项。已实测 releases/download/v0.5.13|v0.5.14/van-schedule-<版本>-arm64.apk 均返回 200。

0.5.14 日/周合成一个按键、课程页只留摘要

本版版本号 0.5.14(versionCode 64)。

  • 日/周合并成一枚按键:TimetableModeToggle 取代 0.5.11 引入的 TimetableModeSwitch。按钮上显示当前模式(「周」或「日」),点一下切到另一边,旁边一个 SwapHoriz 图标表明这是切换。两格分段控件的问题是:只有两个状态时,其中一格永远是「当前、点了没反应」的死格,既费宽度又费解。测试标签 mode-switch 保留,mode-week / mode-day 两格已删除。
  • 课程页只留摘要:课程卡从「课程名 + 每节课两行(周次、星期/节次/地点)」改成「课程名 + 一行摘要(星期 节次 · 地点)」,单行省略,右侧显示节数或类型数。单卡约 130dp → 约 46dp。周次信息(formatWeeks)不再出现在列表里,进详情页可见。
  • 相关测试:TimetablePagerTest.modeSwitchIsVisibleAndTogglesBothWays 改写为 modeToggleSwitchesBothWaysFromASingleButton,改为点同一枚按钮来回切换,并断言按钮文字跟着变。

0.5.13 导航悬浮岛加强、课程卡更紧凑、补齐历史版本

本版版本号 0.5.13(versionCode 63)。

  • 底部导航改成一眼能看出的悬浮岛:居中收窄到约 84% 宽度、离底边 12dp、圆角 30dp、投影 22dp。选中项从「很淡的浅色药丸」改成整块实心主题色药丸(浅色主题白字、深色主题深字),选中/未选中对比明显——这是回应「悬浮导航差异度不明显」。
  • 课程页的课程卡由统一大卡片改成紧凑卡:内边距 18→12/10、行距 10→3,单卡矮约 20dp;配合列表行距 6dp,一屏多看到几门课。
  • 「历史版本更新」(assets/changelog.txt)补齐 0.5.3 – 0.5.12 共十个版本,此前只写到 0.5.2。

0.5.12 悬浮导航、设置 Tab 与紧凑间距

本版版本号 0.5.12(versionCode 62)。

  • 底部第三个 Tab 从「我的」改为「设置」:这一页本来就是纯设置项(课表配置 / 外观与提醒 / 数据 / 关于),名实相符;页面标题同步改为「设置」,图标改为齿轮。
  • 底部导航与屏幕左右、底部的间距拉开(左右 18→24dp、底部 4→10dp)、圆角与投影加大,浮在内容之上。
  • 「课程」「课表」两页上下更紧凑:
    • 课程页:页面内边距 16→12/8、标题 28→22sp、列表行距 10→6dp、「课程备注」按钮更瘦。
    • 课表页:顶栏最小高度 48→44dp、列间距 4→2dp、日/周切换更矮、日列表行距 10→6dp。
    • 日课表课程卡:内边距 14→12/9、四行文字行高收紧、行距 4→2dp,单卡约省 30dp。
  • 相关测试:底部 Tab 点击改用 tab-2 测试标签(避免与页面标题重名),其余断言不变。

0.5.11 日/周切换摆到明面上

本版版本号 0.5.11(versionCode 61)。

  • 课表页顶栏下方新增可见的「周 | 日」分段控件(mode-switch,与「下一节」提示条同一行)。此前周课表 ↔ 日列表只有一个入口:顶栏「更多」菜单里的「切换为日列表」,两层菜单深、文案又叫「日列表」,多数人找不到,看起来像没有日课表。
  • 默认仍是周课表(daily = false 未改),「更多」菜单里的旧入口保留,不破坏既有习惯与测试。
  • 修复下拉菜单项被触发两次的问题:GlassDropdownItem 原先同时挂了 clickable 与拖选层的 action,手指未移动时两条路径都会触发;对「切换日/周」这类非幂等操作等于切过去又切回来,表现就是「点了没反应」。现在只保留拖选层作为唯一触发源,另加显式 onClick 语义动作供无障碍与测试使用。
  • 测试:新增 modeSwitchIsVisibleAndTogglesBothWays;LocalSmokeTest 里对「日」的文本断言改用 week-day-1-6 标签精确定位,避免与新控件重名。

0.5.10 去掉午休 / 晚休横条

本版版本号 0.5.10(versionCode 60)。

  • 周课表不再在午休、晚休的空档上叠那条通栏浅色横带(带子中间原本写着「午休」「晚休」)。空档本身已经按时长留白,再叠一层带子只是多一层噪音。
  • 空档高度规则完全没变:10 分钟的课间仍是细缝,两小时的午休仍占整块,展开 / 收起空档(showCourseGaps)的行为与之前一致。删掉的只是那条盖在时间轴上的色带。
  • 相关死代码一并清掉:GridTimeline.breakKindOf、BreakKind、MIN_BREAK_MINUTES、VanColors.breakBand。
  • 测试同步更新:原来断言「正好两条横带」的界面测试改为断言「一条都没有」;原来验证「哪段空档算午休」的领域测试改为验证空档高度仍按时长分配。

0.5.9 周课表右侧竖条与周次提示

本版版本号 0.5.9(versionCode 59)。

  • 「回到本周」不再是课表右边缘那根 44dp 宽的竖条,改成顶栏左上角的一枚小药丸:外形与「切换课表」一致,点击仍是回到本周(日列表里是「回到今日」)。课表网格因此多回一整列宽度,拇指也不用再伸到屏幕右侧去够。
  • 药丸只在「当前不在本周 / 不在今天」时出现;已在当前位置时顶栏与之前完全一致,不会平白多一个控件。
  • 周次左右两块空位依旧等宽:药丸出现在左槽最左边、课表名药丸仍在它右边,第N周 的居中位置不受影响。
  • 底部周次滑块拖动时,拇指上方浮出一枚「第N周」标签,实时显示将要跳到的周次;抬手后标签消失,静止状态仍是原来那条干净的进度条。
  • 滑块标签会跟着拇指走,并在两端自动夹住,不会被屏幕边缘切掉。
  • 无障碍不变:jump-today 的内容描述仍是「回到本周」/「回到今日」,滑块的状态描述仍报「第N周」。

0.5.8 更新进度与失败提示

本版版本号 0.5.8(versionCode 58)。

  • 「立即更新」下载时,按钮里直接显示当前做到哪一步:准备下载 / 正在连接 / 正在下载 N% / 正在校验 / 正在安装;下面一条进度条 + 一行说明,写清「已下载 6.2 MB / 13.0 MB · 直连 GitHub」。
  • 换源会明说:直连不通或太慢时提示「正在改用加速镜像(2/3)…」,不再是进度条默默归零重来。
  • 下载失败不再只是一行灰字:显示「下载失败」+ 具体原因(超时、连不上、被限流、HTTP 状态码),下面直接给「重试」和「改用浏览器下载」。
  • 连接、校验、安装这几步没有可信的百分比,改用不确定进度条,避免长时间停在 0% 或 100%。
  • 新增 4 项进度文案单元测试与 1 项下载阶段顺序检查(失败之前必须先报「正在连接」)。

0.5.7 顶栏课表切换

本版版本号 0.5.7(versionCode 57)。

  • 「切换课表」从右上角「更多」子菜单里搬出来,放到「第N周」左边的顶栏上:显示当前课表名,点一下就是课表列表(含「管理全部课表…」),这周属于哪份课表一眼就能看到。
  • 只有一份课表时不显示这枚药丸,顶栏与 0.5.6 完全一致,不会平白多出一个控件。
  • 周次左右各留了一个等宽空位,药丸出现、消失或课表名很长时,「第N周」都不会被顶偏;窄屏与大字体下名字单行省略,不挤压右侧的导入 / 加课 / 更多。
  • 「更多」菜单里不再有「切换课表…」,其余菜单项与顺序不变。
  • 新增 2 项界面回归:药丸贴在周次左边并能切换课表、「更多」菜单不残留旧入口、单课程表时药丸不出现且周次不压到右侧按钮。

0.5.6 国内加速下载

本版版本号 0.5.6(versionCode 56)。

  • 国内直连 GitHub 很慢时,应用内更新会自动换源:先直连,失败或明显太慢(8 秒内平均不到 60 KB/s)就依次改用公共加速镜像(ghfast.top、gh-proxy.com、ghproxy.net)。
  • 换源不影响安全:从任何地址下载的安装包都要通过 SHA-256 与文件大小校验,再核对签名证书与本机一致,镜像无法塞入篡改内容。
  • 「关于版本 → 检查版本更新」新增「国内加速下载」开关,默认开启;关掉后只走 GitHub 直连。
  • 下载提示会说明这次是从镜像取到的(已校验)。
  • 新增 4 项下载地址选择单元测试(直连优先、镜像只加前缀不换地址、尊重关闭开关、空地址处理)与 1 项模拟器检查(全部地址都不可达时干净失败、不留残余文件)。

0.5.5 应用内更新

本版版本号 0.5.5(versionCode 55)。

  • 「检查版本更新」发现新版本后,按钮从「打开下载页」改为「立即更新」:应用内直接下载安装包,然后调起系统安装界面,不用再跳到浏览器找下载链接。
  • 下载有进度条;已下载并校验过的包会缓存复用,不会重复下载十几兆。
  • 安全检查:优先用 GitHub API 拿安装包直链与 SHA-256,下载后核对文件大小与摘要;再把安装包的签名证书和本机版本比对,不一致就删除并拒绝安装。
  • 首次使用需要允许「安装未知应用」(Android 8 起按应用单独授权),界面会提示并可直接跳到授权页。
  • 系统仍会弹一次安装确认,这是 Android 的硬性要求,非 root 设备无法绕过;能省掉的是打开浏览器、手找下载、从文件管理器安装。
  • 新增 7 项发布信息解析单元测试与 3 项模拟器检查(缓存目录可被 FileProvider 共享、签名校验能区分本应用与其他文件、安装权限调用安全)。

0.5.4 课间空档与休息横带

本版版本号 0.5.4(versionCode 54)。

  • 休息横带只出现在真正的午休与晚休:空档必须长于 30 分钟,且落在午间或傍晚的时段内。原来 10 分钟课间也会被标成「午休」,一屏好几条。
  • 空档高度改为按时长分配:20 分钟以内的课间只留一条细缝,午休占整块,晚休按比例。凌晨与深夜两端的空档也收成细缝,课程行不再被十几个空档压扁。
  • 有课程占用某段空档时不再画横带,横带也不会再用最小高度顶到相邻课程卡。
  • 新增 8 项空档规则单元测试与 2 项界面回归(横带数量、横带与课程卡不重叠、行高不被压扁)。

0.5.3 课表主页排版修复

本版版本号 0.5.3(versionCode 53)。

  • 课程卡按实际字体测量分配完整文字行;短卡空间不足时收起次要信息,避免地点或教师只显示半行。
  • 紧凑模式已压缩的午休、晚休空档不再绘制横带,避免侵入课程区域。
  • 顶栏周次与操作按钮分别占位,修复窄屏、大字体下的重叠。
  • 新增两项 Android 界面回归测试,覆盖短卡、字体放大、深色主题和 280dp 窄屏顶栏;Android 16 模拟器运行通过。

0.5.1 底部导航跟随 Nexio

  • 底部导航不再是深色实心条:改成浅色悬浮胶囊 + 选中项淡色药丸(选中主题色、未选中次级灰),外面加一层柔和投影。
  • 深色模式用深色表面,壁纸 + 玻璃材质档仍然走折射,不额外叠色。
  • 三个入口(课表 / 课程 / 我的)与滑动指示条的行为不变。

0.5.0 课表界面按 Nexio 重构

本版版本号 0.5.0(versionCode 50),把课表页的视觉改成 NexioSchedule 那套「近白底 + 极浅色卡片 + 同色系文字」:

  • 课程卡不再是实心色块:底色是课程色 18% 铺在页面底色上,文字保留课程色色相并保证 ≥ 4.6:1 对比度,绿卡绿字、紫卡紫字。
  • 顶栏改为居中「第N周」(点开周次直跳),右侧只留导入 / 加课 / 更多三个图标;切换课表收进「更多」菜单。
  • 星期表头改为「周一 + 10/26」两行居中,今日加粗换主题色;去掉左上角的月份标签和大号日期数字。
  • 时间列改为 36dp 居中排版(节次号 14sp、起止时间 10sp),当前节次只换文字颜色,不再有胶囊底色。
  • 新增午休 / 晚休横带:24dp 高的浅色圆角条,只在「上午→下午」「下午→晚上」这两段空档出现。
  • 日列表的课程行同步改版;地点统一带 @。
  • 外观设置新增「卡片风格:柔和 / 实色」,默认柔和,随时可以切回 0.4.x 的实色观感。

对照表与推导规则见 按 Nexio 重构课表 UI。

0.4.2 课表页状态持有者与编辑/设置拆屏

本版版本号 0.4.2(versionCode 42),不含新功能与行为变更,继续把 0.4.1 的 UI 分层做完:

  • 课表页的周/日双模式抽成 TimetablePagerState:两个分页、选中星期与选中日期、互斥的翻页任务集中一处,TimetableScreen 由 383 行降到 294 行,只留整页布局与拖拽状态机。
  • 页面换算(周次↔页面、日期↔日分页、某周第几天、拖拽边缘翻页判定)改为纯函数 TimetablePaging,新增 12 项 JVM 测试覆盖首尾钳制、跨月与单周课表。
  • EditorScreens.kt(844 行)拆为课程详情、课程编辑、学期设置、调课管理四个文件;SettingsScreens.kt(575 行)拆为「我的」、课表管理、外观设置、提醒与关于四个文件。包路径不变,调用点与测试零改动。

验证范围与安装包校验见 0.4.2 验证。

0.4.1 UI 结构重排与翻周性能修正

本版版本号 0.4.1(versionCode 41),不新增功能、不改包名与数据格式,只重排 UI 层结构并修正一处翻页开销:

  • 导航改为类型化目的地(ui/navigation/):页面参数一次解析,标题与页面定义同源,屏幕分发集中到 VanNavHost,新增页面漏接会在编译期报错。
  • 拆分应用外壳与课表页:VanApp.kt 由 725 行降到 475 行,只保留主题、返回栈与文件回调;原先 670 行的课表页按顶栏、提示条、拖拽提示、弹窗、网格、分页与日列表拆入 ui/timetable/。
  • 备份、分享与小组件说明从导航文件移出为独立屏幕文件,屏幕不再直接读写文件。
  • 周视图翻页:课程卡不再无条件挂离屏图层,仅被拖拽的卡片保留独立合成层。
  • 页面标识(VanRoute.key)与 0.4.0 的字符串 route 完全一致,返回栈、编辑器草稿与滚动位置存档继续可用。

验证范围与安装包校验见 0.4.1 验证,结构细节见 UI 结构改造说明。

0.4.0 柔光玻璃质感、跨周拖拽与莫奈取色

本版版本号 0.4.0(versionCode 40),在保留 0.3.4 全部特性基础上合入视觉材质与交互优化:

  • 本地集成 :softglass 材质模块与外观看板即时预览,提供柔光玻璃/清透磨砂/无材质切换、Squircle 连续圆角、背景壁纸与卡片光学参数调节、AGSL 渐进模糊顶栏、预测性返回与文字动效。
  • 支持 Android 12+ 莫奈动态配色(含小组件实例独立莫奈开关、正在上课高亮卡片与壁纸变化自动刷新)。
  • 支持周课表长按跨周拖拽调课与冲突覆盖/互换、按周课程备注、自定义节次名称与默认作息、跨课表全局调休、课表排序与开启新学期、日列表时段分组(可关)及中文拼音数字自然排序。

验证范围、安装包校验与已知未验证项见 0.4.0 验证。

已实现

  • 课表/课程/我的三页导航,紧凑周网格与单行下一节提示,默认按屏幕高度适配整周,可切日列表。
  • 全部自有页面双色主题、字号、行高、周末与非本周显示设置。
  • 多课表一份启用;课程多时段、间断周、自定义钟点、单次课程与整周实践。
  • 多作息日期规则、整日停课/替换、单次取消/移动/地点时间修改。
  • WakeUp 五行备份、七列 CSV、本机备份解析及事务保存为新表;WakeUp 作息关联 ID 不一致时按文件内容重建关联。
  • 完整备份恢复、覆盖前快照、单表数据与周图片分享。
  • 原生滚动双日/今日小组件、下一节卡片、实例独立主题。
  • 课前提醒、可选课程状态通知、授权检测、测试通知和手环镜像说明。
  • 自行输入教务系统网址或选择文件;按页面路径选择通用或协议获取器,不内置真实学校名称和网址,默认清理登录会话。
  • PDF、Excel(.xlsx/.xls)、课表图片本机导入;选择Excel工作表、逐页PDF识别、可编辑识别结果核对,确认后进入学期与作息预览。
  • “我的 → 关于版本”显示版本号与包名,点击“检查更新”联网读取 GitHub 发布页的最新版本,有新版本时给出更新说明和下载入口。

0.3.4 课程合并与周次进度条

本次把并行开发的 0.3.2 进度条开关版(versionCode 34)并入 0.3.3 主线,版本号 0.3.4,versionCode 35。

“课程”页把已关联的正课、实验课和期末考试合为一项,详情按类型分区,分别编辑、设置提醒或删除;关联只影响展示,不迁移数据库记录,同名但没有关联的课程仍独立显示。搜索与“只看本周有课”包含关联课程和单次调课日期。

课表底部增加周次滑动条:拖动只预览周数,松手后按原有分页动画切换,与日列表、左右翻页和回到本周联动。外观设置新增“显示周次进度条”,关闭后收起进度条及其占位,设置随完整备份保存与恢复。

课程编辑的周次改为弹窗网格,支持点击和滑动多选;星期、开始节和结束节合并为滚轮选择,指定单次日期后隐藏星期与周次。作息管理改为逐节时间列表,可用滚轮编辑起止时间并增减每天节数,保存前检查时间先后、重叠和课程占用。

左侧节次与起止时间按实际字体测量最小行高和宽度,修复紧凑布局或大字体下结束时间被裁切;历史更新条目增加序号与新增/优化/修复/调整分类,默认展开最新版本。

包名、签名与数据库不变,可直接覆盖 0.3.2/0.3.3 升级。验证范围见 0.3.4 验证,并入部分的历史记录见 课程合并与时间编辑验证、界面修正验证 与 周次进度条开关验证。

0.3.3 版本信息与检查更新

“我的”新增“关于版本”,显示版本号、版本代码、包名和运行环境,并提供“检查更新”。 点击后联网读取 GitHub 发布页的最新版本:已是最新时显示发布页版本号和检查时间;有新版本时显示版本号、发布时间与更新说明,可打开下载页或复制下载链接,同时弹出一次更新提示。 检查只在点击时发起,只读取公开的版本号与更新说明,不上传课表、账号或设备标识;网络不可用、GitHub 访问失败或发布页异常时显示原因与重试入口。 检查更新需要手机能访问 GitHub(已开启代理或 VPN 时可用);受限网络下会提示失败,并提供“打开发布页”在浏览器中查看。 “帮助与关于”增加“版本与更新”入口,隐私说明同步补充检查更新的联网范围。包名、签名和数据库不变。

验证范围见 0.3.3 验证。

0.3.2 桌面小组件添加反馈

“我的 → 桌面小组件”的“添加到桌面”按钮不再点击无反馈:桌面不支持直接添加、请求被拒绝、请求已发送和调用失败会分别给出说明。 请求已发送只表示已交给桌面处理,组件是否出现取决于桌面是否弹出确认窗口。页面提供手动添加步骤和“返回桌面手动添加”按钮,长按桌面空白处即可在小组件列表中选择 van课表。 验证范围见 0.3.2 验证。

0.3.1 安装包瘦身与交互衔接

发布包开启 R8 优化与代码/资源裁剪,默认只包含 arm64 手机需要的原生库,DEX 压缩打包。完整离线 OCR 引擎及中英文字库保留,不增加在线识别依赖。 底栏选中指示器滑动、二级页面进入返回、周课表课程卡按压回弹与详情标题卡轻量展开,沿用现有配色与布局。 课程卡缩放仅在动画时挂载图层;保持原有邻周预加载,保持跟手分页、日列表及字号放大后的横向滚动边界。

包名、原签名和数据库保持兼容。安装包及本次验证范围见 0.3.1 验证。

默认发布构建:./gradlew :app:assembleRelease。需要 32 位手机或其他架构时,可指定 -PvanReleaseAbis=armeabi-v7a,arm64-v8a,x86,x86_64;调试包不限制架构。

0.3.0 手环课表(联调版)

手机“我的 → 手环课表”新增14天课程同步、通信示例、自动同步开关与清除缓存。 手环端在 wearable/,提供今日/明日课程和详情;已结束课程自动消失,缓存有效时可断连使用。 原签名和 app.van.timetable 包名保留,旧课程、备注及设置支持覆盖升级。

2026-10-25按用户要求移除手环系统小组件,仅保留手环应用与手机同步。 当前RPK versionCode 9不含系统卡片声明、原生加载器或专用缓存桥;手机versionCode 30移除对应说明。 用户已确认此前版本可正常显示课程,并确认14天课程保存及ACK回传成功;本次移除版仅做电脑验证。 问题及停用范围见 手环阶段总结。手机原有桌面小组件保留。 安装与构建见 手环说明,验证范围见 0.3.0验证。

0.2.9 课程备注快捷编辑

点击课程后,可在详情页直接添加、编辑或清空课程备注,多行记录分数分布、老师是否点名和作业要求等信息。 “课程”页面提供一个统一的“课程备注”按钮,集中查看当前课表全部课程的备注;没有填写的课程显示“暂无备注”,也可在汇总页添加或编辑。汇总内容不受课程列表搜索和本周筛选影响。 已有备注的课程排在前面,未填写的排在后面,同组内保持原顺序;保存或清空备注后自动更新排序。 同一课程的全部时段共用备注,编辑整门课程时也可修改。沿用已有 Course.note 字段,保留旧备注及完整备份兼容性。 验证范围见 课程备注验证。

0.2.8 课表布局自动切换与圆角修正

整张课表的课程时间均在作息节次内时,默认采用 0.2.5 的紧凑节次布局,保留 6dp 圆角、左右各 2dp、上下各 2dp 的卡片留白,只收起时间轴上的课间空档。 存在占用课前、午休、课后等空档的课程时,默认采用 0.2.6 的固定空档时间轴布局。两种布局都保留圆角矩形和空课节次。 判断包含所有周次、单次课程、调课和假期预览,切周保持布局稳定。外观开关更名为“保留课间时间空档”,可手动选择或恢复自动判断。 设置随完整备份保存与恢复。验证记录见 0.2.8验证。

0.2.7 小组件外观优化

今日/双日小组件增加留白,区分课程名称、地点教师与时间的文字层级,使用圆头课程色条和星期强调色。 隐藏底部更新时间,保留课表名设置入口、顶部手动刷新、课程自定义颜色和两列独立滚动。 按可用高度适配三行或两行课程信息,支持浅色与深色主题。

本次验证与实际小组件截图见 0.2.7验证。

0.2.6 紧凑课表与课程操作

周课表按作息固定节次高度,课间及作息前后保留统一窄缝,自定义课程不再撑开整张时间轴。 完全位于空档的课程显示为单行小卡片,点击查看完整信息;同一空档多门无冲突课程并排显示。 仅一次日期使用日历并可清除,开始节和结束节使用双列滚轮,确认后写入草稿。 课程详情新增“仅删除本日本节”,仅取消当天所点时段,调入课程按原始日期取消。 帮助与关于增加离线历史版本更新目录,包含 0.2.6 和已有旧版本说明。 缓存周课程、冲突、非本周课程及卡片位置,移除逐卡片约束子组合以减少分页开销。 切周保留跟手横移、吸附和按钮跳转动画,去掉整页透明度与缩放装饰。

本次验证范围及性能对比见 0.2.6验证。

覆盖 GitHub 原版时必须使用原签名密钥。构建会读取工程根目录的私有 signing.properties:

storeFile=tr/van-original-debug.keystore
storePassword=填写原密钥密码
keyAlias=androiddebugkey
keyPassword=填写原私钥密码

配置存在时,Debug 和 Release 均使用该密钥,并在构建前核对原版证书 SHA-256 2787e9a025cbd6606ac2ec05415432513ada6732360ce4dc2abb22e049e938bf。 密钥、说明原件和配置不进入源码包;缺少此配置时生成的本机 Debug 包仅用于开发,不能作为原版覆盖升级包。

0.2.5 自定义时间标签开关

在“我的 → 外观设置”新增“显示自定义时间课时间”开关,默认开启,选择自动保存。 关闭后隐藏周课表左侧自定义时间课程的额外时间标签,保留正常节次时间及课程位置;桌面小组件继续按原有方式显示。 公开版本移除历史截图、运行日志和原始文件衍生测试;保留匿名合成样例。公开版68项单元测试及11项解析脚本测试通过,0失败、0跳过。 移除内置真实学校名称及域名,改为按教务页面路径选择协议获取器;旧提交和旧Release未重写。 本次尚未在模拟器或真机中验证开关效果。安装包沿用Android Debug签名,支持Android 8.0及以上。

0.2.4 滑动稳定性、Excel 与后台入口

分页各自持有横向滚动状态,缓存课程和时间轴计算;下一节搜索在后台计算,并预先加载相邻页。 支持网格 Excel 中同格多门课程、同门课多组周次和地点,以及“第3节-第5节”的明确节次范围。 外部入口复用主页面,恢复时避免重复处理入口;小组件进入会清理旧页面历史。 原始 Excel 已验证 11 门课程、26 个时段的读取、核对、保存与恢复。文件没有开学日期和作息时间,保存前仍须核对。 验证范围及性能数据见0.2.4优化与兼容验证。

0.2.3 返回本周、短滑切周与时间轴

课表右侧增加独立的“回到本周/今日”按钮;慢拖切周阈值降为18%,保留跟手与松手吸附。 固定底部说明栏高度,避免有调课说明的周次挤短网格。自定义时间仅展开实际占用的课间, 左侧保留原文件作息并显示正确边界。14项相关模拟器测试通过,包含用户原件导入、保存与完整恢复; 单元检查69项通过、1项可选PDF样本对照跳过。验证记录见0.2.3课表交互与时间轴修复。

0.2.2 4×2小组件画面

双日小组件默认占4×2,左上显示课表名,右上显示日期周次。 较高尺寸分三行显示课程、教室/教师、时间;较矮尺寸使用紧凑两行布局, 保留两列独立滚动、浅深色及自动刷新。9项相关模拟器测试通过; 170、130、110dp高度均包含系统宿主边距并检查每列两节课程完整显示。 说明与实测画面见0.2.2小组件优化与验证。

0.2.1 课表分页动画

周课表与日列表跟随手指滑动,松开后吸附,采用轻微缩放与淡入淡出。 选择周次和回到今天也使用动画。大字号网格先横向查看,到边缘后再滑动切周。 20项相关模拟器测试通过,Debug安装包与测试包构建成功,Lint为0错误、56条警告。 实现、截图及验证边界见0.2.1分页动画与验证。

0.2.0 课程编辑、调色盘、周次调课与小组件

修复新增课程草稿复用:空名称不会保存或覆盖上一门课程,每次新增及编辑读取独立草稿。小组件的背景、无课区域与课程下方空白可打开绑定课表,进入应用或课程详情自动刷新,长列表仍可独立滚动。课程支持调色盘与颜色代码,备份和图片导出保留自定义颜色。

整日和单次调课新增按周次/星期选择,课程列表显示连续或间断周次。课表顶部增加回到今日/本周按钮;自定义钟点和修改时间后的课程按实际时间进入网格,作息外和午间课程可在网格内滚动查看。说明、截图及本轮测试记录见0.2.0更新与验证。

0.1.11 按当前个人课表页面适配(历史记录)

按内置浏览器里实际显示的2026-2027学年第1学期课表调整。主表26个常规时段与页脚9个实践/其它时段全部保留,共12门课程、35个时段;不重复读取隐藏列表。无固定时间课程在预览明确标注,不显示猜测的钟点;改学期但未查询时拦截旧表导入。

17项相关Android模拟器测试全部通过,覆盖双色预览、完整保存、原课表及启用状态保留;11项脚本回归通过。JVM共62项,61项通过、1项PDF样本对照因未提供环境参数跳过。Debug/Release构建成功,Lint为0错误、55条警告,最终崩溃缓冲区为空。测试样本按实际页面重建并移除个人身份,学校作息与开学日期仍需核对。详见适配说明和本地验证报告。

0.1.10 某学校课表入口适配(历史记录)

某学校网址现在自动使用专用获取器。登录后在学生课表查询页选择学年、学期并查询,再点击“获取当前课表”。读取课程名、老师、教室、星期、节次以及间断周/单双周,并在预览显示所选教务学期。接口读取失败时尝试读取已显示的网页;登录失效、坏字段和实践或时间未定课程会明确停止导入,避免漏课后直接保存。

已使用Test Android Apps的Android Emulator QA流程在API37模拟器实测:15项相关Android测试通过,包含8项专用WebView测试、4项原DOM测试和3项导入流程测试;浅色/深色预览、保存新课表、原课表及启用状态保留通过。真实学校入口正常跳转登录页,未登录获取时显示正确提示;修复了网站改写数组方法导致的兼容问题。10项独立脚本回归通过;JVM检查59项通过、1项原PDF对照因未提供样本环境参数跳过。Debug、Release与Android测试包构建成功,Lint为0错误、55条警告,最终崩溃缓冲区无记录。个人课表使用合成数据验证,学校真实响应与作息仍待登录后对照。详见适配说明和本地验证报告。

0.1.9 假期课程灰色卡片(历史记录)

假期内原本安排的课程现在按“非本周课程”的灰色卡片显示,保留课程名、教室与节次位置,并加上“[放假]”标记;去掉整列灰色“放假”。日列表、自定义时间课程与导出周图片也保留灰色假期课程供查看。假期预览不受“显示非本周课程”开关影响;小组件、提醒和下一节计算继续跳过这些课程。验证记录见本地验证报告。

本轮5项相关模拟器测试和59项JVM检查通过,0失败、0跳过;包含双色卡片实际像素、日列表及导出、撤销恢复、组件自动刷新和点击、日历和周/日滑动。Debug、Release和测试包构建成功,Lint为0错误、55条警告;未重复0.1.8的32项完整设备回归。

0.1.8 假期、自动刷新与日历选日期(历史记录)

“我的 → 节假日设置”可为当前课表添加、编辑和撤销起止日期假期,包含首尾两天。假期内的普通课、实验课、考试和调入课程不显示、不提醒;周课表使用无课的灰色标注“放假”,日列表显示假期说明。原课程保留,撤销后恢复。

小组件在保存课表或设置后自动同步,继续按课程开始、结束和跨天安排刷新,并增加系统30分钟周期更新。点击组件课程、日期标题或下一节卡片进入其绑定的课表;底部课表名称仍打开组件设置。“学期设置”的第1周周一改为日历选择,并在修改日期后重新计算当前周次。准时刷新可在组件设置中授权“闹钟与提醒”,厂商后台限制仍需真机核对。

本轮32项Android模拟器测试及59项JVM检查通过,0失败、0跳过;包括不点击刷新时保存/撤销假期的组件同步,以及等待真实课程结束闹钟后自动移除课程。三份PDF、4×2双主题两节课、独立绑定与滑动完整回归通过。Debug、Release、测试包构建成功,Lint为0错误、53条警告。截图与验证范围见本地验证报告。

以下为历史版本记录。

0.1.7 小组件常规字重与星期显示复核

今日/双日列表及下一节小组件的课程名改为常规字重,保留原有4×2紧凑布局。每个小组件支持浅色、深色、跟随App,点击底部课表名称进入设置。日列表日期旁已有“周一”至“周日”,本轮确认左右切换日期后星期同步更新。

3项相关Android模拟器测试通过:两种主题170dp/130dp高度的两节课完整可见、小组件独立绑定与主题保存、周/日滑动及星期显示。Debug、Release和测试包构建成功,Lint为0错误、51条警告;本轮未重复执行0.1.6的28项完整回归。截图与范围见本地验证报告。

0.1.6 小组件4×2显示两节课

双日/今日小组件采用紧凑两行课程卡片,保留课程名、时间和地点,减少上下留白与卡片间距。双日小组件在4×2尺寸下“今天”“明天”每列至少完整显示两节;更多课程继续独立滚动。正在上课状态显示在课程名旁,长名称和地点省略,点击课程查看详情。

使用Test Android Apps流程在真实AppWidgetHost中验证312dp宽、170dp与130dp高,含系统宿主留白;两种主题每列前两节的卡片和文字均完整可见,时间段未截断。28项Android测试与53项JVM检查通过,0失败、0跳过;Debug/Release构建成功,Lint为0错误、51条警告。具体尺寸记录、截图与真机验证边界见本地验证报告。

0.1.5 模拟器验证与滑动修复

使用 Test Android Apps 的 Android Emulator QA 流程,在 Android API37 / x86_64 模拟器完整执行27项测试,0失败、0跳过。三份实际PDF经Android文件URI读取、生成课表、保存回读通过;12色保存、实验课与期末考试快捷添加、星期显示、周/日双向滑动、两个真实小组件的独立绑定和设置界面保存均通过。

修复0.1.4周网格拦截横向手势的问题。放大字号后先横向浏览网格,到边缘再滑动切周;保留纵向滚动和课程点击。旧版使用同一测试不能从第6周切到第7周,新版通过;另按界面树坐标手动复核。53项JVM检查通过,Debug/Release构建成功,Lint为0错误、47条警告。记录与截图见本地验证报告。厂商桌面和后台策略仍需真机验证。

0.1.4 本地更新

  • 支持本次三份实际PDF:读取文字层、CID字体映射、旋转页面、续页星期、课程代码、窄列换行和单双周;无固定时间课程与实践课程保留供核对。
  • 添加课程提供12种颜色,已有5种颜色的编号保持兼容,课表、导出图片与小组件同步使用。
  • 课程详情可快捷添加实验课和期末考试,预填名称、颜色与老师,保存为关联原课程的独立课程。
  • 双日小组件“今天/明天”标题由16sp缩小为13sp;每个实例独立选择课表,点击底部课表名称可重新配置。固定绑定的课表删除后显示待选择状态。
  • 周课表左右滑动切周,日列表左右滑动切日期并显示周几;切换周次时日列表日期同步。

0.1.4通过53项JVM测试(包含三份原PDF的识别、字段核对、生成课表与备份往返),Debug、Release、Android测试包构建成功,Lint为0错误、47条警告。本次新增Android交互测试已编译,但模拟器启动停滞,尚未执行;不得将0.1.3的设备测试记录当成本轮交互验证。真实设备上的滑动、小组件绑定、快捷添加以及系统文件选择仍需核对。

验证边界

0.1.3增加PDF、Excel和图片导入。Excel读取七列课程表和带星期表头的周网格;PDF由Android本机渲染后识别,图片采用随安装包提供的中英文离线OCR模型。识别可能出现错字、漏课或缺字段,保存前可修改、补充和移除课程,不会猜测缺失的星期、节次或学期周次。整周截图若只有日期而没有学期周次,需要用户补全。PDF最多12页,文件最多25MB(Excel20MB)。

0.1.3已通过47项JVM测试、22项Android模拟器测试,Debug与Release构建成功;Android Lint为0错误、49条警告。验证包括真实生成的XLS/XLSX、中文PNG、两页扫描PDF、英文矢量PDF、双主题核对、工作表切换、重新选择文件、Activity重建和保存后旧课表保留。测试资料为原创合成文件,学校实际导出仍待对照。详细记录见本地验证报告。

针对某学校截图中的窄列换行、(1-2节)3-4周,6-8周和无提示属性的图标元数据,已修复网页文本与周次读取,星期按真实表头映射并兼容合并单元格;抓取错误摘要限制长度,网页可缩放。截图对应的原创WebView结构测试已通过,但未取得登录后的原始HTML,仍需更新后在个人课表页重新获取。

0.1.2 移除界面上的四校列表,改为网址输入和本地文件选择,两种主题均已验证。网址支持 HTTP、HTTPS、端口及校园网 IP;保留四校适配,允许网页跳转登录。其他学校能打开网页,但通用获取器不保证识别所有教务系统。

针对反馈的“作息关联ID不一致”,WakeUp 单表备份会根据文件内的节次和时间重建关联,并提示核对。缺节次、重复节次、异常时间和无法确定归属的多套作息仍拒绝导入。文件选择回调、预览、保存、启用及旧课表保留已纳入上述回归测试;测试文件为原创合成数据,用户的真实备份尚未提供。

某学校反馈的老师、地点读取修复已保留,合成网页测试覆盖字段读取、单双周和保存备份;当前学校实际页面仍需重新导入对照。其余学校获取器仍需真实课程样本,某学校实际入口尚待确认。系统后台刷新、国产 ROM 省电策略及小米手环镜像需真机验证。

构建

Java 21(产物 JVM 17)、Gradle 9.3.1、Android SDK 37.0、Build Tools 36.0.0。

在 Android Studio 打开此目录,设置本机 SDK;或配置 local.properties 后执行:

.\gradlew.bat :core:domain:test :app:assembleDebug :app:lintDebug
.\gradlew.bat :app:connectedDebugAndroidTest

中文 Windows 路径可能导致 JVM 测试进程无法启动;本机开发使用临时目录路径别名,真实项目仍在原目录。工具缓存位于上级 .tools,不属于应用源码。

本机可直接运行 ./build-local.ps1;其他 SDK / Java 路径通过 -SdkPath、-JavaPath 指定。使用说明和验证边界见 使用与待验证项。

APK:app/build/outputs/apk/debug/app-debug.apk。这是本地调试签名包;正式签名与发布另行处理。

数据与权限

课程聚合保存于 Room,设备偏好使用 DataStore。没有分析、广告或第三方后台。文件、PDF及图片识别在本机进行,不上传课表文件或识别结果;识别模型随包提供,不需要登录识别服务。数据库不参与 Android 自动云备份。导出备份不包含登录 Cookie、账号密码、系统授权或小组件实例ID。

显式权限:INTERNET、POST_NOTIFICATIONS、SCHEDULE_EXACT_ALARM、RECEIVE_BOOT_COMPLETED。完整合并 Manifest 以构建报告为准。文件通过 SAF 与 FileProvider 使用,不需要广泛存储、相机、位置或蓝牙权限。

许可证见 LICENSE,第三方声明见 THIRD_PARTY_NOTICES.md。

About

一款本地优先的开源 Android 课表工具,重点处理单双周、临时调课、停课补课、节假日和多套作息等复杂安排,让“下一节课”和提醒跟随实际课程变化。支持从教务网页、PDF、Excel、图片及 WakeUp 备份导入课表,并可将14天课程同步到小米手环,离线查看今日与明日课程。

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages