Android 8.0应用快捷方式（ShortcutManager）的使用

最新推荐文章于 2024-08-29 15:56:41 发布

Hi以梦为马

最新推荐文章于 2024-08-29 15:56:41 发布

阅读量9k

点赞数 4

分类专栏： android 文章标签： Android 8.0应用快捷方式

本文链接：https://blog.csdn.net/lhy349/article/details/82624487

版权

android 专栏收录该内容

33 篇文章

订阅专栏

在Android系统上，有时候会看到在桌面上长按应用图标弹出应用快捷列表，例如美团、支付宝、微博、印象笔记、QQ邮箱等，效果图如下所示：

用户可以通过这些快捷键，直接访问应用具体的界面，并且长按这些快捷键可以在桌面上创建一个该快捷键的应用图标，比如长按上图中的收钱快捷键，拖动即可在桌面创建一个支付宝收钱快捷方式。
这个效果是Android 7.1之后新增的一个功能：应用快捷方式ShortcutManager，官方API地址：
https://developer.android.google.cn/reference/android/content/pm/ShortcutManager.html，接下来，我们将演示该快捷方式的具体实现方法：

静态的: 在xml中定义, 适用于一些通用的动作.
动态的: 由ShortcutManager发布, 可以根据用户的行为或者偏好添加, 可以动态更新.

注：该快捷方式只能在Android 7.1的设备上显示，且每一个应用目前最多可以有5个shortcuts(静态 + 动态)。

静态ShortcutManager的使用

静态的Shortcuts是写在xml中的，除非应用更新，否则不能被修改。
首先在res/xml/创建一个shortcuts.xml文件，内容如下所示：

<?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_search"
        android:shortcutDisabledMessage="@string/lable_shortcut_static_search_disable"
        android:shortcutId="shortcut_id_search"
        android:shortcutLongLabel="@string/lable_shortcut_static_search_disable"
        android:shortcutShortLabel="@string/lable_shortcut_static_search_disable">
        <intent
            android:action="android.intent.action.VIEW"
            android:targetClass="com.cjxj.androiddemo.activity.MainActivity"
            android:targetPackage="com.cjxj.androiddemo" />
        <categories android:name="android.shortcut.conversation" />
    </shortcut>
</shortcuts>

其中属性分别表示：

shortcutId表示 shortcut 唯一标识符，相同的 shortcutId 会被覆盖。必须字段。
shortcutShortLabel为将 shortcut 拖动到桌面时显示的名字，官方建议不超过 10 个字符，必须字段。
shortcutLongLabel为 shortcut 列表中每个 shortcut 的名字，不宜过长，如果过长或未设置默认会显示 ShortLabel，官方建议不超过 25 个字符。可选字段。
icon为 shortcut 的 icon，在列表展示和拖动到桌面时显示需要，可选字段。
enabled表示 shortcut 是否可用，false 表示禁用。
shortcutDisabledMessage为已固定在桌面的 shortcut 被 Disabled 后点击时的 Toast 提示内容。可选字段。
intent为点击 shortcut 时响应的 Intent，必须字段。

这里可以添加多个 Intent，但点击时不会启动所有 Intent，而是启动最后一个 Intent，在这个 Intent 回退时会启动它前面一个 Intent，相当于自动将所有 Intent 添加到了堆栈。

然后在应用的Manifest文件中配置启动界面的Activity，内容如下：

        <activity
            android:name=".activity.HomeListActivity"
            android:screenOrientation="portrait">
            <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>

至此，我们就添加了一个搜索功能的快捷方式，效果如下：

动态ShortcutManager的使用

动态是通过 ShortcutManager API 进行操作，可以动态添加、修改、删除。

        if (Build.VERSION.SDK_INT >= 25) {
            ShortcutInfo shortcutInfo = new ShortcutInfo.Builder(this, "shortcut_id_search")
                    .setShortLabelResId(R.string.lable_shortcut_static_search_disable)
                    .setLongLabelResId(R.string.lable_shortcut_static_search_disable)
                    .setIcon(Icon.createWithResource(this, R.drawable.ic_search))
                    .setIntent(new Intent(this, MainActivity.class))
                    .build();

            ShortcutManager shortcutManager = getSystemService(ShortcutManager.class);
            //这样就可以通过长按图标显示出快捷方式了
            shortcutManager.setDynamicShortcuts(Arrays.asList(shortcutInfo));

        }