桌面小组件
小组件概览
Sleepy 提供4 种不同尺寸和用途的桌面小组件，让你不用打开 App 就能直接在手机桌面上看到课表信息。所有小组件的数据都来自你当前选中的课表——切换到不同的课表后，所有小组件的内容也会跟着更新。小组件由 Android 系统的 WorkManager 在后台每 15 分钟自动触发一次内容刷新。你也可以在 App 内随时手动触发即时刷新。
| 小组件名称 | 桌面占用空间 | 显示的内容 |
|---|---|---|
| Today | 3 列 × 2 行 | 今天要上的课程，最多显示 3 节。每节课显示一个彩色小方块（颜色和 App 内的课程色块一致）、课程名称的缩略文字、以及上课时间。如果今天超过 3 节课，末尾会显示"+X 节"的标注 |
| TwoDay | 4 列 × 2 行 | 左边一列显示今天的课程，右边一列显示明天的课程。每列最多展示 3 节课。这个小组件让你在规划日程时不需要来回翻——今天上完课的同时就能看到明天的安排 |
| WeekList | 4 列 × 2 行 | 以简单的数字文本展示一周七天（周一至周日）每天各有几节课——例如"周一 4 节、周二 2 节、周三 6 节、周四 3 节、周五 1 节、周六 0 节、周日 0 节"。一眼就能看出哪几天课最多、哪几天最空。适合用来快速评估一周的忙碌程度 |
| WeekGrid | 4 列 × 5 行 | 在桌面上绘制一个完整的时间网格缩略图——和 App 内的周视图风格一致，但缩小到只占 4×5 格桌面空间。你能看到时间标签、星期标题和彩色的课程色块。这个小组件在技术上采用 Canvas Bitmap 方案（而非 Glance 声明式 API），因为 Glance 1.1.0 的已知 bug 会在转换为底层 RemoteViews 时丢弃第 11 节及以上的子 View——对于有 12 节课的作息表来说这意味着最后两节课的色块会消失。Canvas 方案完全绕过了这个限制 |
如何在桌面上添加小组件
- 在手机桌面长按一个空白区域（不要按在 App 图标或其他小组件上），直到桌面进入编辑模式（图标开始微微晃动或者出现菜单）
- 在出现的菜单或选项中选择"添加小组件"（不同手机品牌的叫法不同——华为/荣耀叫"窗口小工具"、小米/红米叫"添加小部件"、OPPO/vivo叫"桌面插件"、三星叫"Widget"）
- 在小组件列表中向下滚动，找到"Sleepy"。你会看到 Sleepy 下有 4 个不同尺寸的选项（分别对应 Today、TwoDay、WeekList 和 WeekGrid）
- 选择你想要的小组件类型——如果不确定选哪个，建议从 Today 开始试。Today 是最小、最简洁的一个
- 将小组件拖动到桌面上合适的位置（有些手机不是拖动而是点击后自动放置，你可以之后长按它来移动位置）
- （仅限 Android 12 及以上版本）系统会弹出一个小组件配置对话框——你可以在这里选择小组件要显示哪张课表的内容。如果你只创建了一张课表，直接点确认即可
刚添加后显示空白怎么办
小组件刚被拖到桌面上时，可能显示"暂无课程"、"正在加载……"或者完全空白。这是正常现象——小组件在被创建的那一刻还没有从 App 获取到数据。数据会在下一次刷新周期（最多 15 分钟）自动填充。如果你想让它立刻显示，有两种方法：
- 打开 App，进入"我的"标签页，点击"刷新小组件"。这会向所有桌面小组件立即推送最新的课表数据
- 或者直接等待 15 分钟——WorkManager 的下一次调度周期会自动完成刷新
小组件不更新或显示过期数据
如果在添加了新课程或修改了课表之后，小组件上显示的还是旧数据：
- 首先等待 15 分钟——小组件的自动刷新周期是 15 分钟，你刚做的修改可能还没有被下一次刷新捕捉到
- 如果不想等，手动进入 App → "我的" → "刷新小组件" 触发即时更新
- 如果手动刷新后仍然显示旧数据，尝试切换到另一张课表再切回来——这个操作有时可以"唤醒"小组件的更新机制
- 最后的手段：长按小组件，选择"移除"把它从桌面上删掉，然后按照上面的步骤重新添加一次
调整小组件的显示课表
如果你创建了多张课表（例如一张是大一上学期的、一张是大一下学期的），你可以单独为每个小组件指定它要显示哪张课表的内容。长按桌面上的 Sleepy 小组件，在弹出的菜单中选择"设置"或"配置"（如果有的话）。在配置对话框中选择你想要显示的课表。你也可以让不同的小组件显示不同的课表——例如 Today 小组件显示当前学期的课表，WeekGrid 小组件显示下学期的课表做对比。
下一步
了解了如何配置小组件之后，接着了解如何更换 App 的主题配色和调整外观——请参阅外观与设置。