Kotlin实现桌面启动器图标角标数字及全设备适配方法

无法全设备生效的核心原因 #

• Android原生系统未提供公开标准的角标控制API，所有角标能力都是各设备厂商、第三方桌面启动器在ROM/应用层自定义实现的，不同厂商的调用逻辑、权限要求差异极大
• 各厂商ROM版本迭代时会频繁修改角标相关的API规则、权限策略，旧的调用逻辑很容易在新系统版本上失效
• 绝大多数系统默认不会给第三方应用开放角标显示权限，就算调用逻辑正确，没有权限也无法正常显示角标

适配解决方案 #

1. 优先适配官方标准通知角标（Android 8.0+） #

Android 8.0之后推出了原生通知点功能，支持该特性的桌面会自动根据应用通知的数量显示角标，无需额外申请特殊权限：

// 构造通知时设置角标数字即可
val notification = Notification.Builder(context, YOUR_CHANNEL_ID)
    .setContentTitle("新消息提醒")
    .setContentText("你有未读消息")
    .setSmallIcon(R.drawable.ic_notification)
    .setNumber(unreadCount) // 绑定角标数字
    .build()
// 发送通知后系统会自动更新桌面角标
notificationManager.notify(notificationId, notification)

注意需要将通知渠道的优先级设置为IMPORTANCE_DEFAULT及以上，否则不会触发角标更新。

2. 分厂商适配私有API #

针对国内主流厂商的定制ROM单独做适配，需要先申请对应厂商的角标权限，再调用对应私有接口：

• 小米：先申请「桌面角标」权限，调用MIUI扩展的NotificationManager接口更新角标，注意MIUI12及以上版本权限申请逻辑有变更
• 华为：在AndroidManifest.xml中声明com.huawei.android.launcher.permission.CHANGE_BADGE权限，通过ContentResolver更新角标数据
• OPPO/vivo：先申请应用角标权限，调用厂商提供的BadgeManager相关接口更新角标

3. 兜底引导方案 #

如果API调用后仍不显示，可在应用内增加权限引导页，根据用户设备品牌跳转到对应系统设置的角标开关页，引导用户手动开启权限。

4. 复用开源适配库 #

可以直接使用已经封装了主流厂商适配逻辑的开源库，大幅降低适配成本：

// 一行代码更新角标，库内部会自动适配当前设备的实现逻辑
ShortcutBadger.applyCount(context, unreadCount)

注意需要自行补充库未覆盖的小众厂商、新ROM版本的适配逻辑。

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