Android快捷方式-Shortcuts

就在前几天，跟一同事车回家，他用的是iOS版高德，每次发车前，重力长按高德icon，弹出shortcuts，很方便就进入回家的导航，也就是iOS 3D Touch功能。如下面这张图，截图来自647 iPhone X 。

https://user-gold-cdn.xitu.io/2018/11/9/166f61d167871745?w=350&h=758&f=png&s=187636

今天得空研究了一下，Android 在Android 7.1(API 25) 添加了App快捷方式的新功能，由ShortcutManager类来管理，这样开发者可以随意定义快速进入到指定的Activity或打开指定网页。目前有很多App已经有了这个特性，接了个图如下：

https://user-gold-cdn.xitu.io/2018/11/9/166f61d1677eba16?w=350&h=700&f=jpeg&s=28076

下面我们就详细探讨一下这个特性。

实现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;
        }
    }

http://p0.qhimg.com/t01dbcef3351fa365be.jpg

动态删除

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的另外一种快捷方式，只允许用户添加与删除它。

image