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

Hello shortcuts

從Android7.1(API level25)開始,開發(fā)者可以為自己的app定制shortcuts。shortcuts使用戶更便捷、快速的使用app。我個人感覺有點像ios的壓力感應(yīng),但是我認(rèn)為Google的shortcuts動畫做的更好看:)。

shortcuts

shortcuts分為兩種:

  1. Static shortcuts:靜態(tài)shortcuts是在資源文件中定義的,所以你只能通過升級你的app來更新靜態(tài)shortcuts的相關(guān)信息。

  2. Dynamic shortcuts:動態(tài)shortcuts是通過ShortcutManager相關(guān)的API來實現(xiàn)運行時新增、修改、移除shortcuts的。

另外關(guān)于shortcuts有以下幾點小tips:

  1. 最多可以設(shè)置5個快捷方式,(但經(jīng)測試最多只能顯示4個)。有些啟動器(launcher app)不會顯示出你添加的所有的快捷方式。

  2. 用戶可以長按shortcuts將其固定到桌面,Google稱其為“pinned shortcuts”,pinned shortcuts的數(shù)量是沒有限制的,并且開發(fā)者無權(quán)移除這些pinned shorcuts(只能用戶自己移除或者刪除app后自動移除,如果某個shortcuts已經(jīng)被固定到桌面,即使動態(tài)刪除了該shortcuts,桌面的shortcuts也不會消失且可以正常使用),但可以將其設(shè)為不可用狀態(tài)(disbale)。

  3. 雖然其他app無法通過shortcuts訪問你的app的元數(shù)據(jù)(metadata),但啟動器(laucher)可以,所以在使用shortcuts時要注意保護(hù)用戶的隱私信息。

靜態(tài)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>
  1. res文件夾內(nèi)新建文件夾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標(biāo)簽里的各個的屬性:

    • shortcutId:shortcuts的ID
    • enabled:如果為false則不會在長按shortcuts列表中顯示
    • icon:shortcuts的圖標(biāo)
    • shortcutShortLabel:當(dāng)shortcuts固定到桌面時的標(biāo)題(注意字符串只能使用string資源文件引用,不可以直接使用字符串)
    • shortcutLongLabel:長按app出現(xiàn)shortcuts時的標(biāo)題,如果太長或未設(shè)置默認(rèn)會顯示shortcutShortLabel
    • shortcutDisabledMessage: 當(dāng)pinned shortcuts不可用時的toast提示信息
    • shortcuts標(biāo)簽內(nèi)的<intent/>標(biāo)簽可以有多個,例如頁面1、頁面2、頁面3,用戶點擊shortcuts后進(jìn)入的是列表的最后一個(即頁面3),并且可以依次回退到頁面2、頁面1.

動態(tài)shortcuts(Dynamic Shortcuts)的使用

使用ShortcutManager相關(guān)API來創(chuàng)建、更新、移除shortcuts。幾種API的使用方法都類似。

  1. 使用setDynamicShortcuts()addDynamicShortcuts()來動態(tài)增加shortcuts。這兩個方法有點相似,使用時要注意區(qū)別。
    addDynamicShortcuts():添加shortcuts,如果存在相同的ID的shortcuts則更新信息。
    setDynamicShortcuts()替換掉已有的動態(tài)shortcuts列表,如果存在相同的ID的shortcuts則更新信息。舉個例子:
    例如原本有shortcuts列表:
  • 標(biāo)簽一(lable:張三, id:one)

  • 標(biāo)簽二(lable:李四, id:two)

  • 標(biāo)簽三(lable:王五, id:three)

    使用setDynamicShortcuts()方法并傳入兩個ShortcutInfo:

  • 標(biāo)簽三(lable:趙六, id:three)

  • 標(biāo)簽四(lable:錢七, id:four)

    調(diào)用方法后會使shortcuts列表則變?yōu)椋?/p>

  • 標(biāo)簽三(lable:趙六, id:three)

  • 標(biāo)簽四(lable:錢七, id:four)

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

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

    ShortcutManager shortcutManager = getSystemService(ShortcutManager.class);
    ShortcutInfo shortCutId1 = new ShortcutInfo.Builder(MainActivity.this, "shortCutId3")
            .setShortLabel("更改桌面標(biāo)簽3")
            .setLongLabel("更改快捷方式標(biāo)簽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));
    

    動態(tài)shortcuts也可以像靜態(tài)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();
    ...
    
  2. 使用removeDynamicShortcuts()移除單個或多個動態(tài)shortcuts,使用removeAllDynamicShortcuts()移除所有的動態(tài)shortcuts

    shortcutManager.removeDynamicShortcuts(Arrays.asList("shortCutId31", "shortCutId4"));
    
    shortcutManager.removeAllDynamicShortcuts();
    
  3. 設(shè)置shortcuts為不可用狀態(tài):

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

需要注意的是:以上API只能操作動態(tài)shortcuts(包括pinned shortcuts),不可操作靜態(tài)shortcuts,如果傳入靜態(tài)shortcuts的id會報IllegalArgumentException錯誤:Manifest shortcut ID=*** may not be manipulated via APIs

shortcuts

追蹤shortcuts的使用

官網(wǎng)文檔中提到以下兩種情景需要調(diào)用reportShortcutUsed():

  1. 用戶點擊了shortcuts

  2. 用戶操作了與shortcuts關(guān)聯(lián)的操作

上報shortcuts的使用來預(yù)測shortcuts的優(yōu)先級,幫助開發(fā)者更好得使用shortcuts。

shortcuts設(shè)計規(guī)范

App Shortcuts Design Guidelines

Android從material design設(shè)計規(guī)范推出開始到今天的Android7,個人覺得真的是不輸iOS,然而至今沒有廣泛地被推崇,實在令人不免一聲嘆息。另外手上2013年發(fā)布的Nexus5升級Android7之后竟然感覺比以前還順滑,什么叫良心?跟我一起大喊:Google大法好!

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容