背景

    在Android设备上，为某个应用创建一个特定的快捷方式，可以快速进入应用的某个操作，比如浏览器将某个页面收藏到桌面，点击桌面的快捷方式直接打开页面。

代码实现

    添加桌面图标快捷方式代码非常简单，在API 26（Android O）以下的版本，并没有提供API进行创建桌面快捷方式，但是用户可以通过广播的方式创建桌面快捷方式。在API 26（Android O）及以上版本的系统，对开发者开放了快捷方式的相关API，可以调用API直接创建快捷方式。

 

    其实发送广播的方式创建快捷方式，是发送一个广播给桌面应用Launcher接收，Launcher收到广播后创建应用。

 

实现代码

/** * 添加桌面图标快捷方式 * @param activity Activity对象 * @param name 快捷方式名称 * @param icon 快捷方式图标 * @param actionIntent 快捷方式图标点击动作 */ public void addShortcut(Activity activity, String name, Bitmap icon, Intent actionIntent) { if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) { // 创建快捷方式的intent广播 Intent shortcut = new Intent("com.android.launcher.action.INSTALL_SHORTCUT"); // 添加快捷名称 shortcut.putExtra(Intent.EXTRA_SHORTCUT_NAME, name); // 快捷图标是允许重复(不一定有效) shortcut.putExtra("duplicate", false); // 快捷图标 // 使用资源id方式 // Intent.ShortcutIconResource iconRes = Intent.ShortcutIconResource.fromContext(activity, R.mipmap.icon); // shortcut.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE, iconRes); // 使用Bitmap对象模式 shortcut.putExtra(Intent.EXTRA_SHORTCUT_ICON, icon); // 添加携带的下次启动要用的Intent信息 shortcut.putExtra(Intent.EXTRA_SHORTCUT_INTENT, actionIntent); // 发送广播 activity.sendBroadcast(shortcut); } else { ShortcutManager shortcutManager = (ShortcutManager) activity.getSystemService(Context.SHORTCUT_SERVICE); if (null == shortcutManager) { // 创建快捷方式失败 Log.e("MainActivity", "Create shortcut failed"); return; } ShortcutInfo shortcutInfo = new ShortcutInfo.Builder(activity, name) .setShortLabel(name) .setIcon(Icon.createWithBitmap(icon)) .setIntent(actionIntent) .setLongLabel(name) .build(); shortcutManager.requestPinShortcut(shortcutInfo, PendingIntent.getActivity(activity, RC_CREATE_SHORTCUT, actionIntent, PendingIntent.FLAG_UPDATE_CURRENT).getIntentSender()); } }

配置权限

    实现创建桌面快捷方式的功能，还需要在AndroidManifest.xml中配置权限，配置的权限是与Launcher的相关权限

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

注意：使用较高版本的buildTool的时候，在AndroidManifest.xml中配置权限的时候，能投提示有两个关于快捷方式的两个权限（安装和卸载），但是在低版本系统中会无效。

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

    根据查看API文档发现，这两个权限是在API 19才加进去的，再看看对应的值，其实和上面配置的是一样的，`android.permission.INSTALL_SHORTCUT`对应的值是`com.android.launcher.permission.INSTALL_SHORTCUT`，`android.permission.UNINSTALL_SHORTCAT`对应的值是`com.android.launcher.permission.UNINSTALL_SHORTCUT`，所以在AndroidManifest.xml中配置对应的值才能正常工作，为了兼容性，建议同时将这四个都加进去。

 

存在问题

    创建桌面快捷方式在碎片化的Android设备上，也不一定可以成功，特别是前一种使用广播的方式进行创建，在某些深度定制的ROM上容易出现失败，后一种方式没有经过验证，大家有条件可以对比一下。