App Shortcuts 快捷方式

Android Nougat 7.1(API 25) 新功能:App Shortcuts 快捷方式

AppShortcuts

是什么噩咪?

是將應用程序的常見操作或任務暴露給啟動項的一種方法纱耻。通過長按應啟動圖標顯示快捷方式垦细。

快捷方式可以拖拽到桌面單獨放置道川,變成單獨的桌面快捷方式任连。

  1. 靜態(tài):在xml文件中定義
  2. 動態(tài):由ShortcutManager發(fā)布蒙具,可根據(jù)用戶的行為或偏好添加,支持動態(tài)更新

靜態(tài) Shortcuts##

  1. AndroidManifest.xml中的main activity上添加<meta-data>
<activity android:name=".MainActivity">
        <intent-filter> 
            <action android:name="android.intent.action.MAIN" /> 
            <category android:name="android.intent.category.LAUNCHER" /> 
            <category android:name="android.intent.category.DEFAULT" /> 
        </intent-filter> 

        <meta-data 
            android:name="android.app.shortcuts" 
            android:resource="@xml/shortcuts" /> 
</activity>

activity需滿足兩個條件:

  1. actionandroid.intent.action.MAIN
  2. categoryandroid.intent.category.LAUNCHER
  3. res/xml目錄下創(chuàng)建shortcuts.xml文件娃兽,里面包含靜態(tài)的shortcuts
<?xml version="1.0" encoding="utf-8"?> 
<shortcuts xmlns:android="http://schemas.android.com/apk/res/android"> 
        <shortcut 
            android:enabled="true" 
            android:icon="@drawable/ic_static_shortcut" 
            android:shortcutDisabledMessage="@string/static_shortcut_disabled_message" 
            android:shortcutId="static" 
            android:shortcutLongLabel="@string/static_shortcut_long_label" 
            android:shortcutShortLabel="@string/static_shortcut_short_label"> 
            <intent 
                android:action="android.intent.action.VIEW" 
                android:targetClass="com.gssn.appshortcutsdemo.StaticShortcutActivity" 
                android:targetPackage="com.gssn.appshortcutsdemo" /> 
        </shortcut>
</shortcuts> 

根標簽<shortcuts>菇民,可以包含多個<shortcut>,每一個代表一個靜態(tài)shortcut

  • enabledshortcut是否可用
  • iconshortcut左側顯示的圖標
  • shortcutDisabledMessage:選擇不可用的shortcut時給用戶的一個提示
  • shortcutId:唯一的id投储,id相同時只顯示第一個
  • shortcutShortLabel:配置短名稱第练,長名稱顯示不下時顯示短名稱
  • shortcutLongLabel:配置長名稱,launcher優(yōu)先選擇顯示
  • intent:確定一個或多個意圖玛荞,并綁定shortcut
    • targetPackage: 指定目標應用的包名
    • targetClass: 要跳轉的目標類
    • action: 必須配置娇掏,否則崩潰
    • categories: 目前官方只給提供了android.shortcut.conversation
      每個<shortcut>可以添加多個<intent>
<?xml version="1.0" encoding="utf-8"?> 
<shortcuts xmlns:android="http://schemas.android.com/apk/res/android"> 
        <shortcut 
           ...> 
            <intent 
                android:action="android.intent.action.MAIN"         
                android:targetClass="com.gssn.appshortcutsdemo.MainActivity" 
                android:targetPackage="com.gssn.appshortcutsdemo" />
            <intent 
                android:action="android.intent.action.VIEW" 
                android:targetClass="com.gssn.appshortcutsdemo.StaticShortcutActivity" 
                android:targetPackage="com.gssn.appshortcutsdemo" /> 
        </shortcut>
</shortcuts> 

點擊快捷方式會創(chuàng)建一個intents棧(MainActivity -> Static ShortcutActivity),當返回時回到MainActivity

app_shortcut_static_back_stack

動態(tài) Shortcuts

可以在使用應用的過程中構建冲泥,更新驹碍,或者刪除凡恍。
相關方法:ShortcutManagerShortcutInfo.Builder

@Override
protected void onCreate(Bundle savedInstanceState) {    
    super.onCreate(savedInstanceState);    
    setContentView(R.layout.activity_main);
  
    ShortcutManager shortcutmanager = getSystemService(ShortcutManager.class);
    ShortcutInfo webShortcut = new ShortcutInfo.Builder(this, "shortcut_web")            
                  .setShortLabel("web")        
                  .setLongLabel("Open baidu.com web site")        
                  .setIcon(Icon.createWithResource(this, R.mipmap.ic_launcher))        
                  .setIntent(new Intent(Intent.ACTION_VIEW, Uri.parse("https://baidu.com")))        
                  .build();
    shortcutmanager.setDynamicShortcuts(Collections.singletonList(webShortcut));
}

ShortcutManager

可對動態(tài)shortcut完成以下操作:

  • 發(fā)布(Publish):setDynamicShortcuts(List)怔球、addDynamicShortcuts(List)
  • 更新(Update):updateShortcuts(List)
  • 刪除(Remove):removeDynamicShortcuts(List)嚼酝、removeAllDynamicShortcuts()

ShortcutInfo.Builder

方法中第二個參數(shù)是shortcutid,多個shortcutid相同時竟坛,前面的shortcut會被覆蓋闽巩。

多個Intent構建back stack

@Override
protected void onCreate(Bundle savedInstanceState) {    
    super.onCreate(savedInstanceState);    
    setContentView(R.layout.activity_main);
 
    ShortcutManager shortcutmanager = getSystemService(ShortcutManager.class);
    ShortcutInfo dynamicShortcut = new ShortcutInfo.Builder(this, "shortcut_dynamic")            
        .setShortLabel("Dynamic")        
        .setLongLabel("Open dynamic shortcut")        
        .setIcon(Icon.createWithResource(this, R.mipmap.ic_launcher))        
        .setIntents(new Intent[]{                
            new Intent(Intent.ACTION_MAIN, Uri.EMPTY, this, MainActivity.class)                        
                .setFlags(Intent.FLAG_ACTIVITY_CLEAR_TASK),                
            new Intent("TwoActivity.action")       
         })        
        .build();
    shortcutmanager.setDynamicShortcuts(Arrays.asList(dynamicShortcut));
}

//AndroidManifest.xml
<activity android:name=".TwoActivity">    
    <intent-filter>        
        <action android:name="TwoActivity.action" />        
        <category android:name="android.intent.category.DEFAULT"/>    
    </intent-filter>
</activity>

和靜態(tài)一樣,最后一個Intent打開TwoActivity頁面担汤,前面的構建back stack, 即返回退回到MainActivity涎跨。

注意:Intent必須指定Action,否則拋出異常崭歧。

Shortcut 排序

含多個Shortcuts時隅很,默認按照添加順序排列,通過setRank()可改變排序率碾。

ShortcutInfo webShortcut = new ShortcutInfo.Builder(MainActivity.this, "shortcut_web") 
    .setRank(1)  //參數(shù)不能為負數(shù)
    .build(); 
ShortcutInfo dynamicShortcut = new ShortcutInfo.Builder(MainActivity.this, "shortcut_dynamic") 
    .setRank(0) 
    .build(); 
shortcutManager.updateShortcuts(Arrays.asList(webShortcut, dynamicShortcut));

只能改變動態(tài)shortcuts的排序叔营,且按照xml中先后順序排列屋彪,故:靜態(tài)的shortcuts離應用圖標最近,動態(tài)shortcuts在其之上排序绒尊,首位級別為0畜挥,依次類推。

app_shortcut_ranks

其他

ShortcutInfo.BuildersetShortLabel(CharSequence)接收一個CharSequence作為參數(shù)婴谱,這意味著可以添加自定義的span蟹但。

ForegroundColorSpan colorSpan = new ForegroundColorSpan(getResources().
    getColor(android.R.color.holo_red_dark, getTheme())); 
String label = "catinean.com"; 
SpannableStringBuilder colouredLabel = new SpannableStringBuilder(label); 
colouredLabel.setSpan(colorSpan, 0, label.length(), Spanned.SPAN_INCLUSIVE_INCLUSIVE); 

ShortcutInfo webShortcut = new ShortcutInfo.Builder(MainActivity.this, "shortcut_web")   
    .setShortLabel(colouredLabel) 
    .setRank(1) 
    .build();
shortcutmanager.setDynamicShortcuts(Collections.singletonList(webShortcut));
app_shortcut_colour

數(shù)量限制

靜態(tài)和動態(tài)shortcuts加起來總數(shù)最多五個,否則拋出異常:java.lang.IllegalArgumentException: Max number of dynamic shortcuts exceeded谭羔,但當正好有5個時, 長按只顯示4個矮湘。

參考

Exploring Android Nougat 7.1 App Shortcuts

最后編輯于
?著作權歸作者所有,轉載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市口糕,隨后出現(xiàn)的幾起案子缅阳,更是在濱河造成了極大的恐慌,老刑警劉巖景描,帶你破解...
    沈念sama閱讀 218,036評論 6 506
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件十办,死亡現(xiàn)場離奇詭異,居然都是意外死亡超棺,警方通過查閱死者的電腦和手機向族,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,046評論 3 395
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來棠绘,“玉大人件相,你說我怎么就攤上這事⊙醪裕” “怎么了夜矗?”我有些...
    開封第一講書人閱讀 164,411評論 0 354
  • 文/不壞的土叔 我叫張陵,是天一觀的道長让虐。 經(jīng)常有香客問我紊撕,道長,這世上最難降的妖魔是什么赡突? 我笑而不...
    開封第一講書人閱讀 58,622評論 1 293
  • 正文 為了忘掉前任对扶,我火速辦了婚禮,結果婚禮上惭缰,老公的妹妹穿的比我還像新娘浪南。我一直安慰自己,他們只是感情好漱受,可當我...
    茶點故事閱讀 67,661評論 6 392
  • 文/花漫 我一把揭開白布络凿。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪喷众。 梳的紋絲不亂的頭發(fā)上各谚,一...
    開封第一講書人閱讀 51,521評論 1 304
  • 那天,我揣著相機與錄音到千,去河邊找鬼昌渤。 笑死,一個胖子當著我的面吹牛憔四,可吹牛的內(nèi)容都是我干的膀息。 我是一名探鬼主播,決...
    沈念sama閱讀 40,288評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼了赵,長吁一口氣:“原來是場噩夢啊……” “哼潜支!你這毒婦竟也來了?” 一聲冷哼從身側響起柿汛,我...
    開封第一講書人閱讀 39,200評論 0 276
  • 序言:老撾萬榮一對情侶失蹤冗酿,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后络断,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體裁替,經(jīng)...
    沈念sama閱讀 45,644評論 1 314
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,837評論 3 336
  • 正文 我和宋清朗相戀三年貌笨,在試婚紗的時候發(fā)現(xiàn)自己被綠了弱判。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 39,953評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡锥惋,死狀恐怖昌腰,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情膀跌,我是刑警寧澤遭商,帶...
    沈念sama閱讀 35,673評論 5 346
  • 正文 年R本政府宣布,位于F島的核電站淹父,受9級特大地震影響株婴,放射性物質發(fā)生泄漏怎虫。R本人自食惡果不足惜暑认,卻給世界環(huán)境...
    茶點故事閱讀 41,281評論 3 329
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望大审。 院中可真熱鬧蘸际,春花似錦、人聲如沸徒扶。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,889評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至导坟,卻和暖如春屿良,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背惫周。 一陣腳步聲響...
    開封第一講書人閱讀 33,011評論 1 269
  • 我被黑心中介騙來泰國打工尘惧, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人递递。 一個月前我還...
    沈念sama閱讀 48,119評論 3 370
  • 正文 我出身青樓喷橙,卻偏偏與公主長得像,于是被迫代替她去往敵國和親登舞。 傳聞我的和親對象是個殘疾皇子贰逾,可洞房花燭夜當晚...
    茶點故事閱讀 44,901評論 2 355

推薦閱讀更多精彩內(nèi)容