App Shortcuts 快捷方式 Android7.1 的"3D Touch"

Hello shortcuts

從Android7.1（API level25）開始，開發者可以爲自己的app定製shortcuts。shortcuts使用戶更便捷、快速的使用app。我個人感覺有點像ios的壓力感應，但是我認爲Google的shortcuts動畫做的更好看：）。

shortcuts分爲兩種：

1. Static shortcuts：靜態shortcuts是在資源文件中定義的，所以你只能通過升級你的app來更新靜態shortcuts的相關信息。

2. Dynamic shortcuts：動態shortcuts是通過ShortcutManager相關的API來實現運行時新增、修改、移除shortcuts的。

另外關於shortcuts有以下幾點小tips：

1. 最多可以設置5個快捷方式，（但經測試最多隻能顯示4個）。有些啓動器（launcher app）不會顯示出你添加的所有的快捷方式。

2. 用戶可以長按shortcuts將其固定到桌面，Google稱其爲“pinned shortcuts”，pinned shortcuts的數量是沒有限制的，並且開發者無權移除這些pinned shorcuts(只能用戶自己移除或者刪除app後自動移除，如果某個shortcuts已經被固定到桌面，即使動態刪除了該shortcuts，桌面的shortcuts也不會消失且可以正常使用)，但可以將其設爲不可用狀態（disbale）。

3. 雖然其他app無法通過shortcuts訪問你的app的元數據（metadata），但啓動器（laucher）可以，所以在使用shortcuts時要注意保護用戶的隱私信息。

靜態shortcuts（Static Shortcuts）的使用

1. 清單文件Manifest中在啓動頁添加meta-data

   <activity android:name=".MainActivity">
      <intent-filter>
          <action android:name="android.intent.action.MAIN"/>
          <category android:name="android.intent.category.LAUNCHER"/>
      </intent-filter>
      <meta-data android:name="android.app.shortcuts"
                 android:resource="@xml/shortcuts" />
   </activity>

2. res文件夾內新建文件夾xml，新建文件shortcuts.xml

   //shortcuts.xml
   
   <shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
   <shortcut
       android:shortcutId="shortCutId1"
       android:enabled="true"
       android:icon="@drawable/icon_android"
       android:shortcutShortLabel="@string/compose_shortcut_short_label1"
       android:shortcutLongLabel="@string/compose_shortcut_long_label1"
       android:shortcutDisabledMessage="@string/compose_disabled_message1">
       <intent
           android:action="android.intent.action.VIEW"
           android:targetPackage="com.example.zengyazhi.myapplication"
           android:targetClass="com.example.zengyazhi.myapplication.Main1Activity" />
       <intent
           android:action="android.intent.action.VIEW"
           android:targetPackage="com.example.zengyazhi.myapplication"
           android:targetClass="com.example.zengyazhi.myapplication.Main2Activity" />
       <categories android:name="android.shortcut.conversation" />
   </shortcut>
   
   <shortcut
       android:shortcutId="shortCutId2"
       android:enabled="true"
       android:icon="@drawable/icon_google"
       android:shortcutShortLabel="@string/compose_shortcut_short_label2"
       android:shortcutLongLabel="@string/compose_shortcut_long_label2"
       android:shortcutDisabledMessage="@string/compose_disabled_message2">
       <intent
           android:action="android.intent.action.VIEW"
           android:targetPackage="com.example.zengyazhi.myapplication"
           android:targetClass="com.example.zengyazhi.myapplication.Main2Activity" />
       <categories android:name="android.shortcut.conversation" />
   </shortcut>

   解釋一下shortcut標籤裏的各個的屬性：

   • shortcutId：shortcuts的ID
   • enabled：如果爲false則不會在長按shortcuts列表中顯示
   • icon：shortcuts的圖標
   • shortcutShortLabel：當shortcuts固定到桌面時的標題（注意字符串只能使用string資源文件引用，不可以直接使用字符串）
   • shortcutLongLabel：長按app出現shortcuts時的標題，如果太長或未設置默認會顯示shortcutShortLabel
   • shortcutDisabledMessage： 當pinned shortcuts不可用時的toast提示信息
   • shortcuts標籤內的標籤可以有多個，例如頁面1、頁面2、頁面3，用戶點擊shortcuts後進入的是列表的最後一個（即頁面3），並且可以依次回退到頁面2、頁面1.

//靜態shortcuts gif

動態shortcuts（Dynamic Shortcuts）的使用

使用ShortcutManager相關API來創建、更新、移除shortcuts。幾種API的使用方法都類似。

1. 使用setDynamicShortcuts()和addDynamicShortcuts()來動態增加shortcuts。這兩個方法有點相似，使用時要注意區別。
   addDynamicShortcuts()：添加shortcuts，如果存在相同的ID的shortcuts則更新信息。
   setDynamicShortcuts()：替換掉已有的動態shortcuts列表，如果存在相同的ID的shortcuts則更新信息。舉個例子：
   例如原本有shortcuts列表：

   • 標籤一（lable：張三， id：one）
   • 標籤二（lable：李四， id：two）
   • 標籤三（lable：王五， id：three）

   使用setDynamicShortcuts()方法並傳入兩個ShortcutInfo：

   • 標籤三（lable：趙六， id：three）
   • 標籤四（lable：錢七， id：four）

   調用方法後會使shortcuts列表則變爲：

   • 標籤三（lable：趙六， id：three）
   • 標籤四（lable：錢七， id：four）

   因爲標籤三的ID相同，所以更新標籤三，而shortcuts列表中原來的標籤一、二被移除，而且一開篇介紹shortcuts時也提到過是：如果shortcuts已被固定到桌面成爲pinned shortcuts，即使shortcuts從列表中被移除了，但桌面的pinned shortcuts依然可以正常使用，除非你將其設置disable狀態，即如果張三、李四被固定到桌面，即使調用setDynamicShortcuts()後長按app不會顯示張三、李四，但桌面上的張三李四不會消失且可以正常使用。

2. 使用updateShortcuts()更新shortcuts的信息

   ShortcutManager shortcutManager = getSystemService(ShortcutManager.class);
   ShortcutInfo shortCutId1 = new ShortcutInfo.Builder(MainActivity.this, "shortCutId3")
           .setShortLabel("更改桌面標籤3")
           .setLongLabel("更改快捷方式標籤3")
           .setIcon(Icon.createWithResource(this, R.drawable.icon_chrome))
           .setDisabledMessage("更改不可用時提示信息3")
           .setIntent(new Intent(Intent.ACTION_VIEW, Uri.parse("https://www.baidu.com/"), this, Main1Activity.class))
           .build();
   shortcutManager.updateShortcuts(Arrays.asList(shortCutId1, shortCutId4));

   動態shortcuts也可以像靜態shortcuts一樣同時添加多個intent意圖

   Intent intent1 = new Intent(Intent.ACTION_VIEW, Uri.parse("https://www.baidu.com/"), this, Main1Activity.class);
   Intent intent2 = new Intent(Intent.ACTION_VIEW, Uri.parse("https://www.baidu.com/"), this, Main2Activity.class);
   Intent[] intents = {intent1, intent2};
   
   ...
   .setIntents(intents)
   .build();
   ...

3. 使用removeDynamicShortcuts()移除單個或多個動態shortcuts，使用removeAllDynamicShortcuts()移除所有的動態shortcuts

   shortcutManager.removeDynamicShortcuts(Arrays.asList("shortCutId31", "shortCutId4"));
   
   shortcutManager.removeAllDynamicShortcuts();

4. 設置shortcuts爲不可用狀態：

   shortcutManager.disableShortcuts(Arrays.asList("shortCutId3"));
   //另一個重載的方法，可以在用戶點擊該shortcuts時顯示錯誤信息
   shortcutManager.disableShortcuts(Arrays.asList("shortCutId4"), "快捷方式4已不可用");

需要注意的是：以上API只能操作動態shortcuts（包括pinned shortcuts），不可操作靜態shortcuts，如果傳入靜態shortcuts的id會報IllegalArgumentException錯誤：Manifest shortcut ID=*** may not be manipulated via APIs

追蹤shortcuts的使用

官網文檔中提到以下兩種情景需要調用reportShortcutUsed():

1. 用戶點擊了shortcuts

2. 用戶操作了與shortcuts關聯的操作

上報shortcuts的使用來預測shortcuts的優先級，幫助開發者更好得使用shortcuts。

shortcuts設計規範

App Shortcuts Design Guidelines

Android從material design設計規範推出開始到今天的Android7，個人覺得真的是不輸iOS，然而至今沒有廣泛地被推崇，實在令人不免一聲嘆息。另外手上2013年發佈的Nexus5升級Android7之後竟然感覺比以前還順滑，什麼叫良心？跟我一起大喊：Google大法好！