Giter VIP home page Giter VIP logo

shortcut's Introduction

概览

  桌面快捷快捷方式,可在受支持的启动器中显示,帮助用户快速访问应用的某些功能。例如点击桌面“扫一扫”快捷方式,便启动App并且跳转到扫一扫界面。例如添加小程序到桌面,用户点击桌面快捷方式便可启动App快速进入小程序。

  在 Android 8.0(API 级别 26)及更高版本中,才支持创建桌面快捷方式。与静态和动态快捷方式不同,桌面快捷方式在受支持的启动器中显示为单独的图标

权限

创建桌面快捷方式权限不需要运行时请求,在AndroidManifest.xml声明即可。

    <uses-permission android:name="com.android.launcher.permission.INSTALL_SHORTCUT" />
    <uses-permission android:name="com.android.launcher.permission.UNINSTALL_SHORTCUT" />

可是,华为、小米、OPPO、Vivo等厂商的权限管理都将创建桌面快捷方式权限设计成运行时权限,默认权限是禁止。这样我们要解决两个问题:

  1. 如何检测当前应用是否获取了创建桌面快捷方式权限
    华为、小米、OPPO、Vivo检测方法不相同,具体分析过程参考《是否允许创建快捷方式的权限检测》,根据这篇文章本人已经整理好相关可运行代码 github
厂商 检测方法 机型有问题请issue
华为 反射com.huawei.hsm.permission.PermissionManager#canSendBroadcast Android 7-11
小米 反射AppOpsManager#checkOpNoThrow Android 7-11
OPPO ContentProvider查询URI:content://settings/secure/launcher_shortcut_permission_settings Android 7-11
Vivo ContentProvider查询URI:content://com.bbk.launcher2.settings/favorites Android 7-11
  1. 是否可以按照运行时权限进行请求让用户进行授权同意
    不可以,需要引导用户跳转应用设置界面进行权限开启,可以跳转应用设置界面,亦可以跳转单独的创建桌面快捷方式权限设置界面
应用设置界面 创建桌面快捷方式权限界面

参数

  • 创建ShortcutInfoCompat对象,必须包含ID,Intent,ShortLable三个参数。ID是唯一性,Intent是点击桌面快捷方式图标后的跳转意图,ShortLable是所创建的快捷方式显示的名称。
    /**
     * Builder class for {@link ShortcutInfoCompat} objects.
     */
    public static class Builder {

        private final ShortcutInfoCompat mInfo;

        public Builder(@NonNull Context context, @NonNull String id) {
            mInfo = new ShortcutInfoCompat();
            mInfo.mContext = context;
            mInfo.mId = id;
        }
        ...
        ...
        /**
         * Creates a {@link ShortcutInfoCompat} instance.
         */
        @NonNull
        public ShortcutInfoCompat build() {
            // Verify the arguments
            if (TextUtils.isEmpty(mInfo.mLabel)) {
                throw new IllegalArgumentException("Shortcut must have a non-empty label");
            }
            if (mInfo.mIntents == null || mInfo.mIntents.length == 0) {
                throw new IllegalArgumentException("Shortcut must have an intent");
            }
            return mInfo;
        }
    }
  • Icon不是必须的,如果没有主动设置则显示默认图标。这里特别提出Icon,是由于 Android 8.0(API 级别 26)引入了自适应启动器图标,在不同设备型号上显示为不同的形状。如果设置的Icon是圆形、圆角都可能被系统调整后包了一层白边。如果设置Icon是正方形则可能某些机型直接显示为正方形。
厂商 图标表现形式 预期表现形式
华为
小米

这样我们要解决一个问题:

  1. 如何让创建的桌面快捷方式图标与App图标保持一致
    将设置图标缩放为App图标的大小,然后合并绘制两个图标,取两者重合保留设置图标内容

唯一性

  根据ShortcutInfoCompat#Builder(@NonNull Context context, @NonNull String id)设置的ID可以标识每一个快捷方式。可是,华为8.0 ~ 8.1出现了一个bug,名称一致也认为是相同的快捷方式,在9.0之后就已修复。
这样我们要解决一个问题:

  1. 如何解决华为8.0 - 8.1这两个版本因为名称相同导致无法创建快捷方式的异常
    遍历已有快捷方式,是否存在相同名称的快捷方式,存在则对准备创建的快捷方式改名,目前在后面加一个“.”(当然可以UUID确保完全不一样),等待创建成功的回调后,再默默根据ID对快捷方式进行更新名称操作

点击快捷方式打开App

  点击快捷方式,打开的意图是所设置的Intent,Sample给的方法是跳转一个透明界面,然后进行逻辑处理。从抽屉式中的通知、桌面快捷方式、微件等端外进入App都可以跳转透明的界面再分发做处理。

shortcut's People

Contributors

scauzhangpeng avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.