Expo Managed模式下App未运行时Android通知角标数字不显示如何解决

核心前提 #

Android原生系统（AOSP）从8.0开始仅支持通知小圆点展示，数字角标是小米、华为、OPPO等厂商定制ROM的独有功能，没有统一的系统级API，和iOS的系统级角标逻辑完全不同。

后端携带badge参数是否生效 #

默认不生效。Expo通知模块不会主动读取全局badge参数适配Android端的角标设置，需要单独配置Android专属的推送参数和代码逻辑。

可用解决方案 #

方案1：Expo SDK 48+ 内置适配（无需prebuild） #

1. 首先配置app.json开启安卓角标权限

{
  "expo": {
    "plugins": [
      [
        "expo-notifications",
        {
          "androidShowBadge": true
        }
      ]
    ],
    "android": {
      "permissions": [
        "android.permission.POST_NOTIFICATIONS",
        // 按需添加主流厂商角标权限
        "com.huawei.android.launcher.permission.CHANGE_BADGE",
        "com.xiaomi.mipush.sdk.PushMessageReceiver",
        "com.oppo.launcher.permission.READ_SETTINGS",
        "com.oppo.launcher.permission.WRITE_SETTINGS"
      ]
    }
  }
}

2. 后端推送payload单独配置安卓角标参数

{
  "to": "用户Expo推送令牌",
  "badge": 5, // iOS端生效参数
  "notification": {
    "title": "通知标题",
    "body": "通知内容"
  },
  "android": {
    "channelId": "你的通知渠道ID",
    "badgeCount": 5 // SDK48+ 安卓端专属角标参数
  },
  "data": {
    "badgeCount": "5"
  }
}

3. 注册后台通知任务，适配App被杀死的场景

import * as Notifications from 'expo-notifications';
import * as TaskManager from 'expo-task-manager';

const BACKGROUND_NOTI_TASK = 'BACKGROUND_NOTI_TASK';

// 定义后台执行的任务，App被杀死时收到通知仍会触发
TaskManager.defineTask(BACKGROUND_NOTI_TASK, async ({ data }) => {
  if (!data) return;
  const count = parseInt(data.notification.data.badgeCount);
  await Notifications.setBadgeCountAsync(count);
});

// 注册后台通知接收任务
Notifications.registerTaskAsync(BACKGROUND_NOTI_TASK);

方案2：Bare Workflow 全机型适配 #

如果方案1无法覆盖你需要的ROM机型，执行expo prebuild切换为裸开发模式，引入第三方安卓角标适配库单独适配各家厂商的角标API即可。

常见坑点说明 #

• 部分厂商需要用户手动在系统通知设置中开启App的角标显示权限，代码无法强制开启
• 原生Android系统（如Pixel系列）本身不支持数字角标，仅能显示小圆点，属于系统限制无法突破
• 部分ROM需要将App加入自启动、后台活动白名单才允许后台修改角标

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