路由被点击的推送 \
每条推送都带有data.type 字段。应用监听点击,读取类型,然后打开对应的界面。
app/_layout.tsx
其中两种类型来自 Journeys,本指南不涉及。
reengagement 设置在仪表板中构建的召回 Journey 的推送上。member_lapsed 是发给家庭所有者和管理员的推送,当该 Journey 报告某位成员已停止打扫时由后端发送。它们和其他推送一样在这里路由。
操作按钮:可点击的不止一处 \
推送可以带有按钮。任务推送提供 Start cleaning 和 Snooze 1h,“室友完成打扫”推送提供 Send kudos。用户展开通知即可看到按钮,在 iOS 上需要长按。
展开后带有两个操作按钮的提醒。
id 和一个标签。
supabase/functions/_shared/buttons.ts
event.result.actionId 的形式收到按钮的 id。点击通知本身则没有 actionId。应用会先检查是否为按钮,否则回退到常规路由。
src/lib/pushActions.ts
send_after 安排另一条提醒。OneSignal 会保留消息直到那时,因此不需要任何程序持续运行一小时。
supabase/functions/snooze-reminder/index.ts
每次点击按钮也会记录为自定义事件
push_action_clicked。Journey 无法直接根据按钮分支,但可以等待此事件并根据其 action_id 属性分支。默认情况下,点击按钮会打开应用。若要在不打开应用的情况下处理点击,需要原生代码:iOS 上需要通知类别,Android 上需要 notification service extension。
重写传入的链接 \
来自应用外部的链接使用/clean 这样的短路径。Expo Router 的 native intent 钩子会在导航发生前将其重写为应用的真实路由,因此应用外部的任何东西都不需要了解界面的组织方式。
app/+native-intent.tsx
通过普通网页链接打开应用 \
像cleaning-rota:// 这样的自定义 scheme 只有在应用已安装时才有效,而且许多应用不会让它变成可点击的链接。iOS 上的 Universal Links 和 Android 上的 App Links 解决了这个问题。它们是普通的 https:// 链接,已安装应用时打开应用,未安装时打开网站。因此它们是邮件、短信和分享消息中链接的合适选择。
设置它们需要两端各做一次声明:应用声明自己属于哪个域名,网站声明哪个应用可以打开它的链接。
1
在应用中声明域名
app.json
2
发布 Apple 关联文件
将其托管在
/.well-known/apple-app-site-association,通过 HTTPS 以 JSON 格式提供。应用 ID 是您的 Apple Team ID 后接 bundle identifier。website/.well-known/apple-app-site-association
3
发布 Android 关联文件
将其托管在
/.well-known/assetlinks.json。指纹来自应用的签名证书。使用 EAS 时,运行 eas credentials -p android 即可找到它。website/.well-known/assetlinks.json
4
使用链接
家庭界面会分享邀请链接。点击该链接会打开加入界面,并自动填好邀请码。
app/household.tsx
app/join-household.tsx
Clean Beans 只声明应用能够显示的路径。首页不在其中,因此营销网站仍然在浏览器中打开。iOS 会在安装或更新应用时读取关联文件,因此请在发布构建之前发布该文件。
深度链接
OneSignal 在各平台上如何处理 URL。
通知负载
点击监听器中可用的所有字段。
操作按钮
平台限制、图标和点击处理。