Notifee 在 Android 发布版本中小图标显示异常问题解析

问题现象

在 React Native 项目中集成 Notifee 推送通知功能时，开发者遇到了一个奇怪的问题：小图标在开发构建中能正常显示，但在发布版本中却出现异常。具体表现为：

1. 初始阶段可能显示正常，但随后会变成白色圆形图标
2. 有时在通知被取消时，反而能正确显示图标
3. 部分设备上完全无法显示自定义图标

问题根源分析

经过多位开发者的实践和讨论，这个问题主要涉及以下几个方面：

1. 图标格式问题：Android 通知图标需要特定的透明背景 PNG 格式
2. 资源压缩问题：发布构建时的资源压缩可能导致图标被优化掉
3. 颜色配置问题：缺少颜色定义可能导致图标显示为白色
4. 渠道配置问题：通知渠道的设置可能影响图标显示

解决方案

1. 正确的图标准备

确保使用符合 Android 规范的透明背景 PNG 图标：

• 图标主体应为纯白色
• 背景必须完全透明
• 推荐尺寸为 24x24dp 或 48x48dp

2. 资源配置保护

在 android/app/src/main/res/raw/keep.xml 中添加以下内容，防止资源被压缩工具移除：

<?xml version="1.0" encoding="utf-8"?>
<resources xmlns:tools="http://schemas.android.com/tools"
    tools:keep="@drawable/ic_notification,@mipmap/ic_notification" />

3. 完整的通知配置

在代码中确保包含所有必要的配置项：

await notifee.displayNotification({
  title: '通知标题',
  body: '通知内容',
  android: {
    channelId: '自定义渠道ID',
    smallIcon: 'ic_notification', // 必须与资源文件名称一致
    color: '#FF0000', // 必须设置颜色
    importance: AndroidImportance.HIGH,
    pressAction: {
      id: 'default',
    },
  },
});

4. AndroidManifest 配置

在 AndroidManifest.xml 中添加默认通知图标配置：

<meta-data
  android:name="com.google.firebase.messaging.default_notification_icon"
  android:resource="@mipmap/ic_notification" />

最佳实践建议

1. 使用 Android Studio 生成图标：通过 Android Studio 的 Image Asset Studio 工具生成符合规范的图标
2. 多分辨率支持：为不同屏幕密度提供多套图标，放置在对应的 drawable 目录中
3. 测试策略：在多种 Android 版本和设备上进行测试
4. 颜色搭配：选择与品牌相符的通知颜色，确保图标清晰可见

总结

Notifee 在 Android 发布版本中的小图标显示问题通常不是库本身的缺陷，而是由于 Android 平台对通知图标的特殊要求导致的。通过遵循上述解决方案和最佳实践，开发者可以确保通知图标在各种环境下都能正确显示。记住，透明的 PNG 格式、正确的资源配置和完整的通知参数是解决问题的关键。