更新记录

1.0.0（2026-03-20）

• 应用角标设置与清空
• 通知联动角标
• 通知权限申请
• 设备支持诊断

平台兼容性

uni-app(4.75)

uni-app x(4.75)

austin-app-badge

点击“试用插件”包含直接运行的模板页，快速体验

统一的 Android/iOS 应用角标与未读数插件，支持：

• 应用角标设置与清空
• 通知联动角标
• 通知权限申请
• 设备支持诊断

平台说明

iOS

• 支持原生应用角标
• 需要通知权限，未授权时角标可能无法稳定生效
• 支持通过本地通知联动 badge

Android

• 华为/Honor：支持厂商角标兼容，也建议同时测试通知联动
• vivo：支持厂商角标兼容，也建议同时测试通知联动
• 小米/Redmi：更适合通过通知联动触发角标
• 通用 Android：更适合通过通知联动触发红点或角标
• OPPO/ColorOS：数字角标通常需要官方申请能力，本地通知或常见兼容接口不承诺生效

关于 OPPO/ColorOS

本插件已经补充了通知联动、设备诊断和调试日志，但在 OPPO 设备上：

• 通知发出成功，不等于桌面一定显示角标
• 即使系统通知权限、通知渠道、桌面启动器识别都正常，也可能没有红点或数字角标
• 如果业务必须支持 OPPO 数字角标，应按 OPPO 官方能力要求评估接入。

  测试建议

1. 先调用 getBadgeSupportInfo() 查看当前设备建议策略
2. Android 13+ 先申请通知权限
3. 华为/Honor、vivo 先测 setBadgeCount
4. 通用 Android、小米优先测 syncBadgeWithNotification
5. OPPO/ColorOS 重点看官方能力要求，不要只以本地通知结果判断插件失败

最小调用

import { setBadgeCount, syncBadgeWithNotification } from '@/uni_modules/austin-app-badge'

setBadgeCount({
  count: 9,
  autoCreateNotification: false
})

syncBadgeWithNotification({
  count: 3,
  title: '你有新的未读消息',
  content: '请及时查看最新提醒和待办。'
})