SuperAPI AI 工具集

notifications

编程与开发

查看项目

更新于 11-11 22:15

技能介绍

用途

该技能用于 React Native 应用中的推送通知与本地通知实现指导,适用平台为 iOS 和 Android,React Native 0.76+(默认假定已具备新架构互操作能力,除非清单项另有说明)。

主要能力与检查要点

权限与注册

  • 通知权限应在用户主动请求提醒时申请,而非首次启动即弹出。
  • 处于拒绝或已撤销状态时跳过注册,且不循环弹出权限提示。
  • 设备令牌变更后需发送至服务器;用户登出时应从服务器移除。

投递与点击路由

  • 后台处理器需在应用入口文件注册,而不是在组件内部。
  • 前台、后台、被杀应用状态下的点击都应打开同一目标页面。
  • 目标必须是允许的路由之一(路由白名单归安全范畴)。
  • 导航尚未就绪时到达的点击应先存储,并在就绪后消费一次。
  • 冷启动顺序(先恢复会话,再消费一次点击)由架构负责。
  • Android 需为用户可区分的类别建立渠道;iOS 使用用户可理解的目的说明。

隐私

  • 可见标题、正文及数据载荷不得包含支付数据、令牌,或超出用户识别提醒所需的个人细节。
  • 用户未同意时,不得安排营销或非必要提醒(同意相关归安全范畴)。

边界说明

  • 通用权限提示属于原生集成(native-integration)范畴。
  • 深链接目标是否被允许属于安全(security)范畴。

使用方式

在添加通知、处理通知点击,或评审通知载荷内容与权限请求时机时调用该技能。技能给出严重程度分级:合并阻断级包括载荷可导航至任意页面、后台处理器在组件内注册;应修复级包括渠道命名与权限提示出现时机。资料同时提供正确与错误代码示例:错误做法是直接用原始载荷调用导航;正确做法是先将载荷解析为固定路由集合,解析失败则不做跳转。

适用场景

  • 注册推送或安排本地通知。
  • 处理从后台或被杀死应用状态下打开某页面的点击。
  • 评审通知载荷内容与权限请求时机。

限制与注意事项

  • 被杀应用的点击会在下一次冷启动、导航尚不存在时投递,需先存储、恢复会话后再消费。
  • 后台投递限制因平台而异,执行网络工作的处理器可能在完成前被挂起。
  • 常见反模式包括:直接导航原始载荷(可能打开任意页面或因缺失参数崩溃,应解析为固定路由集合)、登出时只注册新令牌而不删除旧令牌(导致前一用户收到后一用户的通知,应在服务端登出时删除令牌)。