了解android7:shortcuts(快捷方式)

來看看最終實現的效果:

ok, 到這裡, 靜態配置shortcuts我們就學習完了, 是不是很簡單? 那這個靜態配置是用在什麼地方呢? 我想了想, 這裡適用的場景一般是一些固定不變的功能, 例如你APP的設置界面, 如果是一些動態的數據, 那靜態配置就不適合了, 就需要我們接下來要介紹到了動態配置了.

使用Dynamic Shortcuts

在看完Static Shortcuts後, 我們不相信Google僅僅給我們開發者開放了局限性如此大的使用方式, 肯定還會存在靈活性更大的API, 是的, 這就是我們馬上要講的Dynamic Shortcuts, 我把它稱為動態配置.

說起動態配置, 那肯定是用java代碼實現了, 那如何實現呢?
首先第一步, 我們需要利用一下代碼拿到ShortcutManager

getSystemService(ShortcutManager.class)

拿到ShortcutManager後, 我們可以調用setDynamicShortcuts(List)方法去設置Shortcut, 那這個List如何得到呢? 我們來看看完整點的代碼,

private void setupShortcuts() {
    mShortcutManager = getSystemService(ShortcutManager.class);

    List infos = new ArrayList<>();
    for (int i = 0; i < mShortcutManager.getMaxShortcutCountPerActivity(); i++) {
        Intent intent = new Intent(this, MessageActivity.class);
        intent.setAction(Intent.ACTION_VIEW);
        intent.putExtra("msg", "我和" + mAdapter.getItem(i) + "的對話");

        ShortcutInfo info = new ShortcutInfo.Builder(this, "id" + i)
                .setShortLabel(mAdapter.getItem(i))
                .setLongLabel("聯系人:" + mAdapter.getItem(i))
                .setIcon(Icon.createWithResource(this, R.drawable.icon))
                .setIntent(intent)
                .build();
        infos.add(info);
//            manager.addDynamicShortcuts(Arrays.asList(info));
    }

    mShortcutManager.setDynamicShortcuts(infos);
}

這段代碼的背景是我們模擬了一個聯系人列表功能, 在launcher中我們長按圖標會出現一定數量的聯系人快捷方式, 點擊某個快捷方式會直接跳轉該聯系人相關的頁面. 好, 介紹完背景, 我們來看代碼, 首先我們通過getSystemService(ShortcutManager.class)來拿到ShortcutManager, 接下來一個for循環, 注意這個for循環的次數, 因為我們要添加的Shortcut不能是無限個, 所以這裡我們用getMaxShortcutCountPerActivity來獲取到最大個數. 然後在for循環裡, 我們首先構造一個intent, 注意, 這裡和Static Shortcut一樣, 必須要提供一個Action. 然後我們用ShortcutInfo.Builder來構造一個ShortcutInfo並且放到List中, 最終我們調用mShortcutManager.setDynamicShortcuts(infos)來設置Shortcuts.

好了, 代碼其實很簡單, 我們來看看效果.

是不是很666?

動態更新 Shortcuts

上面的代碼我們雖然說是Dynamic, 但僅僅是使用java代碼實現的罷了, 真正的Dynamic我們接下來才去講解, 在講解Dynamic之前, 我們先來介紹一個名詞-Pinning Shortcuts, 這是個啥玩意呢? 其實對於Shortcut, Android是允許我們直接放到桌面的, 這樣就更加方便了用戶的操作, google把他稱作為Pinning Shortcuts, 具體啥樣, 我們來張圖就明白了.

對於這個Pinning Shortcuts, google的文檔說, 我們開發者是沒有權利去刪除的, 能刪除它的只有用戶. 那我該項功能刪除了咋辦? 這東西還在桌面上, 是不是APP要崩? 當然Google考慮到了這點, 它允許我們去disable這個shortcut. 具體還是來看代碼, 這裡我們長按item來模擬一下刪除.

private void removeItem(int index) {
    List infos = mShortcutManager.getPinnedShortcuts();
    for (ShortcutInfo info : infos) {
        if (info.getId().equals("id" + index)) {
            mShortcutManager.disableShortcuts(Arrays.asList(info.getId()), "暫無該聯系人");
        }
    }
    mShortcutManager.removeDynamicShortcuts(Arrays.asList("id" + index));
}

首先我們先調用mShortcutManager.getPinnedShortcuts()來獲取到所有的Pinning Shortcuts, 然後去遍歷它, 找到我們刪除的那個, 然後通過APIdisableShortcuts(List)來disable掉該項, 最後我們還要用過removeDynamicShortcuts(List)來從shortcuts中移除. 來看看效果.

通過效果中, 我們可以看到, 我們disableShortcuts的那個Pinning Shortcut已經變灰了, 而且在點擊的時候會提醒暫無該聯系人, 這個提醒正是disableShortcuts的第二個參數.

現在, 刪除和禁用我們已經了解了, 那更新呢? 假如我修改了某個聯系人的名字, shortcut是不是也應該相應的修改呢? 是的, 這裡還是需要我們通過代碼來實現.

private void updItem(int index) {
    Intent intent = new Intent(this, MessageActivity.class);
    intent.setAction(Intent.ACTION_VIEW);
    intent.putExtra("msg", "我和" + mAdapter.getItem(index) + "的對話");

    ShortcutInfo info = new ShortcutInfo.Builder(this, "id" + index)
            .setShortLabel(mAdapter.getItem(index))
            .setLongLabel("聯系人:" + mAdapter.getItem(index))
            .setIcon(Icon.createWithResource(this, R.drawable.icon))
            .setIntent(intent)
            .build();

    mShortcutManager.updateShortcuts(Arrays.asList(info));
}

構建intent我們就不說了, 接下來我們又使用ShortcutInfo.Builder來構建了一個新的ShortcutInfo, 最後我們是用過updateShortcuts(List)來實現更新shortcut的, 很簡單, 來看看效果.

ok, 現在, Android7.1的Shortcuts功能我們就差不多介紹完了