Android快捷方式-Shortcuts

就在前幾天，跟一同事車回家，他用的是iOS版高德，每次發車前，重力長按高德icon，彈出shortcuts，很方便就進入回家的導航，也就是iOS 3D Touch功能。以下面這張圖，截圖來自647 iPhone X 。

今天得空研究了一下，Android 在Android 7.1(API 25) 添加了App快捷方式的新功能，由ShortcutManager類來管理，這樣開發者能夠隨意定義快速進入到指定的Activity或打開指定網頁。目前有不少App已經有了這個特性，接了個圖以下：

下面咱們就詳細探討一下這個特性。

實現Shortcuts的兩種形式

靜態Shortcuts

所謂的靜態就是在工程中配置，利用xml寫死。在APK中包含一個資源文件來描述Shortcut，目錄res/xml/shortcuts.xml。這種方法作不到熱更新，須要重新發布App纔可。

<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
    <shortcut android:shortcutId="static shortcut" android:enabled="true" android:icon="@mipmap/ic_launcher" android:shortcutShortLabel="@string/shortcut_short_name" android:shortcutLongLabel="@string/shortcut_long_name" android:shortcutDisabledMessage="@string/shortcut_disable_msg">
        <intent android:action="android.intent.action.VIEW" android:targetPackage="d.shortcuts" android:targetClass="d.shortcuts.MainActivity" />
        <categories android:name="android.shortcut.conversation"/>
    </shortcut>
</shortcuts>
複製代碼

<application ... ...>
    <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>
</application>
複製代碼

這種方式適合百年不變的場景，否則真是不夠靈活。

動態Shortcuts

動態Shortcuts在運行時，經過ShortcutManager API來進行註冊。用這種方式能夠在運行時，動態的發佈、更新和刪除shortcut。官方給出了幾個場景能夠做爲shortcut的例子，好比：

• 在地圖類app中，指導用戶到特定的位置；
• 在社交類app中，發送消息給一個朋友；
• 在媒體類app中，播放視頻的下一片斷；
• 在遊戲類app中，下載最後保存的要點；

動態安裝

給Activity頁面構建shortcut

private void setupShortcutsForActivity() {
    mShortcutManager = getSystemService(ShortcutManager.class);
    List<ShortcutInfo> infos = new ArrayList<>();
    for (int i = 0; i < mShortcutManager.getMaxShortcutCountPerActivity(); i++) {
        Intent intent = new Intent(this, Main2Activity.class);
        intent.setAction(Intent.ACTION_VIEW);
        intent.putExtra("info", "this is info!");
        ShortcutInfo info = new ShortcutInfo.Builder(this, "ID:" + i)
                .setShortLabel("short label")
                .setLongLabel("long label")
                .setIcon(Icon.createWithResource(this, R.mipmap.ic_launcher))
                .setIntent(intent)
                .build();
        infos.add(info);
    }
    mShortcutManager.setDynamicShortcuts(infos);
}
複製代碼

使用URL構建shortcut，打開默認瀏覽器，以下

private ShortcutInfo createShortcutForUrl(String urlAsString) {
      final ShortcutInfo.Builder b = new ShortcutInfo.Builder(mContext, urlAsString);
      final Uri uri = Uri.parse(urlAsString);
      b.setIntent(new Intent(Intent.ACTION_VIEW, uri));
      setSiteInformation(b, uri)
      setExtras(b);
      return b.build();
}

private ShortcutInfo.Builder setSiteInformation(ShortcutInfo.Builder b, Uri uri) {
        b.setShortLabel(uri.getHost());
        b.setLongLabel(uri.toString());
        Bitmap bmp = fetchFavicon(uri);
        if (bmp != null) {
            b.setIcon(Icon.createWithBitmap(bmp));
        } else {
            b.setIcon(Icon.createWithResource(mContext, R.drawable.link));
        }
        return b;
 }

private ShortcutInfo.Builder setExtras(ShortcutInfo.Builder b) {
        final PersistableBundle extras = new PersistableBundle();
        extras.putLong(EXTRA_LAST_REFRESH, System.currentTimeMillis());
        b.setExtras(extras);
        return b;
}

//注意要異步Task執行
private Bitmap fetchFavicon(Uri uri) {
        final Uri iconUri = uri.buildUpon().path("favicon.ico").build();
        InputStream is = null;
        BufferedInputStream bis = null;
        try
        {
            URLConnection conn = new URL(iconUri.toString()).openConnection();
            conn.connect();
            is = conn.getInputStream();
            bis = new BufferedInputStream(is, 8192);
            return BitmapFactory.decodeStream(bis);
        } catch (IOException e) {
            return null;
        }
    }
複製代碼

動態刪除

public void removeShortcut(ShortcutInfo shortcut) { 
    mShortcutManager.removeDynamicShortcuts(Arrays.asList(shortcut.getId()));
}
複製代碼

動態停用

public void disableShortcut(ShortcutInfo shortcut) {
    mShortcutManager.disableShortcuts(Arrays.asList(shortcut.getId()));
}
複製代碼

動態開啓

public void enableShortcut(ShortcutInfo shortcut) {
    mShortcutManager.enableShortcuts(Arrays.asList(shortcut.getId()));
}
複製代碼

Pinning Shortcut

在動態裏面還有一個Pinning Shortcuts概念，至關於app的另一種快捷方式，只容許用戶添加與刪除它。

用isRequestPinShortcutSupported() 判斷當前設備是否支持PinShort 。在Android 8.0 (API level 26) 以及以上的版本上支持建立pinned shortcuts。

ShortcutManager mShortcutManager = context.getSystemService(ShortcutManager.class);
if (mShortcutManager.isRequestPinShortcutSupported()) {
    // Assumes there's already a shortcut with the ID "my-shortcut".
    // The shortcut must be enabled.
    ShortcutInfo pinShortcutInfo =
            new ShortcutInfo.Builder(context, "my-shortcut").build();
    // Create the PendingIntent object only if your app needs to be notified
    // that the user allowed the shortcut to be pinned. Note that, if the
    // pinning operation fails, your app isn't notified. We assume here that the
    // app has implemented a method called createShortcutResultIntent() that
    // returns a broadcast intent.
    Intent pinnedShortcutCallbackIntent =
            mShortcutManager.createShortcutResultIntent(pinShortcutInfo);

    // Configure the intent so that your app's broadcast receiver gets
    // the callback successfully.For details, see PendingIntent.getBroadcast().
    PendingIntent successCallback = PendingIntent.getBroadcast(context, /* request code */ 0,
            pinnedShortcutCallbackIntent, /* flags */ 0);

    mShortcutManager.requestPinShortcut(pinShortcutInfo,
            successCallback.getIntentSender());
}
複製代碼

shortcuts 最佳實踐

一、無論是靜態形式仍是動態形式，每一個應用最多能夠註冊4個Shortcuts。

二、 "short description" 限制在 10 個字符內

三、"long description" 限制在 25 個字符內

四、改變 dynamic and pinned shortcuts時，調用方法updateShortcuts()

五、重複建立shortcut時，

• 動態的 shortcuts使用方法: addDynamicShortcuts() 或 setDynamicShortcuts().
• Pinned shortcuts使用方法: requestPinShortcut().

六、在每次啓動與須要從新發布動態shortcut時，推薦檢查方法getDynamicShortcuts() 返回的數量。

public class MainActivity extends Activity {
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        ShortcutManager shortcutManager = getSystemService(ShortcutManager.class);
        if (shortcutManager.getDynamicShortcuts().size() == 0) {
            // Application restored. Need to re-publish dynamic shortcuts.
            if (shortcutManager.getPinnedShortcuts().size() > 0) {
                // Pinned shortcuts have been restored. Use
                // updateShortcuts() to make sure they contain
                // up-to-date information.
            }
        }
    }
    // ...
}
複製代碼

本文demo地址:
github.com/donald99/sh…

推薦Google demo
github.com/googlesampl…

關注微信公衆號，最新技術乾貨實時推送