史上最全 Android 应用角标适配方法

喜欢ヅ旅行 2022-04-11 08:16 1892阅读 0赞

Android 8.0之前原生是不支持应用角标的，是各个手机厂商自己在系统中实现的应用角标，并且部分厂商提供了设置的方式，所以需要对各个厂商的系统进行适配。

**GitHub地址**：[https://github.com/jimmysuncpt/AppBadge][https_github.com_jimmysuncpt_AppBadge]

下面是针对各个手机厂商的系统进行适配的原理。

**目录**

0 公用方法

1 小米（支持）

2 华为（支持）

3 OPPO（不支持）

4 vivo（不支持）

5 三星（支持）

6 魅族（不支持）

7 360（不支持）

8 锤子（不支持）

9 努比亚（不支持）

10 金立（不支持）

11 乐视（支持，无法自定义数目）

12 联想ZUK（支持）

13 中兴（不支持）

14 HTC（支持）

15 诺基亚（支持）

16 索尼（支持）

17 原生Android（部分支持，无法直接显示数目）

--------------------

## 0 公用方法 ##

在下面的实现代码中，有很多公用的代码，我们提取出来一些公用方法，代码如下：

private static String getLauncherClassName(Context context) {
            ComponentName launchComponent = getLauncherComponentName(context);
            if (launchComponent == null) {
                return "";
            } else {
                return launchComponent.getClassName();
            }
        }
     
        private static ComponentName getLauncherComponentName(Context context) {
            Intent launchIntent = context.getPackageManager().getLaunchIntentForPackage(context
                    .getPackageName());
            if (launchIntent != null) {
                return launchIntent.getComponent();
            } else {
                return null;
            }
        }

## 1 小米（支持） ##

小米在MIUI6及以上版本中是通过发送通知来设置角标的。当APP向通知栏发送了一条通知 （通知不带进度条并且用户可以删除的），那么桌面APP icon角标就会显示1。此时app显示的角标数是和通知栏里app发送的通知数对应的，即向通知栏发送了多少通知就会显示多少角标。

可以通过反射机制来定义每次通知的消息个数，应用的角标数为每条通知定义的通知个数的总和，如下图所示：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM1NDExNDA_size_16_color_FFFFFF_t_70][]

我们发送了两条通知，一条通知为5个消息，一条为10个消息，应用角标显示为15个。此时，如果用户点击或移除掉5条消息的那个通知，应用角标会变成10。

另外，仅在APP在后台时收到通知会显示角标，而APP在前台时不会显示，APP被杀掉后通知及角标消失。

**实现代码**：

public static boolean setNotificationBadge(int count, Context context) {
            NotificationManager notificationManager = (NotificationManager) context.getSystemService
                    (Context.NOTIFICATION_SERVICE);
            if (notificationManager == null) {
                return false;
            }
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
                // 8.0之后添加角标需要NotificationChannel
                NotificationChannel channel = new NotificationChannel("badge", "badge",
                        NotificationManager.IMPORTANCE_DEFAULT);
                channel.setShowBadge(true);
                notificationManager.createNotificationChannel(channel);
            }
            Intent intent = new Intent(context, MainActivity.class);
            PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);
            Notification notification = new NotificationCompat.Builder(context, "badge")
                    .setContentTitle("应用角标")
                    .setContentText("您有" + count + "条未读消息")
                    .setLargeIcon(BitmapFactory.decodeResource(context.getResources(), R.mipmap
                            .ic_launcher))
                    .setSmallIcon(R.mipmap.ic_launcher_round)
                    .setAutoCancel(true)
                    .setContentIntent(pendingIntent)
                    .setChannelId("badge")
                    .setNumber(count)
                    .setBadgeIconType(NotificationCompat.BADGE_ICON_SMALL).build();
            // 小米
            try {
                Field field = notification.getClass().getDeclaredField("extraNotification");
                Object extraNotification = field.get(notification);
                Method method = extraNotification.getClass().getDeclaredMethod("setMessageCount", int
                        .class);
                method.invoke(extraNotification, count);
            } catch (Exception e) {
                e.printStackTrace();
            }
            notificationManager.notify(notificationId++, notification);
            return true;
        }

**参考链接**：

[https://dev.mi.com/docs/appsmarket/technical\_docs/badge/][https_dev.mi.com_docs_appsmarket_technical_docs_badge]

[https://dev.mi.com/console/doc/detail?pId=939][https_dev.mi.com_console_doc_detail_pId_939]

**测试结果**：

小米6、小米5S、小米MIX、小米5X、小米4、红米Note 4X、小米2S均可通过通知的方式设置角标。

## 2 华为（支持） ##

可以通过ContentResolver方法直接设置应用角标，且应用在前台和被杀掉后仍可显示。

**实现代码**：

private static boolean setHuaweiBadge(int count, Context context) {
            try {
                String launchClassName = getLauncherClassName(context);
                if (TextUtils.isEmpty(launchClassName)) {
                    return false;
                }
                Bundle bundle = new Bundle();
                bundle.putString("package", context.getPackageName());
                bundle.putString("class", launchClassName);
                bundle.putInt("badgenumber", count);
                context.getContentResolver().call(Uri.parse("content://com.huawei.android.launcher" +
                        ".settings/badge/"), "change_badge", null, bundle);
                return true;
            } catch (Exception e) {
                e.printStackTrace();
                return false;
            }
        }

**参考链接**：

[https://developer.huawei.com/consumer/cn/devservice/doc/30802][https_developer.huawei.com_consumer_cn_devservice_doc_30802]

**测试结果**：

荣耀8、华为P10、华为Mate10、华为麦芒（MLA-AL00）均可直接设置。

## 3 OPPO（不支持） ##

旧款的OPPO手机有两种方法设置，没有测试机测试，不知道是否可行，实现代码如下：

private static boolean setOPPOBadge(int count, Context context) {
            try {
                Bundle extras = new Bundle();
                extras.putInt("app_badge_count", count);
                context.getContentResolver().call(Uri.parse("content://com.android.badge/badge"),
                        "setAppBadgeCount", String.valueOf(count), extras);
                return true;
            } catch (Exception e) {
                e.printStackTrace();
                return false;
            }
        }
        private static boolean setOPPOBadge2(int count, Context context) {
            try {
                Intent intent = new Intent("com.oppo.unsettledevent");
                intent.putExtra("packageName", context.getPackageName());
                intent.putExtra("number", count);
                intent.putExtra("upgradeNumber", count);
                PackageManager packageManager = context.getPackageManager();
                List<ResolveInfo> receivers = packageManager.queryBroadcastReceivers(intent, 0);
                if (receivers != null && receivers.size() > 0) {
                    context.sendBroadcast(intent);
                } else {
                    Bundle extras = new Bundle();
                    extras.putInt("app_badge_count", count);
                    context.getContentResolver().call(Uri.parse("content://com.android.badge/badge"),
                            "setAppBadgeCount", null, extras);
                }
                return true;
            } catch (Exception e) {
                e.printStackTrace();
                return false;
            }
        }

新款的OPPO仅支持内置应用、微信和QQ显示角标，若要使用角标功能，必须提交申请，审核通过了才能开放，官方给的具体审核标准如下：

申请角标接入规则（应用必须适配OPPO手机，保证角标功能测试通过）

a) 系统应用；

b) 国内外各区域用户量排名Top5的三方即时通讯类应用，且只允许显示即时通信消息类通知（如QQ、微信、facebook、line）；

c) OPPO公司内部费商业化及运营性质的办公类型即时通信应用（如Teamtalk）；

d) 国内外邮件类应用（各区域各属于用户量第一梯队的应用）。

## 4 vivo（不支持） ##

旧款的vivo手机实现代码：

private static boolean setVivoBadge(int count, Context context) {
            try {
                String launcherClassName = getLauncherClassName(context);
                if (TextUtils.isEmpty(launcherClassName)) {
                    return false;
                }
                Intent intent = new Intent("launcher.action.CHANGE_APPLICATION_NOTIFICATION_NUM");
                intent.putExtra("packageName", context.getPackageName());
                intent.putExtra("className", launcherClassName);
                intent.putExtra("notificationNum", count);
                context.sendBroadcast(intent);
                return true;
            } catch (Exception e) {
                e.printStackTrace();
                return false;
            }
        }

新款的手机也不可行了，如下图：

![20181205162142906.png][]

## 5 三星（支持） ##

可以通过广播机制直接设置应用角标，且应用在前台和被杀掉后仍可显示。

**实现代码**：

private static boolean setSamsungBadge(int count, Context context) {
            try {
                String launcherClassName = getLauncherClassName(context);
                if (TextUtils.isEmpty(launcherClassName)) {
                    return false;
                }
                Intent intent = new Intent("android.intent.action.BADGE_COUNT_UPDATE");
                intent.putExtra("badge_count", count);
                intent.putExtra("badge_count_package_name", context.getPackageName());
                intent.putExtra("badge_count_class_name", launcherClassName);
                context.sendBroadcast(intent);
                return true;
            } catch (Exception e) {
                e.printStackTrace();
                return false;
            }
        }

**测试结果**：

三星S9+：需和通知的方式结合才能显示角标。

三星 Galaxy S6 edge：可直接设置。

## 6 魅族（不支持） ##

官方不支持。

## 7 360（不支持） ##

目前可能仅支持系统应用、微信和QQ，不支持支付宝，未找到设置角标相关文档。

## 8 锤子（不支持） ##

目前仅支持系统应用和微信，甚至不支持QQ。

## 9 努比亚（不支持） ##

目前仅支持系统应用。

## 10 金立（不支持） ##

找不到相关文档。

## 11 乐视（支持，无法自定义数目） ##

仅支持通过通知设置角标，且角标数字为收到通知的条数，无法自定义角标数目。

**测试结果**：

乐2 Pro：可通过通知方式设置。

## 12 联想ZUK（支持） ##

**实现代码**：

private static boolean setZukBadge(int count, Context context) {
            try {
                Bundle extra = new Bundle();
                ArrayList<String> ids = new ArrayList<>();
                // 以列表形式传递快捷方式id，可以添加多个快捷方式id
    //        ids.add("custom_id_1");
    //        ids.add("custom_id_2");
                extra.putStringArrayList("app_shortcut_custom_id", ids);
                extra.putInt("app_badge_count", count);
                Uri contentUri = Uri.parse("content://com.android.badge/badge");
                Bundle bundle = context.getContentResolver().call(contentUri, "setAppBadgeCount", null,
                        extra);
                return bundle != null;
            } catch (Exception e) {
                e.printStackTrace();
                return false;
            }
        }

**参考链接**：

[http://developer.zuk.com/detail/12][http_developer.zuk.com_detail_12]

暂无测试机测试

## 13 中兴（不支持） ##

目前仅支持系统应用和微信，甚至不支持QQ。

## 14 HTC（支持） ##

可通过广播机制直接设置角标。

**实现代码**：

private static boolean setHTCBadge(int count, Context context) {
            try {
                ComponentName launcherComponentName = getLauncherComponentName(context);
                if (launcherComponentName == null) {
                    return false;
                }
     
                Intent intent1 = new Intent("com.htc.launcher.action.SET_NOTIFICATION");
                intent1.putExtra("com.htc.launcher.extra.COMPONENT", launcherComponentName
                        .flattenToShortString());
                intent1.putExtra("com.htc.launcher.extra.COUNT", count);
                context.sendBroadcast(intent1);
     
                Intent intent2 = new Intent("com.htc.launcher.action.UPDATE_SHORTCUT");
                intent2.putExtra("packagename", launcherComponentName.getPackageName());
                intent2.putExtra("count", count);
                context.sendBroadcast(intent2);
     
                return true;
            } catch (Exception e) {
                e.printStackTrace();
                return false;
            }
        }

**测试结果**：

HTC D820u、HTC M8St可直接设置

## 15 诺基亚（支持） ##

可通过通知设置角标数量，和小米类似，不同之处是只要通知栏的通知一直存在，数字就一直存在，且应用在前台仍可通过通知设置。

**实现代码**：

与小米实现代码相同。

**测试结果**：

诺基亚7：可通过通知设置。

## 16 索尼（支持） ##

**实现代码**：

private static boolean setSonyBadge(int count, Context context) {
            String launcherClassName = getLauncherClassName(context);
            if (TextUtils.isEmpty(launcherClassName)) {
                return false;
            }
            try {
                //官方给出方法
                ContentValues contentValues = new ContentValues();
                contentValues.put("badge_count", count);
                contentValues.put("package_name", context.getPackageName());
                contentValues.put("activity_name", launcherClassName);
                SonyAsyncQueryHandler asyncQueryHandler = new SonyAsyncQueryHandler(context
                        .getContentResolver());
                asyncQueryHandler.startInsert(0, null, Uri.parse("content://com.sonymobile.home" +
                        ".resourceprovider/badge"), contentValues);
                return true;
            } catch (Exception e) {
                try {
                    //网上大部分使用方法
                    Intent intent = new Intent("com.sonyericsson.home.action.UPDATE_BADGE");
                    intent.putExtra("com.sonyericsson.home.intent.extra.badge.SHOW_MESSAGE", count > 0);
                    intent.putExtra("com.sonyericsson.home.intent.extra.badge.ACTIVITY_NAME",
                            launcherClassName);
                    intent.putExtra("com.sonyericsson.home.intent.extra.badge.MESSAGE", String
                            .valueOf(count));
                    intent.putExtra("com.sonyericsson.home.intent.extra.badge.PACKAGE_NAME", context
                            .getPackageName());
                    context.sendBroadcast(intent);
                    return true;
                } catch (Exception e1) {
                    e1.printStackTrace();
                    return false;
                }
            }
        }
     
        static class SonyAsyncQueryHandler extends AsyncQueryHandler {
            SonyAsyncQueryHandler(ContentResolver cr) {
                super(cr);
            }
        }

**参考链接**：

[https://github.com/sonyxperiadev/home-badge][https_github.com_sonyxperiadev_home-badge]

暂无测试机测试

## 17 原生Android（部分支持，无法直接显示数目） ##

Android 8.0及之后的版本Google官方API支持通过发送系统通知的方式设置应用角标，但是不支持显示数量，而是一个小点儿，如下图所示。

![20181205162525514.png][]

在发送通知时可以设置消息数量，部分手机在长按图标时会显示所有通知设置的数量的总和。如上图所示，该示例中我们发送了两条通知，一条设置消息数量为88，一条为12，所以总和显示为100。

**实现代码**：

与小米实现代码相同。

**参考链接**：

[https://developer.android.com/training/notify-user/badges][https_developer.android.com_training_notify-user_badges]

**测试结果**：

Pixel 2 XL（Android 9.0）：支持通知设置。

Nexus 6P（Android 8.1.0）、Nexus 5X（Android 8.1.0）：不支持。

一加OnePlus3（Android 8.0.0）：支持通知设置，但是长按图标不会显示数量。

[https_github.com_jimmysuncpt_AppBadge]: https://github.com/jimmysuncpt/AppBadge
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM1NDExNDA_size_16_color_FFFFFF_t_70]: /images/20220411/4bc4c72588ab4d3780c658e8baab05eb.png
[https_dev.mi.com_docs_appsmarket_technical_docs_badge]: https://dev.mi.com/docs/appsmarket/technical_docs/badge/
[https_dev.mi.com_console_doc_detail_pId_939]: https://dev.mi.com/console/doc/detail?pId=939
[https_developer.huawei.com_consumer_cn_devservice_doc_30802]: https://developer.huawei.com/consumer/cn/devservice/doc/30802
[20181205162142906.png]: /images/20220411/91a0d02b293a4fc89bd540491795d4f5.png
[http_developer.zuk.com_detail_12]: http://developer.zuk.com/detail/12
[https_github.com_sonyxperiadev_home-badge]: https://github.com/sonyxperiadev/home-badge
[20181205162525514.png]: /images/20220411/5d8add23f5df408c804b8ea0f1bdc032.png
[https_developer.android.com_training_notify-user_badges]: https://developer.android.com/training/notify-user/badges