1. 程式人生 > 實用技巧 >Android探索之旅 | 為應用新增角標

Android探索之旅 | 為應用新增角標

內容簡介


  1. 需求簡介
  2. Android角標起源
  3. 不錯的Github專案
  4. 清除角標
  5. 小問題糾錯
  6. 總結

1.需求簡介


角標是什麼意思呢?

看下圖即可明瞭:

可以看到圖中的樂購這個app右上角的紅色的圓圈,裡面有10這個數字的,就是一種角標。

角標,英語是badge,也就是“徽章,像章,獎章; 象徵,標記”的意思。

一般來說,應用的角標是用來標記有多少條提醒(Notification)沒讀(unread),一旦點選提示進應用閱讀了,角標也會消失。

2. Android角標起源


角標原本是蘋果的iOS中的東西,Android原生並不支援角標,因為Google的意思是讓大家用Notification(提示欄)即可,角標實在大有讓處女座“跳崖”的風險。幸好我不是...

最近公司的專案中,客戶的一個新需求是在我們的加密資訊應用上加上角標功能,因為我們的合作伙伴是三星(可以參看我的這篇文章:程式設計師在法國 | 我被法國國防部盯上了!),因此我就去網上找相關資料。

找的時候,才知道上面所說的Android原生不支援角標一事。不過無妨,厲害的Android第三方廠商可以通過在自定義的Launcher(啟動器)中操作來實現新增角標。

我在第一時間當然是去找三星的移動裝置如何新增角標,不過卻有幸找到了Github上的比較普適的專案。

把我導向Github的自然是Stack Overflow,而把我導向Stack Overflow的就是Google,因此我會說:為什麼程式設計師一定要會用Google和Stack Overflow?

3. 不錯的Github專案


  • 一般來說,現在被引用最多的Android新增和去除角標的Github專案是這位中國人寫的:https://github.com/leolin310148/ShortcutBadger

    這個專案挺不錯,雖然更新不是特別勤快,但最近一次更新是在2016年10月31日,也就是兩個月前,還可以接受。

  • 《Android群英傳》和《Android群英傳:神兵利器》的作者 徐宜生 也在自己的Github上建了一個專案:https://github.com/xuyisheng/ShortcutHelper,挺有意思,裡面還有號稱“瘋狂模式”的為所有在手機桌面上的應用加上99的角標數的功能,當然了,去除的程式碼也有,不然處女座豈不是要暈了~

新增角標的原理就是傳送一個Broadcast(廣播),在廣播的Intent中指定需要被新增角標的應用的packageName(包名),className(類名),count(角標數目)。當然了,不同廠商的手機的角標操作的Intent的action是不一樣的。

因此,我們如果要給自己的手機裡的應用新增角標,只需要簡單的利用上面兩個專案中的程式碼即可,一般不需要把全部專案搬過來。當然了,如果你要適配所有手機,那麼可以全盤引用專案。

比如我要給三星的手機的應用新增角標,那麼我只需要做以下的幾步即可:

  • 在AndroidManifest.xml中新增讀取和寫入角標的許可權:

  1. <uses-permission android:name="com.sec.android.provider.badge.permission.READ" />
  2. <uses-permission android:name="com.sec.android.provider.badge.permission.WRITE" />
  • 自己寫一個類,隨便取名字,比如叫做 BadgeUtils,在類中新增如下內容:

  1. public class BadgeUtils {
  2. private static final String INTENT_ACTION = "android.intent.action.BADGE_COUNT_UPDATE";
  3. private static final String INTENT_EXTRA_BADGE_COUNT = "badge_count";
  4. private static final String INTENT_EXTRA_PACKAGENAME = "badge_count_package_name";
  5. private static final String INTENT_EXTRA_ACTIVITY_NAME = "badge_count_class_name";
  6. public static void setBadgeCount(Context context, ComponentName componentName, int badgeCount) {
  7. Intent intent = new Intent(INTENT_ACTION);
  8. intent.putExtra(INTENT_EXTRA_BADGE_COUNT, badgeCount);
  9. intent.putExtra(INTENT_EXTRA_PACKAGENAME, componentName.getPackageName());
  10. intent.putExtra(INTENT_EXTRA_ACTIVITY_NAME, componentName.getClassName());
  11. context.sendBroadcast(intent);
  12. }
  13. }
  • 使用上面的程式碼時,只需要傳入三個引數,也就是:

    1. Context : 應用的Context。簡單。
    2. ComponentName :元件名,略有點麻煩。可以這樣來獲取(applicationContext就是應用的Context) :

applicationContext.getPackageManager()
.getLaunchIntentForPackage(applicationContext.getPackageName())
.getComponent()
```

  1. badgeCount :角標的數目,例如10。簡單。

當然了,如果你不想要傳入三個引數這麼麻煩,你也可以再寫一個方法getLauncherClassName,就只需要傳入兩個引數即可。BadgeUtils中的程式碼變為:

  1. public class BadgeUtils {
  2. private static final String INTENT_ACTION = "android.intent.action.BADGE_COUNT_UPDATE";
  3. private static final String INTENT_EXTRA_BADGE_COUNT = "badge_count";
  4. private static final String INTENT_EXTRA_PACKAGENAME = "badge_count_package_name";
  5. private static final String INTENT_EXTRA_ACTIVITY_NAME = "badge_count_class_name";
  6. public static void setBadgeCount(Context context, int badgeCount) {
  7. String launcherClassName = getLauncherClassName(context);
  8. if (launcherClassName == null) {
  9. return;
  10. }
  11. Intent intent = new Intent(INTENT_ACTION);
  12. intent.putExtra(INTENT_EXTRA_BADGE_COUNT, badgeCount);
  13. intent.putExtra(INTENT_EXTRA_PACKAGENAME, context.getPackageName());
  14. intent.putExtra(INTENT_EXTRA_ACTIVITY_NAME, launcherClassName);
  15. context.sendBroadcast(intent);
  16. }
  17. private static String getLauncherClassName(Context context) {
  18. PackageManager pm = context.getPackageManager();
  19. Intent intent = new Intent(Intent.ACTION_MAIN);
  20. intent.addCategory(Intent.CATEGORY_LAUNCHER);
  21. List<ResolveInfo> resolveInfos = pm.queryIntentActivities(intent, 0);
  22. for (ResolveInfo resolveInfo : resolveInfos) {
  23. String pkgName = resolveInfo.activityInfo.applicationInfo.packageName;
  24. if (pkgName.equalsIgnoreCase(context.getPackageName())) {
  25. String className = resolveInfo.activityInfo.name;
  26. return className;
  27. }
  28. }
  29. return null;
  30. }
  31. }

使用時傳入兩個引數即可:

  1. Context : 應用的Context。
  2. badgeCount :角標的數目,例如10。

4. 清除角標


要清除應用的角標就很簡單了,給badgeCount傳入0即可。

  1. BadgeUtils.setBadgeCount(context,
  2. context.getPackageManager()
  3. .getLaunchIntentForPackage(context.getPackageName())
  4. .getComponent(),
  5. 0);

或者

BadgeUtils.setBadgeCount(context, 0);

5. 小問題糾錯


上面的https://github.com/leolin310148/ShortcutBadger這個專案中,基本已經包含了大多數可以定製角標的Android生產廠商的新增角標的程式碼實現,不過它也提到:

三星和LG(這兩個難兄難弟)的程式碼有很多類似,連角標處理的廣播的Intent中的action也是一樣的,都是:

"android.intent.action.BADGE_COUNT_UPDATE"

但是作者在三星和LG的兩個角標操作實現類中寫了註釋:

  1. // Deprecated, Samsung devices will use DefaultBadger
  2. // Deprecated, LG devices will use DefaultBadger

意思是“三星和LG的實現程式碼已經Deprecated(失效了),請用DefaultBadger類”。

因此,這兩個需要用https://github.com/leolin310148/ShortcutBadger/blob/master/ShortcutBadger/src/main/java/me/leolin/shortcutbadger/impl/DefaultBadger.java中的實現:

  1. private static final String INTENT_ACTION = "android.intent.action.BADGE_COUNT_UPDATE";
  2. private static final String INTENT_EXTRA_BADGE_COUNT = "badge_count";
  3. private static final String INTENT_EXTRA_PACKAGENAME = "badge_count_package_name";
  4. private static final String INTENT_EXTRA_ACTIVITY_NAME = "badge_count_class_name";
  5. @Override
  6. public void executeBadge(Context context, ComponentName componentName, int badgeCount) throws ShortcutBadgeException {
  7. Intent intent = new Intent(INTENT_ACTION);
  8. intent.putExtra(INTENT_EXTRA_BADGE_COUNT, badgeCount);
  9. intent.putExtra(INTENT_EXTRA_PACKAGENAME, componentName.getPackageName());
  10. intent.putExtra(INTENT_EXTRA_ACTIVITY_NAME, componentName.getClassName());
  11. if (BroadcastHelper.canResolveBroadcast(context, intent)) {
  12. context.sendBroadcast(intent);
  13. } else {
  14. throw new ShortcutBadgeException("unable to resolve intent: " + intent.toString());
  15. }
  16. }

不過上面的程式碼有一個小問題,就是那句

 if (BroadcastHelper.canResolveBroadcast(context, intent)) {

在有些裝置(比如Samsung Galaxy S5)上會丟擲異常(Exception),找不到處理"android.intent.action.BADGE_COUNT_UPDATE"這個Intent的BroadcastReceiver,很奇怪。

但有些裝置(比如Samsung Galaxy A5)上又執行正常,沒有丟擲異常。

解決辦法是去除這一個檢測,把

  1. if (BroadcastHelper.canResolveBroadcast(context, intent)) {
  2. context.sendBroadcast(intent);
  3. } else {
  4. throw new ShortcutBadgeException("unable to resolve intent: " + intent.toString());
  5. }

替換為簡單的

context.sendBroadcast(intent);

就可以了。

也就是我上面自己實作時的程式碼。

6. 總結


  1. Android的角標新增和移除畢竟是基於各大手機廠商的Launcher的定製,因此不是正統的Android技巧,隨著廠商的Launcher的改變,也許你的程式碼未來就不一定有用了,因此需要不斷修改,“推陳出新”。

  2. 不過正所謂“生命在於折騰”,而這也是我們喜歡Android系統的原因。這個萌萌的機器人可以經得起我們隨意折騰,在嵌入式領域的應用前途也是很不錯的。

  3. 大家在平時學習程式設計的時候,也可以把自己的程式碼或經驗彙總到Github專案,一來惠己利人,二來提高自己的業界知名度。

現在都說網際網路寒冬,其實只要自身技術能力夠強,咱們就不怕!我這邊專門針對Android開發工程師整理了一套【Android進階學習視訊】、【全套Android面試祕籍】、【Android知識點PDF】。如有需要獲取資料文件的朋友,可以點選我的GitHub免費獲取!