为了账号安全,请及时绑定邮箱和手机立即绑定

Android 7.1 新特性 - App Shortcuts 简介

标签:
Android

Android 7.1 新功能之一就是 App Shortcuts(应用快捷方式) ,该功能与 iPhone 上的 3D Touch 功能相似,通过长按应用图标,可弹出应用快捷方式,点击可以直接跳转到相应的界面。目前最多支持 5 个快捷方式,可以 getMaxShortcutCountPerActivity() 查看 Launcher 最多支持几个快捷方式,不同的是 Android 支持通过拖拽将快捷方式固定到桌面。

看似美好,其实应用快捷方式还是有很多缺陷的:

1.       只能在 Google 的 Nexus 及 Pixel 设备上使用

2.       系统必须是 Android 7.1 及以上(API Level >= 25)

3.       已经被用户固定到桌面的快捷方式必须得到兼容性处理,因为你基本上失去了对其控制,除了升级时禁用

Launcher applications allow users to "pin" shortcuts so they're easier to access. Both manifest and dynamic shortcuts can be pinned. Pinned shortcuts cannot be removed by publisher applications; they're removed only when the user removes them, when the publisher application is uninstalled, or when the user performs the "clear data" action on the publisher application from the device's Settings application.
However, the publisher application can disable pinned shortcuts so they cannot be started. See the following sections for details.

应用快捷方式可分为 Static Shortcuts(静态快捷方式) 和 Dynamic Shortcuts(动态快捷方式) 两种。

·         静态快捷方式:又名 Manifest Shortcuts,在应用安装时创建,不能实现动态修改,只能通过应用更新相应的 XML 资源文件才能实现更新。

·         动态快捷方式:应用运行时通过 ShortcutManager 实现动态添加、删除、禁用等操作。

下面分别来讲述如何创建静态快捷方式和动态快捷方式。

创建静态快捷方式

1.       在 /res/xml 目录下创建 shortcuts.xml ,添加根元素 \<shortcuts> ,其包含一组 \<shortcut> 标签。每个 \<shortcut> 标签为一个静态快捷方式,它包含相应的图标、描述以及对应的 intent

[代码]xml代码:

?

01

02

03

04

05

06

07

08

09

10

11

12

13

14

15

16

17

18

19

<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">

   <shortcut

     android:shortcutId="compose"

     android:enabled="true"

     android:icon="@drawable/compose_icon"

     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.myapplication"

       android:targetClass="com.example.myapplication.ComposeActivity" />

     <!-- If   your shortcut is associated with multiple intents, include them

          here.   The last intent in the list is what the user sees when they

          launch   this shortcut. -->

     <categories android:name="android.shortcut.conversation" />

   </shortcut>

   <!-- Specify more   shortcuts here. -->

 </shortcuts>

 

1.       打开 AndroidManifest.xml 文件,找到其中 <intent-filter> 被设置为 android.intent.action.MAIN 和 android.intent.category.LAUNCHER 的 Activity

2.       给这个 Activity 添加 <meta-data> ,引用资源 shortcuts.xml

[代码]xml代码:

?

01

02

03

04

05

06

07

08

09

10

11

12

13

14

<manifest xmlns:android="http://schemas.android.com/apk/res/android"

              package="com.example.myapplication">

   <application ... >

     <activity android:name="Main">

       <intent-filter>

         <action android:name="android.intent.action.MAIN" />

         <category android:name="android.intent.category.LAUNCHER" />

       </intent-filter>

       <!--   在   meta-data 中设置 shortcuts -->

       <meta-data android:name="android.app.shortcuts"

                  android:resource="@xml/shortcuts" />

     </activity>

   </application>

 </manifest>

 

补充:注意第 2 点的描述,也就是说如果 Manifest 中存在多个满足条件的 Activity ,那么就可以存在多组应用快捷方式,但资源文件必须不同,主要是 shortcutId 必须不同,否则不会显示。大家可以自己去尝试下~

<shortcut> 标签属性含义如下:

[代码]xml代码:

?

01

02

03

04

05

06

07

08

09

10

11

12

13

14

15

16

17

18

19

shortcutId:快捷方式的唯一标识。

当用户拖拽快捷方式到桌面,只要 shortcutId 不变,修改   <shortcut> 其余属性值,重新打包,修改之后的变化会体现到已拖拽到桌面的快捷方式上。

若存在多个 <shortcut> 但 shortcutId 相同,则只会显示一个

 

icon:快捷方式图标

 

shortcutShortLabel:快捷方式的 Label,当用户拖拽快捷方式到桌面时,显示的也是该字符串

 

shortcutLongLabel:长按 app 图标出现快捷方式时显示的图标

 

shortcutDisabledMessage:当快捷方式被禁用时显示的提示语

 

enabled:标识快捷方式是否可用,可用时,快捷方式图标正常显示,点击跳转到对应的   intent ;不可用时,快捷方式图标变灰,点击弹出 shortcutDisabledMessage 对应字符串的 Toast

 

intent:快捷方式关联的 intent,当用户点击快捷方式时,列表中所有 intent 都会被打开,但用户看见的是列表中最后一个 intent 。

 

categories:用于指定 shortcut 的 category,目前只有   SHORTCUT_CATEGORY_CONVERSATION 一个值

 

补充:如果 <shortcuts> 中只有一个   <shortcut> 且 enabled = false ,那么长按 app 图标是不会弹出任意快捷方式

 

gradle 配置

[代码]xml代码:

?

01

02

03

04

05

06

07

08

09

10

11

12

13

14

15

16

17

18

19

20

21

apply plugin: 'com.android.application'

 

android {

    //如果只是创建静态快捷方式,那么版本号任意

    //即使 compileSdkVersion 、targetSdkVersion 为 23 ,在 Android 7.1 的 Nexus 和 Pixel 设备上也能使用。

    //但是如果是创建动态快捷方式,因为则必须使   compileSdkVersion 为 25

    compileSdkVersion   25

    buildToolsVersion   "25.0.0"

 

    defaultConfig {

        applicationId   "com.littlejie.shortcuts"

        minSdkVersion   23

        targetSdkVersion   25

        versionCode   1

        versionName   "1.0"

 

        testInstrumentationRunner   "android.support.test.runner.AndroidJUnitRunner"

 

    }

    // something else   ...

}


屏幕快照 2016-11-01 上午8.46.31

关于 compileSdkVersion 、 minSdkVersion 以及 targetSdkVersion 的区别可参考这篇文章

创建动态快捷方式

创建动态快捷方式主要依靠 ShortManager 、 ShortcutInfo 和 ShortcutInfo.Builder 这几个类来实现。ShortcutInfo 和 ShortcutInfo.Builder 主要用来构造快捷方式对象, ShortManager 是一个系统服务,用于管理应用快捷方式,ShortManager 可以通过以下方式获取:

[代码]java代码:

?

1

ShortManager shortManager =   (ShortcutManager) getSystemService(Context.SHORTCUT_SERVICE);

 

ShortManager 主要有以下几个功能:

·         发布:通过调用 setDynamicShortcuts(List) 替换整个快捷方式列表或者通过 addDynamicShortcuts(List) 往已存在的快捷方式列表中添加快捷方式。

·         更新:调用 updateShortcuts(List) 来更新已存在的快捷方式列表

·         移除:调用 removeDynamicShortcuts(List) 移除列表中指定快捷方式,调用 removeAllDynamicShortcuts() 移除列表中所以快捷方式。

·         禁用:因为用户可能将您任意的快捷方式拖拽到桌面,而这些快捷方式会将用户引导至应用中不存在或过期的操作,所以可以通过调用 disableShortcuts(List) 来禁用任何已存在的快捷方式。调用 disableShortcuts(List, Charsquence) 会给出错误提示。

下面代码主要演示了使用 ShortManager 实现动态发布、更新、移除以及禁用快捷方式。

动态创建快捷方式核心代码:

[代码]java代码:

?

001

002

003

004

005

006

007

008

009

010

011

012

013

014

015

016

017

018

019

020

021

022

023

024

025

026

027

028

029

030

031

032

033

034

035

036

037

038

039

040

041

042

043

044

045

046

047

048

049

050

051

052

053

054

055

056

057

058

059

060

061

062

063

064

065

066

067

068

069

070

071

072

073

074

075

076

077

078

079

080

081

082

083

084

085

086

087

088

089

090

091

092

093

094

095

096

097

098

099

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

public class MainActivity   extends Activity   implements View.OnClickListener   {

 

    private static final String   TAG = MainActivity.class.getSimpleName();

    private ShortcutManager mShortcutManager;

    private ShortcutInfo[] mShortcutInfos;

 

    @Override

    protected void onCreate(Bundle savedInstanceState) {

        super.onCreate(savedInstanceState);

        setContentView(R.layout.activity_main);

 

        //这里常量Context.SHORTCUT_SERVICE会报错,不用管,可正常编译。看着烦的话把minSdkVersion改为25即可

        mShortcutManager   = (ShortcutManager) getSystemService(Context.SHORTCUT_SERVICE);

 

        mShortcutInfos   = new ShortcutInfo[]{getShoppingShortcut(),   getDateShortcut()};

        findViewById(R.id.btn_set).setOnClickListener(this);

        findViewById(R.id.btn_add).setOnClickListener(this);

        findViewById(R.id.btn_update).setOnClickListener(this);

        findViewById(R.id.btn_disabled).setOnClickListener(this);

        findViewById(R.id.btn_remove).setOnClickListener(this);

        findViewById(R.id.btn_removeAll).setOnClickListener(this);

        findViewById(R.id.btn_print_max_shortcut_per_activity).setOnClickListener(this);

        findViewById(R.id.btn_print_dynamic_shortcut).setOnClickListener(this);

        findViewById(R.id.btn_print_static_shortcut).setOnClickListener(this);

    }

 

    private ShortcutInfo getAlarmShortcut(String   shortLabel) {

        if (TextUtils.isEmpty(shortLabel)) {

            shortLabel   = "Python";

        }

        ShortcutInfo   alarm = new ShortcutInfo.Builder(this,   "alarm")

                .setIntent(new Intent(Intent.ACTION_VIEW, Uri.parse("https://www.baidu.org/")))

                .setShortLabel(shortLabel)

                .setLongLabel("不正经的闹钟")

                .setIcon(Icon.createWithResource(this,   R.mipmap.ic_alarm))

                .build();

        return alarm;

    }

 

    private ShortcutInfo getShoppingShortcut() {

        ShortcutInfo   shopping = new ShortcutInfo.Builder(this,   "shopping")

                .setIntent(new Intent(Intent.ACTION_VIEW, Uri.parse("http://www.taobao.com")))

                .setShortLabel("双十一剁手")

                .setLongLabel("一本正经的购物")

                .setIcon(Icon.createWithResource(this,   R.mipmap.ic_shopping))

                .build();

        return shopping;

    }

 

    private ShortcutInfo getDateShortcut() {

        ShortcutInfo   date = new ShortcutInfo.Builder(this,   "date")

                .setIntent(new Intent(Intent.ACTION_VIEW, Uri.parse("http://www.google.com")))

                .setShortLabel("被强了")

                .setLongLabel("日程")

                .setIcon(Icon.createWithResource(this,   R.mipmap.ic_today))

                .build();

        return date;

    }

 

    @Override

    public void onClick(View view) {

        switch (view.getId()) {

            case R.id.btn_set:

                setDynamicShortcuts();

                break;

            case R.id.btn_add:

                addDynamicShortcuts();

                break;

            case R.id.btn_update:

                updateDynamicShortcuts();

                break;

            case R.id.btn_disabled:

                disableDynamicShortcuts();

                break;

            case R.id.btn_remove:

                removeDynamicShortcuts();

                break;

            case R.id.btn_removeAll:

                removeAllDynamicShortcuts();

                break;

            case R.id.btn_print_max_shortcut_per_activity:

                printMaxShortcutsPerActivity();

                break;

            case R.id.btn_print_dynamic_shortcut:

                printDynamicShortcuts();

                break;

            case R.id.btn_print_static_shortcut:

                printStaticShortcuts();

                break;

        }

    }

 

    /**

     * 动态设置快捷方式

     */

    private void setDynamicShortcuts() {

        mShortcutManager.setDynamicShortcuts(Arrays.asList(mShortcutInfos));

    }

 

    /**

     * 添加快捷方式

     */

    private void addDynamicShortcuts() {

        mShortcutManager.addDynamicShortcuts(Arrays.asList(getAlarmShortcut(null)));

    }

 

    /**

     * 更新快捷方式,类似于Notification,根据id进行更新

     */

    private void updateDynamicShortcuts() {

        mShortcutManager.updateShortcuts(Arrays.asList(getAlarmShortcut("Java")));

    }

 

    /**

     * 禁用动态快捷方式

     */

    private void disableDynamicShortcuts() {

        mShortcutManager.disableShortcuts(Arrays.asList("alarm"));

        //因为shortcutId=compose2的快捷方式为静态,所以不能实现动态修改

        //mShortcutManager.disableShortcuts(Arrays.asList("compose2"));

    }

 

    /**

     * 移除快捷方式

     *

     * 已被用户拖拽到桌面的快捷方式还是回继续存在,如果不在支持的话,最好将其置为disable

     */

    private void removeDynamicShortcuts() {

        mShortcutManager.removeDynamicShortcuts(Arrays.asList("alarm"));

    }

 

    /**

     * 移除所有动态快捷方式

     */

    private void removeAllDynamicShortcuts() {

        mShortcutManager.removeAllDynamicShortcuts();

    }

 

    /**

     * 只要 intent-filter 的 action = android.intent.action.MAIN

     * 和 category =   android.intent.category.LAUNCHER 的 activity 都可以设置 Shortcuts

     */

    private void printMaxShortcutsPerActivity() {

        Log.d(TAG,   "每个   Launcher Activity 能显示的最多快捷方式个数:" +   mShortcutManager.getMaxShortcutCountPerActivity());

    }

 

    /**

     * 打印动态快捷方式信息

     */

    private void printDynamicShortcuts() {

        Log.d(TAG,   "动态快捷方式列表数量:" + mShortcutManager.getDynamicShortcuts().size() + "信息:" + mShortcutManager.getDynamicShortcuts());

    }

 

    /**

     * 打印静态快捷方式信息

     */

    private void printStaticShortcuts() {

        Log.d(TAG,   "静态快捷方式列表数量:" + mShortcutManager.getManifestShortcuts().size() + "信息:" +   mShortcutManager.getManifestShortcuts());

    }

 

}

 

代码基本涵盖了动态创建快捷方式的所有情况,组合测试一下就可以了。

注意代码中的 addDynamicShortcuts() 方法,该方法调用 getAlarmShortcut(String shortcutLabel) 方法生成 ShortcutInfo ,该方法生成的 ShortcutInfo 的 id 是在变化的,如果多次点击超过 mShortcutManager.getMaxShortcutCountPerActivity() 的值,就会抛出如下异常:

[代码]java代码:

?

1

2

3

4

5

java.lang.IllegalArgumentException: Max   number of dynamic shortcuts exceeded

       at   android.os.Parcel.readException(Parcel.java:1688)

       at   android.os.Parcel.readException(Parcel.java:1637)

       at   android.content.pm.IShortcutService$Stub$Proxy.addDynamicShortcuts(IShortcutService.java:430)

       at   android.content.pm.ShortcutManager.addDynamicShortcuts(ShortcutManager.java:535)

 

所以在动态添加快捷方式之前最好先检查一下是否超过最大值。

还有,disableDynamicShortcuts() 注释了使用 ShortManager 动态修改静态快捷方式的代码,因为静态快捷方式时不允许在运行时进行修改的,如果执行了修改会抛出如下异常:

[代码]java代码:

?

1

2

3

4

5

6

java.lang.IllegalArgumentException:   Manifest shortcut ID=compose2 may not be manipulated via APIs

    at   android.os.Parcel.readException(Parcel.java:1688)

    at   android.os.Parcel.readException(Parcel.java:1637)

    at   android.content.pm.IShortcutService$Stub$Proxy.disableShortcuts(IShortcutService.java:540)

    at   android.content.pm.ShortcutManager.disableShortcuts(ShortcutManager.java:615)

    at   com.littlejie.shortcuts.MainActivity.disableDynamicShortcuts(MainActivity.java:135)

 

值得注意的地方

前面讲了创建静态快捷方式和动态快捷方式,可能某些要点还没讲到,这里做下总结。

被禁用的快捷方式还计入已经创建快捷方式里嘛

用 addDynamicShortcuts() 、 disableDynamicShortcuts 和 printDynamicShortcuts() 测试,发现被禁用的快捷方式时不算已经创建的快捷方式的。

总结

简单的总结了一下 Android 7.1 中应用快捷方式的创建及注意点,但某些不太常用的没怎么去研究,有兴趣的可以参考 Android 官方文档

原文链接:http://www.apkbus.com/blog-705730-62572.html

点击查看更多内容
TA 点赞

若觉得本文不错,就分享一下吧!

评论

作者其他优质文章

正在加载中
  • 推荐
  • 评论
  • 收藏
  • 共同学习,写下你的评论
感谢您的支持,我会继续努力的~
扫码打赏,你说多少就多少
赞赏金额会直接到老师账户
支付方式
打开微信扫一扫,即可进行扫码打赏哦
今天注册有机会得

100积分直接送

付费专栏免费学

大额优惠券免费领

立即参与 放弃机会
意见反馈 帮助中心 APP下载
官方微信

举报

0/150
提交
取消