Android 生成桌面快捷方式是这样做的

5,434 阅读2分钟

关于生成桌面快捷方式,Android提供了原生的api方法。下边就介绍一下兼容8.0的具体做法。

一、首先当然是关于快捷方式的权限了。

我们需要在AndroidManifest文件中添加以下权限:

    <uses-permission android:name="com.android.launcher.permission.WRITE_SETTINGS" />
    <!-- 添加快捷方式 -->
    <uses-permission android:name="com.android.launcher.permission.INSTALL_SHORTCUT" />
    <!-- 移除快捷方式 -->
    <uses-permission android:name="com.android.launcher.permission.UNINSTALL_SHORTCUT" />
    <!-- 查询快捷方式 -->
    <uses-permission android:name="com.android.launcher.permission.READ_SETTINGS" />

二、在需要生成桌面快捷方式处调用以下代码

 /**
     * 添加快捷方式
     */
    public void addShortCutCompact(Bitmap bitmap) {
        //启动器是否支持添加快捷方式
        if (ShortcutManagerCompat.isRequestPinShortcutSupported(mContext)) {
            Intent shortcutInfoIntent = new Intent(mContext, TestActivity.class);
             //这里直接传一个对象报错,现在转成json传过去
            Gson gson = new Gson();
            String json = gson.toJson(ShortcutBean);
            shortcutInfoIntent.putExtra(SHORTCUT_BEAN,json );
            shortcutInfoIntent.putExtra(IS_SHORTCUT, true);
            //action必须设置,不然报错
            shortcutInfoIntent.setAction(Intent.ACTION_VIEW);
            shortcutInfoIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
            shortcutInfoIntent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);

            ShortcutInfoCompat info = new ShortcutInfoCompat.Builder(mContext, "mama_id")
                    //设置图标icon
                    .setIcon(Icon.createWithResource(context, R.drawable.icon))
                    //设置名称
                    .setShortLabel("快捷方式名称")
                    .setIntent(shortcutInfoIntent)
                    .build();
                    
            //创建快捷方式
            ShortcutManagerCompat.requestPinShortcut(mContext, info,null);

        } else {
            ToastUtil.showMsg("启动器不支持固定快捷方式");
        }
    }

三、注意点

1、点击桌面快捷方式跳转到目标页面就是上边代码例子中的TestActivity时,如果有业务需要做一些统计之类的操作,我们可以传递一些数据进行操作,这里可以直接传递基本数据类型,但是如果想直接传递一个bean对象时,是不支持的,需要我们转成json传递。

2、shortcutInfoIntent.setAction(Intent.ACTION_VIEW);是必须设置的。

3、桌面快捷方式的图标不支持网络地址图片,如果想要从接口获取动态设置需要先下载下来为一个bitmap。用setIcon(IconCompat.createWithBitmap(bitmap))方法来设置。 关于下载网络图片我们有很多方法,这里是用glide下载,列子代码:

 /**
     *  下载快捷方式icon
     */
    private void downShortcutICon() {
        final Bitmap[] bitmap = new Bitmap[1];
        //先下载图标 转为bitMap
        Glide.with(mContext).asBitmap().load(addIcon.getAppIcon()).into(new SimpleTarget() {
            @Override
            public void onResourceReady(@NonNull Object resource, @Nullable Transition transition) {

                bitmap[0] = (Bitmap) resource;
                if (bitmap[0] != null) {
                 	addShortCutCompact(bitmap[0]);
                }

            }

        });
    }

4、需要在AndroidManifest中的TestActivity注册中加入 android:exported="true"标签,这个标签是用来表示是否能够被其他应用程序组件调用或跟它交互。

5、另外,如小米、vivo等一些机型需要在设置中手动打开 创建桌面快捷方式权限。