项目开发中遇到此需求了,因此在此处记录一下。
Android UI Libs之ShortcutBadger
1. 说明
ShortcutBadger与android-viewbadger类似,都是加上“徽章”,ShortcutBadger是给app快捷luanch添加数字“徽章”,android-viewbadger是给视图添加文本“徽章”。ShortcutBadger常用来在app快捷luanch上显示未读的消息的个数。
2.支持的机型
3.配置
首先在工程的build.gradle上面添加mavenCentral仓库
allprojects {repositories { ...
mavenCentral()
}
}
其次,在模块的build.gradle上面添加依赖
dependencies {
compile 'me.leolin:ShortcutBadger:1.1.19@aar'
}
3.使用方法
1.向app的luanch快捷添加数字“徽章”
(方法1.)int badgeCount = 1; ShortcutBadger.applyCount(context, badgeCount); //1.1.4版本添加数字“徽章”的方法
(方法2.)ShortcutBadger.with(getApplicationContext()).count(badgeCount); //1.1.3版本添加数字“徽章”的方法
2.删除app的luanch快捷上的数字“徽章”
(方法1.)ShortcutBadger.removeCount(context); //1.1.4版本删除数字“徽章”的方法
(方法2.)ShortcutBadger.with(getApplicationContext()).remove(); //1.1.3版本删除数字“徽章”的方法
4.项目中具体应用
1.)在应用中的Application类的onCreate()方法里调用这两个方法:
umMessageHandler();
registerActivityLifecycleCallbacks(new AppActivityLifecycleCallbacks());
注:registerActivityLifecycleCallbacks()此方法的具体应用详解见点击打开链接 http://blog.csdn.net/tongcpp/article/details/40344871
2.)因为项目中集成了友盟的推送,所以在这个自定义的通知栏里调用一下ShortcutBadger.applyCount()方法设置未读消息数
/** * 友盟自定义通知栏样式 */ private void umMessageHandler() { UmengMessageHandler messageHandler = new UmengMessageHandler() { @Override public Notification getNotification(Context context, UMessage msg) { LoggerUtil.debug(TAG, "getNotification"); ShortcutBadger.applyCount(context, 1); return super.getNotification(context, msg); } }; mPushAgent.setMessageHandler(messageHandler); }
/** * 友盟自定义通知栏样式 */ private void umMessageHandler() { UmengMessageHandler messageHandler = new UmengMessageHandler() { @Override public Notification getNotification(Context context, UMessage msg) { LoggerUtil.debug(TAG, "getNotification"); ShortcutBadger.applyCount(context, 1); return super.getNotification(context, msg); } }; mPushAgent.setMessageHandler(messageHandler); }
3.)AppActivityLifecycleCallbacks类的具体实现
/**
* Created by 2017/11/24.
* Android给launch图标添加未读消息通知
*/
public class AppActivityLifecycleCallbacks implements Application.ActivityLifecycleCallbacks{
@Override
public void onActivityCreated(Activity activity, Bundle savedInstanceState) {
}
@Override
public void onActivityStarted(Activity activity) {
}
@Override
public void onActivityResumed(Activity activity) {
ShortcutBadger.applyCount(activity, 0);
}
@Override
public void onActivityPaused(Activity activity) {
}
@Override
public void onActivityStopped(Activity activity) {
}
@Override
public void onActivitySaveInstanceState(Activity activity, Bundle outState) {
}
@Override
public void onActivityDestroyed(Activity activity) {
}
}