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

本文作者

作者：孙强Jimmy

链接：

https://www.jianshu.com/p/2566fdebcae4

本文由作者授权发布。

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

GitHub地址：

https://github.com/jimmysuncpt/AppBadge

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

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发送的通知数对应的，即向通知栏发送了多少通知就会显示多少角标。

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

我们发送了两条通知，一条通知为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/console/doc/detail?pId=939

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

3OPPO（不支持）

旧款的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) 国内外邮件类应用（各区域各属于用户量第一梯队的应用）。

4vivo（不支持）

旧款的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;
    }
}

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

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;
    }
}

6 魅族（不支持）

官方不支持。

7 360（不支持）

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

8 锤子（不支持）

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

9 努比亚（不支持）

目前仅支持系统应用。

10 金立（不支持）

找不到相关文档。

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

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

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

13 中兴（不支持）

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

14HTC（支持）

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

实现代码：

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;
    }
}

15诺基亚（支持）

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

实现代码：

与小米实现代码相同。

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

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

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

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

实现代码：

与小米实现代码相同。

参考链接：

https://developer.android.com/training/notify-user/badges

最后推荐一下我做的网站，玩Android: wanandroid.com ，包含详尽的知识体系、好用的工具，还有本公众号文章合集，欢迎体验和收藏！

推荐阅读：

扫一扫 关注我的公众号

如果你想要跟大家分享你的文章，欢迎投稿~

┏(＾0＾)┛明天见！