Notifee项目中Android通知数据传递问题的解决方案

背景介绍

在移动应用开发中，通知功能是用户交互的重要组成部分。Notifee作为一个React Native通知库，提供了丰富的通知管理功能。然而，在Android平台上，开发者遇到了一个棘手的问题：从通知点击意图(Intent)中传递的额外参数无法正确回传到JavaScript层。

问题分析

问题的核心在于Android平台的通知数据传递机制。当用户点击通知时，系统会触发一个Intent，这个Intent可以携带额外的数据参数。然而，Notifee库在获取已显示通知列表时，只处理了特定的预定义字段，没有将Intent中的额外参数包含在返回给JavaScript的数据中。

技术细节

在Android系统中，通知数据通常存储在Notification对象的extras Bundle中。Notifee通过getDisplayedNotifications方法获取当前显示的通知列表时，只提取了以下字段：

• 通知ID
• 标题(title)
• 正文(body)
• 副标题(subtitle)
• 频道ID(channelId)
• 标签(tag)
• 分组(group)

而开发者需要传递的自定义数据字段则被忽略了，这导致了数据传递的中断。

解决方案

开发者通过以下两个关键步骤解决了这个问题：

1. 修改通知处理服务

重写了FirebaseMessagingService的handleIntent方法，确保在创建通知时将自定义数据存入通知的extras中：

@Override
public void handleIntent(Intent intent) {
    // 创建通知构建器
    NotificationCompat.Builder notificationBuilder = new NotificationCompat.Builder(this, "channel_id")
        .setSmallIcon(icon)
        .setContentTitle(title)
        .setContentText(body);
    
    // 将自定义数据存入通知extras
    Bundle customExtras = new Bundle();
    for (Map.Entry<String, String> entry : message.getData().entrySet()) {
        customExtras.putString(entry.getKey(), entry.getValue());
    }
    notificationBuilder.getExtras().putBundle("data", customExtras);
    
    // 显示通知
    notificationManager.notify(tag, id, notificationBuilder.build());
}

2. 扩展Notifee功能

在Notifee模块中添加了fetchNotificationData方法，在获取通知列表时补充提取自定义数据：

private List<Bundle> fetchNotificationData(List<Bundle> notifications) {
    // 获取系统当前显示的所有通知
    StatusBarNotification[] activeNotifications = notificationManager.getActiveNotifications();
    
    for (StatusBarNotification sbn : activeNotifications) {
        // 从通知extras中获取自定义数据
        Bundle data = sbn.getNotification().extras.getBundle("data");
        if (data != null) {
            // 将数据添加到对应的通知对象中
            for (Bundle notification : notifications) {
                if (notification.getString("id").equals(sbn.getId())) {
                    notification.getBundle("notification").putBundle("data", data);
                }
            }
        }
    }
    return notifications;
}

实现效果

通过上述修改，开发者成功实现了：

1. 在Android通知中存储自定义数据
2. 在JavaScript层通过getDisplayedNotifications方法获取完整的通知数据，包括自定义字段
3. 保持了与iOS平台一致的数据获取方式

最佳实践建议

对于需要在通知中传递数据的场景，建议：

1. 将重要数据同时放在通知的data字段和显示内容中
2. 对数据进行合理的序列化和反序列化处理
3. 考虑数据大小限制，避免传递过大的数据
4. 对敏感数据进行适当的加密处理

总结

这个案例展示了在React Native生态系统中处理平台特定功能时可能遇到的挑战，以及如何通过深入理解底层机制来解决问题。通过修改通知服务和扩展Notifee功能，开发者成功实现了Android平台上通知数据的完整传递，为类似场景提供了有价值的参考方案。