android 动态添加快捷方式,Android动态创建快捷方式

一、 摘要

以Android O为分界，介绍两种动态创建快捷方式的途径：广播和ShortcutManager。

二、 Android O以前

在Android O(8.0)以前，动态创建快捷方式是通过发送广播实现的：

// 由该action可知，我们的创建快捷方式广播会由launcher，也就是系统桌面来接收

public static final String ACTION_INSTALL_SHORTCUT = "com.android.launcher.action.INSTALL_SHORTCUT";

public void createShortcutBelowO(Context ctx, String name, Bitmap icon) {

Intent shortcutIntent = new Intent(ACTION_INSTALL_SHORTCUT);

// 快捷方式的名字

shortcutIntent.putExtra(Intent.EXTRA_SHORTCUT_NAME, name);

// 快捷方式的bitmap尽可能小，因为广播内容超过2MB会抛出异常

shortcutIntent.putExtra(Intent.EXTRA_SHORTCUT_ICON, icon);

// 设置是否允许重复创建快捷方式，该选项非必填，默认是允许

shortcutIntent.putExtra("duplicate", false);

// 快捷方式执行的intent，比如启动应用在AndroidManifest中配置的入口Activity

Intent launchIntent = new Intent();

launchIntent.setClass(ctx, "com.zengyu.shortcutdemo");

shortcutIntent.putExtra(Intent.EXTRA_SHORTCUT_INTENT, launchIntent);

ctx.sendBroadcast(shortcutIntent);

}

三、 Android O以后

Android O(8.0)新增了一个叫ShortcutManager的类：

/**

* The ShortcutManager manages an app's shortcuts. Shortcuts provide users

* with quick access to activities other than an app's main activity in the currently-active

* launcher. For example,

* an email app may publish the "compose new email" action, which will directly open the

* compose activity. The {@link ShortcutInfo} class contains information about each of the

* shortcuts themselves.

*/

ShortcutManager管理应用的快捷方式。快捷方式为用户提供了一个访问应用的快速渠道。ShortcutInfo类包含了每个快捷方式的信息。

在ShortcutManager的API文档中，其实已经有详细的静态创建和动态创建的介绍，以及创建的具体步骤，但在此我还是以一个简单的例子，直观地展示使用ShortcutManager动态创建：

public void createShortcutAboveO(Context ctx, String name, Bitmap icon) {

ShortcutManager shortcutManager = (ShortcutManager) ctx.getSystemService(Context.SHORTCUT_SERVICE);

/**

* 判断是否支持该方式动态创建

*/

if (shortcutManager.isRequestPinShortcutSupported()) {

// 快捷方式执行的intent，比如启动应用在AndroidManifest中配置的入口Activity

Intent launchIntent = new Intent();

launchIntent.setClass(ctx, "com.zengyu.shortcutdemo");

ShortcutInfo.Builder builder = new ShortcutInfo.Builder(context, pkg)

.setShortLabel(name)

.setIcon(Icon.createWithBitmap(icon))

.setIntent(launchIntent);

/**

* 第二个参数为弹出创建快捷方式确认框时的回调PendingIntent，此例不关注该回调，因此为null，

* 如果需要监听该回调，需要自定义一个BroadcastReceiver，可参考参考文献中的例子

*/

shortcutManager.requestPinShortcut(builder.build(), null);

}

}

其中isRequestPinShortcutSupported方法：

/**

* Return {@code TRUE} if the app is running on a device whose default launcher supports

* {@link #requestPinShortcut(ShortcutInfo, IntentSender)}.

*

*

The return value may change in subsequent calls if the user changes the default launcher

* app.

*

*

Note: See also the support library counterpart

* {@link android.support.v4.content.pm.ShortcutManagerCompat#isRequestPinShortcutSupported(

* Context)}, which supports Android versions lower than {@link VERSION_CODES#O} using the

* legacy private intent {@code com.android.launcher.action.INSTALL_SHORTCUT}.

*

* @see #requestPinShortcut(ShortcutInfo, IntentSender)

*/

public boolean isRequestPinShortcutSupported() {

try {

return mService.isRequestPinItemSupported(injectMyUserId(),

LauncherApps.PinItemRequest.REQUEST_TYPE_SHORTCUT);

} catch (RemoteException e) {

throw e.rethrowFromSystemServer();

}

}

判断设备是否支持ShortcutManager的这种方式动态创建快捷方式，如果Android版本低于Android O，使用“com.android.launcher.action.INSTALL_SHORTCUT”这个intent，即我们在上一节中使用的action。因此，如果这个方法返回false，我们应该仍使用广播的方式来动态创建。

四、 参考文献

Android 8.0 快捷方式Shortcut