React Native Push Notification 常见问题排查指南

React Native Push Notification 常见问题排查指南

react-native-push-notification React Native Local and Remote Notifications 项目地址: https://gitcode.com/gh_mirrors/re/react-native-push-notification

前言

在移动应用开发中，推送通知是提升用户参与度和留存率的重要功能。react-native-push-notification 是一个流行的 React Native 推送通知库，但在使用过程中开发者可能会遇到各种问题。本文将系统性地梳理常见问题及其解决方案，帮助开发者更好地使用该库。

已知问题

Android 平台问题

1. 通知点击事件未触发
   在某些 Android 设备上，点击通知中心的通知可能不会触发 onNotification 回调。这是已知的系统级问题，建议在回调中添加日志记录以便调试。

2. 本地通知功能限制
   目前并非所有本地通知功能都得到完全支持，特别是通知分组(grouping)功能暂不可用。

3. 日期处理问题
   使用字符串初始化日期对象会导致问题，特别是在禁用远程调试时。推荐使用以下方式：

// 正确做法：获取今天12:30:00的日期对象
const hour = 12;
const minute = 30;
const second = 0;

const now = new Date();
const date = new Date(
  now.getFullYear(),
  now.getMonth(),
  now.getDate(),
  hour,
  minute,
  second
);

iOS 平台问题

1. 完成处理程序缺失
   iOS 系统会惩罚未调用完成处理程序的应用，可能导致通知延迟或停止发送。从 React Native 0.38 版本开始支持此功能。

Android 开发建议

1. 设备选择
   远程推送通知在模拟器上无法正常工作，务必使用物理设备进行测试。

2. 日志排查
   在调试时，建议过滤 ReactNativeJS|RNPushNotification 日志，通常能发现问题的线索。

3. GCM SenderID 获取
   从 Google 控制台下载的 google-services.json 文件中，project_number 即为所需的 SenderID。

4. 模块链接问题
   出现 "Native module cannot be null" 错误时，通常是由于项目链接不正确。请仔细检查安装步骤，特别是 react-native link 和 MainApplication.java 配置部分。

5. 角标支持
   并非所有 Android 设备都支持应用角标功能，应用启动时会记录相关错误日志。

iOS 开发建议

1. 设备选择
   与 Android 类似，远程推送通知在模拟器上无法工作，必须使用真实设备测试。

2. 调试技巧
   在 AppDelegate.m 的 didReceiveRemoteNotification 方法中添加日志语句，有助于追踪通知接收情况。

3. APNS 日志
   关注设备日志中的 APNS 相关消息，这些信息对调试推送问题非常有帮助。

推送通知类型详解

1. 本地通知

本地通知由应用直接生成并显示在通知中心，直到用户手动清除。支持文本、声音、震动等多种特性，不同操作系统支持程度不同。

Android 特性：

• 高度可定制化
• 目前不支持通知分组等高级功能

2. 显式远程推送通知

这类通知由服务器发送，当应用在后台时仅显示为通知中心提醒。用户点击通知会启动或唤醒应用，并触发 onNotification 回调。

Android 示例：

{
  "to": "<token>",
  "notification": {
    "title": "标题",
    "body": "通知内容",
    "sound": "default"
  }
}

iOS 示例：

{
  "aps": {
    "alert": {
      "body": "内容",
      "title": "标题"
    },
    "sound": "default"
  }
}

3. 静默远程推送通知

这类通知直接传递给应用而不会显示在通知中心，没有视觉或听觉提示。无论应用在前台还是后台都会触发 onNotification 回调。

Android 实现要点：

• 必须包含 data 字段
• 应用未运行时会被启动，但不会触发 React Native 生命周期
• 需要确保 PushNotification.configure 在导入根文件时就被调用

iOS 实现要点：

• 必须包含 "content-available": 1 字段
• 纯静默推送优先级较低，可能被系统延迟
• 处理完成后必须调用 finish 方法

最佳实践

1. 混合使用静默和本地通知
   推荐模式：接收静默推送后，在应用中创建定制化的本地通知，提供更丰富的用户体验。

2. 日期处理
   避免使用字符串初始化日期对象，采用显式参数构造日期。

3. 错误处理
   在所有通知回调中添加健壮的错误处理和日志记录。

4. 平台差异
   针对 Android 和 iOS 的平台特性差异，分别实现适当的回退方案。

通过理解这些常见问题和解决方案，开发者可以更有效地使用 react-native-push-notification 库，构建稳定可靠的推送通知功能。

react-native-push-notification React Native Local and Remote Notifications 项目地址: https://gitcode.com/gh_mirrors/re/react-native-push-notification