
Clean Beans:仪表板、一次打扫会话和每周值日表。
Clean Beans 的功能 \
家庭添加房间后,应用会将其转换为一份频率合理的打扫任务清单。值日表生成器会根据每个人的可用时间,把这些任务分配到一周中。成员可以开始打扫会话、勾选任务、积累每日连续记录、互相发送 kudos,并在每周排行榜上竞争。 打扫是共同承担、反复发生且有时限的事情,因此几乎适合所有类型的消息:提醒、社交动态、倒计时、总结和指导。本指南的用途 \
您可以用它来回答三个问题:- 哪个 OneSignal 功能适合哪项工作? 每个页面都从应用需要完成的事情出发,再展示实现它的功能。
- 代码应该放在哪里? 有些工作属于应用,有些属于您的后端,有些属于 OneSignal 仪表板。每个示例都会说明归属。
- 会出什么问题? 每个页面的警告和说明记录了上线过程中学到的经验。有一个设置
collapse_id曾经试用后又被移除,可靠且表现得当的推送解释了原因。
阅读方式 \
本指南由一组页面组成,每个页面一个主题。您无需按顺序阅读。SDK 设置和用户身份是其他所有内容的基础。之后的每个页面都可以独立阅读。 大多数功能都以相同的方式介绍:- 用户看到的内容,通常附有截图。
- 工作原理,以简短的步骤说明谁做什么。
- 代码,摘自应用。每个代码块的标题就是它所在的文件。
- 仪表板设置,适用于需要在 OneSignal 中配置的功能。
代码是真实的,但标识符已替换为
YOUR_ONESIGNAL_APP_ID 和 YOUR_PROJECT_REF 等占位符。较长的文件已精简为关键代码行。仅包含 // ... 的行表示此处省略了代码。各部分如何协同 \
External ID 将三者连接在一起。Clean Beans 在登录时将其设置为 Supabase 用户 ID,因此后端可以用已存储的 ID 联系任何人。

应用、后端和仪表板分别与 OneSignal 通信。External ID 将它们关联到同一个用户。
功能地图 \
准备工作 \
- 一个已为 iOS 和 Android 配置推送、并已设置邮件和短信的 OneSignal 应用。请参阅渠道设置。
- 一个使用 EAS Build 构建的 Expo 应用。OneSignal SDK 需要原生代码,因此 Expo Go 不够用。请参阅 Expo SDK 设置。
- 您的 App ID 和一个 App API key。请参阅密钥和 ID。
- 一个能按计划运行代码并响应请求的后端。Clean Beans 使用 Supabase Edge Functions 和
pg_cron。同样的模式适用于任何后端。
经过验证的原则 \
- 先设置 External ID。 这里几乎所有功能都依赖它。请使用后端已存储的 ID。
- 把每项工作放在合适的位置。 应用负责设备和已登录用户。后端负责计划任务和数据变化。仪表板保存所有您希望无需发布新版本即可更改的内容。
- 发送前先检查。 后端的每次发送都会检查用户偏好,并确认确实有值得发送的内容。
- 让计划发送可以重复执行。 由类型、接收者和日期构成的幂等键会让重试变成无操作。
- 按类型而不是 URL 路由。
data.type字段可以在界面变动时让旧通知继续正常工作。 - 验证调用方告诉您的内容。 发送消息的函数应先在您自己的数据库中确认事实。