更新记录

1.0.1（2026-09-04）

1、优化小米角标;

1.0.0（2025-12-30）

1、安卓、iOS、鸿蒙NEXT;

平台兼容性

uni-app(4.87)

uni-app x(4.87)

xl-appBadge

用于设置和清除应用桌面角标数量的 UTS 插件，支持 uni-app、uni-app x 的 Android、iOS 和鸿蒙 Next App。

特性

• 通过统一 API 设置或清除应用角标；
• 支持 Android、iOS 和鸿蒙 Next App；
• 业务页面无需重复编写各平台的角标适配代码；
• 角标最终效果由手机系统、桌面启动器和用户设置决定。

安装

将 xl-appBadge 放到项目的 uni_modules 目录，在页面或业务逻辑中导入：

import {
  setBadge,
  removeBadge
} from '@/uni_modules/xl-appBadge'

API

setBadge(count)

设置桌面角标数量。参数会转换为整数，负数按 0 处理。

setBadge(10)

removeBadge()

清除桌面角标。

removeBadge()

Vue 页面示例

<script>
import {
  setBadge as setAppBadge,
  removeBadge as removeAppBadge
} from '@/uni_modules/xl-appBadge'

export default {
  methods: {
    setUnreadCount() {
      setAppBadge(10)
    },
    clearUnreadCount() {
      removeAppBadge()
    }
  }
}
</script>

业务页面不需要额外调用 Android 系统权限 API。Android 13 及以上首次设置正数角标时，插件会自动请求通知权限，请根据系统提示允许应用通知。

平台支持

Android 桌面角标不是所有启动器都支持，具体显示形式可能是数字或小红点。

小米、Redmi、POCO 设备

请在系统设置中确认以下选项已开启：

1. 应用通知；
2. 应用图标角标/桌面图标角标；
3. 系统通知设置中的数字角标。

Android 13 及以上首次设置正数角标时，系统可能会请求通知权限。如果用户拒绝，需要到应用通知设置中手动重新开启。

设置角标后请按 Home 键回到桌面查看。用户关闭通知、关闭角标权限或清除相关通知后，系统可能不会继续显示角标。

常见问题

调用成功但桌面没有角标

• 确认应用通知权限已开启；
• 确认系统的应用图标角标开关已开启；
• 小米设备检查应用通知设置中的角标选项；
• 设置后返回桌面，不要只在应用前台观察；
• 确认运行的是重新编译安装后的最新版本。

为什么不同手机显示效果不一样？

角标属于系统桌面能力，不同厂商和启动器对数字上限、显示样式、通知权限和清除时机的处理可能不同，插件无法保证所有设备完全一致。

修改插件后为什么没有生效？

修改 UTS 代码后，请重新运行 Android 自定义基座或重新打包安装，避免继续使用旧的编译缓存或旧 APK。

开发文档

• UTS 语法
• UTS API 插件
• UTS uni-app 兼容模式组件
• UTS 标准模式组件
• 小米澎湃 OS 桌面角标说明