Ionic App Android端通过FCM设置消息Badge计数问题求助

我刚好做过类似的实现，给你梳理下完整的步骤，应该能解决你的问题！核心思路就是在FCM消息接收的回调里，调用Ionic Native Badge插件来维护计数，下面是具体落地的细节：

1. 先安装必要的插件 #

首先确保你把FCM消息插件和Badge插件都装好，这里以现在Ionic推荐的Capacitor生态为例：

• 安装Capacitor Firebase Messaging：

  npm install @capacitor-firebase/messaging
  npx cap sync
  

• 安装Ionic Native Badge插件：

  npm install @ionic-native/badge
  npm install cordova-plugin-badge
  npx cap sync
  

2. 监听FCM消息并更新Badge #

要分前台运行和后台/APP被杀死两种场景处理，因为Android系统对不同状态下的消息回调逻辑不一样：

场景1：APP前台运行时 #

直接在消息接收回调里更新Badge计数：

import { FirebaseMessaging } from '@capacitor-firebase/messaging';
import { Badge } from '@ionic-native/badge/ngx';

constructor(private badge: Badge) {
  this.initFCMListeners();
}

private async initFCMListeners() {
  // 监听前台消息
  FirebaseMessaging.addListener('message', async (message) => {
    console.log('前台收到FCM消息:', message);
    // 获取当前Badge数，加1后更新
    const currentCount = await this.badge.get();
    await this.badge.set(currentCount + 1);
  });
}

场景2：APP后台/被杀死时 #

这种情况需要配置FCM的背景消息处理器，因为APP不在前台时，普通的监听不会触发：
首先在capacitor.config.ts里配置背景处理文件路径：

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  // 你的其他配置
  plugins: {
    FirebaseMessaging: {
      enableAutoInit: true,
      backgroundNotificationHandler: './background-notification-handler.ts',
    },
  },
};

export default config;

然后创建background-notification-handler.ts文件，处理后台消息：

import { Plugins } from '@capacitor/core';

const { Badge } = Plugins;

export const backgroundNotificationHandler = async (message: any) => {
  console.log('后台收到FCM消息:', message);
  // 更新Badge计数
  const currentCount = await Badge.get();
  await Badge.set(currentCount + 1);
  // 返回true表示已处理消息
  return true;
};

3. 补充：Badge计数重置逻辑 #

别忘了给用户提供清除Badge的入口，比如进入APP主页时自动重置：

async resetBadge() {
  await this.badge.clear();
}

4. Android系统额外配置 #

有些国产ROM（小米、华为等）需要单独配置才能显示Badge，还要在AndroidManifest.xml里加必要权限：

<uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" />
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

另外首次启动APP时，可以引导用户开启系统设置里的Badge权限，避免部分机型不显示。

几个注意点 #

• 不需要依赖FCM消息payload里的badge字段，我们完全通过插件自己维护计数，灵活性更高；
• 测试时一定要覆盖前台、后台、APP被杀死三种场景，确保每种情况都能触发Badge更新；
• 如果用的是旧版Cordova的FCM插件（比如cordova-plugin-fcm-with-dependecy-updated），监听事件的方式会变成this.fcm.onNotification().subscribe()，逻辑是一样的。

这套流程我在好几个Ionic项目里都用过，亲测有效！

内容的提问来源于stack exchange，提问作者AppFirl