用途
该技能用于 React Native 应用中的推送通知与本地通知实现指导,适用平台为 iOS 和 Android,React Native 0.76+(默认假定已具备新架构互操作能力,除非清单项另有说明)。
主要能力与检查要点
权限与注册
- 通知权限应在用户主动请求提醒时申请,而非首次启动即弹出。
- 处于拒绝或已撤销状态时跳过注册,且不循环弹出权限提示。
- 设备令牌变更后需发送至服务器;用户登出时应从服务器移除。
投递与点击路由
- 后台处理器需在应用入口文件注册,而不是在组件内部。
- 前台、后台、被杀应用状态下的点击都应打开同一目标页面。
- 目标必须是允许的路由之一(路由白名单归安全范畴)。
- 导航尚未就绪时到达的点击应先存储,并在就绪后消费一次。
- 冷启动顺序(先恢复会话,再消费一次点击)由架构负责。
- Android 需为用户可区分的类别建立渠道;iOS 使用用户可理解的目的说明。
隐私
- 可见标题、正文及数据载荷不得包含支付数据、令牌,或超出用户识别提醒所需的个人细节。
- 用户未同意时,不得安排营销或非必要提醒(同意相关归安全范畴)。
边界说明
- 通用权限提示属于原生集成(native-integration)范畴。
- 深链接目标是否被允许属于安全(security)范畴。
使用方式
在添加通知、处理通知点击,或评审通知载荷内容与权限请求时机时调用该技能。技能给出严重程度分级:合并阻断级包括载荷可导航至任意页面、后台处理器在组件内注册;应修复级包括渠道命名与权限提示出现时机。资料同时提供正确与错误代码示例:错误做法是直接用原始载荷调用导航;正确做法是先将载荷解析为固定路由集合,解析失败则不做跳转。
适用场景
- 注册推送或安排本地通知。
- 处理从后台或被杀死应用状态下打开某页面的点击。
- 评审通知载荷内容与权限请求时机。
限制与注意事项
- 被杀应用的点击会在下一次冷启动、导航尚不存在时投递,需先存储、恢复会话后再消费。
- 后台投递限制因平台而异,执行网络工作的处理器可能在完成前被挂起。
- 常见反模式包括:直接导航原始载荷(可能打开任意页面或因缺失参数崩溃,应解析为固定路由集合)、登出时只注册新令牌而不删除旧令牌(导致前一用户收到后一用户的通知,应在服务端登出时删除令牌)。