[[184821]]

– 簡(jiǎn)書作者 謝恩銘 轉(zhuǎn)載請(qǐng)注明出處

需求簡(jiǎn)介

角標(biāo)是什么意思呢?

看下圖即可明了：   

可以看到圖中的樂購(gòu)這個(gè)app右上角的紅色的圓圈，里面有10這個(gè)數(shù)字的，就是一種角標(biāo)。

角標(biāo)，英語(yǔ)是badge，也就是“徽章，像章，獎(jiǎng)?wù)? 象征，標(biāo)記”的意思。

一般來(lái)說，應(yīng)用的角標(biāo)是用來(lái)標(biāo)記有多少條提醒(Notification)沒讀(unread)，一旦點(diǎn)擊提示進(jìn)應(yīng)用閱讀了，角標(biāo)也會(huì)消失。

Android角標(biāo)起源

角標(biāo)原本是蘋果的iOS中的東西，Android原生并不支持角標(biāo)，因?yàn)镚oogle的意思是讓大家用Notification(提示欄)即可，角標(biāo)實(shí)在大有讓處女座“跳崖”的風(fēng)險(xiǎn)。幸好我不是…

最近公司的項(xiàng)目中，客戶的一個(gè)新需求是在我們的加密信息應(yīng)用上加上角標(biāo)功能，因?yàn)槲覀兊暮献骰锇槭侨?可以參看我的這篇文章：程序員在法國(guó) | 我被法國(guó)國(guó)防部盯上了!)，因此我就去網(wǎng)上找相關(guān)資料。

找的時(shí)候，才知道上面所說的Android原生不支持角標(biāo)一事。不過無(wú)妨，厲害的Android第三方廠商可以通過在自定義的Launcher(啟動(dòng)器)中操作來(lái)實(shí)現(xiàn)添加角標(biāo)。

我在第一時(shí)間當(dāng)然是去找三星的移動(dòng)設(shè)備如何添加角標(biāo)，不過卻有幸找到了Github上的比較普適的項(xiàng)目。

把我導(dǎo)向Github的自然是Stack Overflow，而把我導(dǎo)向Stack Overflow的就是Google，因此我會(huì)說：為什么程序員一定要會(huì)用Google和Stack Overflow? 。

不錯(cuò)的github項(xiàng)目

1. 一般來(lái)說，現(xiàn)在被引用最多的Android添加和去除角標(biāo)的Github項(xiàng)目是這位中國(guó)人寫的：https://github.com/leolin310148/ShortcutBadger這個(gè)項(xiàng)目挺不錯(cuò)，雖然更新不是特別勤快，但最近一次更新是在2016年10月31日，也就是兩個(gè)月前，還可以接受。
2. 《Android群英傳》和《Android群英傳：神兵利器》的作者 徐宣生 也在自己的Github上建了一個(gè)項(xiàng)目：https://github.com/xuyisheng/ShortcutHelper ，挺有意思，里面還有號(hào)稱“瘋狂模式”的為所有在手機(jī)桌面上的應(yīng)用加上99的角標(biāo)數(shù)的功能，當(dāng)然了，去除的代碼也有，不然處女座豈不是要暈了～

添加角標(biāo)的原理就是發(fā)送一個(gè)Broadcast(廣播)，在廣播的Intent中指定需要被添加角標(biāo)的應(yīng)用的packageName(包名)，className(類名)，count(角標(biāo)數(shù)目)。當(dāng)然了，不同廠商的手機(jī)的角標(biāo)操作的Intent的action是不一樣的。

因此，我們?nèi)绻o自己的手機(jī)里的應(yīng)用添加角標(biāo)，只需要簡(jiǎn)單的利用上面兩個(gè)項(xiàng)目中的代碼即可，一般不需要把全部項(xiàng)目搬過來(lái)。當(dāng)然了，如果你要適配所有手機(jī)，那么可以全盤引用項(xiàng)目。

比如我要給三星的手機(jī)的應(yīng)用添加角標(biāo)，那么我只需要做以下的幾步即可：

在AndroidManifest.xml中添加讀取和寫入角標(biāo)的權(quán)限：

<uses-permission android:name="com.sec.android.provider.badge.permission.READ" /> 
<uses-permission android:name="com.sec.android.provider.badge.permission.WRITE" />  

自己寫一個(gè)類，隨便取名字，比如叫做 BadgeUtils，在類中添加如下內(nèi)容：

public class BadgeUtils { 
  private static final String INTENT_ACTION = "android.intent.action.BADGE_COUNT_UPDATE"; 
  private static final String INTENT_EXTRA_BADGE_COUNT = "badge_count"; 
  private static final String INTENT_EXTRA_PACKAGENAME = "badge_count_package_name"; 
  private static final String INTENT_EXTRA_ACTIVITY_NAME = "badge_count_class_name"; 
 
  public static void setBadgeCount(Context context, ComponentName componentName, int badgeCount) { 
    Intent intent = new Intent(INTENT_ACTION);      
    intent.putExtra(INTENT_EXTRA_BADGE_COUNT, badgeCount);     
    intent.putExtra(INTENT_EXTRA_PACKAGENAME, componentName.getPackageName());     
    intent.putExtra(INTENT_EXTRA_ACTIVITY_NAME, componentName.getClassName()); 
    context.sendBroadcast(intent);   
  } 
}  

使用上面的代碼時(shí)，只需要傳入三個(gè)參數(shù)，也就是：

1. Context ： 應(yīng)用的Context。簡(jiǎn)單。
2. ComponentName ：組件名，略有點(diǎn)麻煩?？梢赃@樣來(lái)獲取(applicationContext就是應(yīng)用的Context) ：

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

3. badgeCount ：角標(biāo)的數(shù)目，例如10。簡(jiǎn)單。

當(dāng)然了，如果你不想要傳入三個(gè)參數(shù)這么麻煩，你也可以再寫一個(gè)方法getLauncherClassName，就只需要傳入兩個(gè)參數(shù)即可。BadgeUtils中的代碼變?yōu)椋?nbsp;

public class BadgeUtils { 
  private static final String INTENT_ACTION = "android.intent.action.BADGE_COUNT_UPDATE"; 
  private static final String INTENT_EXTRA_BADGE_COUNT = "badge_count"; 
  private static final String INTENT_EXTRA_PACKAGENAME = "badge_count_package_name"; 
  private static final String INTENT_EXTRA_ACTIVITY_NAME = "badge_count_class_name"; 
 
  public static void setBadgeCount(Context context, int badgeCount) { 
    String launcherClassName = getLauncherClassName(context); 
    if (launcherClassName == null) { 
      return; 
    } 
 
    Intent intent = new Intent(INTENT_ACTION);      
    intent.putExtra(INTENT_EXTRA_BADGE_COUNT, badgeCount);     
    intent.putExtra(INTENT_EXTRA_PACKAGENAME, context.getPackageName());     
    intent.putExtra(INTENT_EXTRA_ACTIVITY_NAME, launcherClassName); 
 
    context.sendBroadcast(intent);   
  } 
 
  private static String getLauncherClassName(Context context) { 
    PackageManager pm = context.getPackageManager(); 
 
    Intent intent = new Intent(Intent.ACTION_MAIN);  
    intent.addCategory(Intent.CATEGORY_LAUNCHER); 
 
    List<ResolveInfo> resolveInfos = pm.queryIntentActivities(intent, 0); 
    for (ResolveInfo resolveInfo : resolveInfos) { 
      String pkgName = resolveInfo.activityInfo.applicationInfo.packageName; 
      if (pkgName.equalsIgnoreCase(context.getPackageName())) { 
        String className = resolveInfo.activityInfo.name; 
        return className; 
      } 
    } 
    return null;  
  } 
}  

使用時(shí)傳入兩個(gè)參數(shù)即可：

1. Context ： 應(yīng)用的Context。
2. badgeCount ：角標(biāo)的數(shù)目，例如10。

清除角標(biāo)

要清除應(yīng)用的角標(biāo)就很簡(jiǎn)單了，給badgeCount傳入0即可。

BadgeUtils.setBadgeCount(context,        
context.getPackageManager()                
.getLaunchIntentForPackage(context.getPackageName())                 
.getComponent(),         
0);  

或者

BadgeUtils.setBadgeCount(context, 0); 

小問題糾錯(cuò)

上面的 https://github.com/leolin310148/ShortcutBadger 這個(gè)項(xiàng)目中，基本已經(jīng)包含了大多數(shù)可以定制角標(biāo)的Android生產(chǎn)廠商的添加角標(biāo)的代碼實(shí)現(xiàn)，不過它也提到：

三星和LG(這兩個(gè)難兄難弟)的代碼有很多類似，連角標(biāo)處理的廣播的Intent中的action也是一樣的，都是：

"android.intent.action.BADGE_COUNT_UPDATE" 

但是作者在三星和LG的兩個(gè)角標(biāo)操作實(shí)現(xiàn)類中寫了注釋：

// Deprecated, Samsung devices will use DefaultBadger 
// Deprecated, LG devices will use DefaultBadger  

意思是“三星和LG的實(shí)現(xiàn)代碼已經(jīng)Deprecated(失效了)，請(qǐng)用DefaultBadger類”。

因此，這兩個(gè)需要用 https://github.com/leolin310148/ShortcutBadger/blob/master/ShortcutBadger/src/main/java/me/leolin/shortcutbadger/impl/DefaultBadger.java 中的實(shí)現(xiàn)：

private static final String INTENT_ACTION = "android.intent.action.BADGE_COUNT_UPDATE"; 
private static final String INTENT_EXTRA_BADGE_COUNT = "badge_count"; 
private static final String INTENT_EXTRA_PACKAGENAME = "badge_count_package_name"; 
private static final String INTENT_EXTRA_ACTIVITY_NAME = "badge_count_class_name"; 
 
@Override 
public void executeBadge(Context context, ComponentName componentName, int badgeCount) throws ShortcutBadgeException { 
  Intent intent = new Intent(INTENT_ACTION); 
  intent.putExtra(INTENT_EXTRA_BADGE_COUNT, badgeCount); 
  intent.putExtra(INTENT_EXTRA_PACKAGENAME, componentName.getPackageName()); 
  intent.putExtra(INTENT_EXTRA_ACTIVITY_NAME, componentName.getClassName()); 
 
  if (BroadcastHelper.canResolveBroadcast(context, intent)) { 
    context.sendBroadcast(intent); 
  } else { 
    throw new ShortcutBadgeException("unable to resolve intent: " + intent.toString()); 
  } 
}  

不過上面的代碼有一個(gè)小問題，就是那句

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

在有些設(shè)備(比如Samsung Galaxy S5)上會(huì)拋出異常(Exception)，找不到處理”android.intent.action.BADGE_COUNT_UPDATE”這個(gè)Intent的BroadcastReceiver，很奇怪。

但有些設(shè)備(比如Samsung Galaxy A5)上又運(yùn)行正常，沒有拋出異常。

解決辦法是去除這一個(gè)檢測(cè)，把

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

替換為簡(jiǎn)單的

context.sendBroadcast(intent); 

就可以了。

也就是我上面自己實(shí)作時(shí)的代碼。

總結(jié)

1. Android的角標(biāo)添加和移除畢竟是基于各大手機(jī)廠商的Launcher的定制，因此不是正統(tǒng)的Android技巧，隨著廠商的Launcher的改變，也許你的代碼未來(lái)就不一定有用了，因此需要不斷修改，“推陳出新”。
2. 不過正所謂“生命在于折騰”，而這也是我們喜歡Android系統(tǒng)的原因。這個(gè)萌萌的機(jī)器人可以經(jīng)得起我們隨意折騰，在嵌入式領(lǐng)域的應(yīng)用前途也是很不錯(cuò)的。
3. 大家在平時(shí)學(xué)習(xí)編程的時(shí)候，也可以把自己的代碼或經(jīng)驗(yàn)匯總到Github項(xiàng)目，一來(lái)惠己利人，二來(lái)提高自己的業(yè)界知名度。

• Git，Github和Gitlab簡(jiǎn)介和基本使用
• Github | 如何貢獻(xiàn)Android開源項(xiàng)目和提交補(bǔ)丁
• Github改版+我的Github打怪升級(jí)之路