静态配置Shortcut快捷方式

1. 在res/xml目录下声明 shortcuts快捷方式,包含多个shortcut Item,文件名为shortcuts_home.xml

<?xml version="1.0" encoding="utf-8"?>
<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
 <shortcut
 android:enabled="true"
 android:icon="@mipmap/icon_scan"
 android:shortcutDisabledMessage="@string/shortcutDisabledMessage"
 android:shortcutId="scan"
 android:shortcutLongLabel="@string/title_scan"
 android:shortcutShortLabel="@string/title_scan">
 <intent
 android:action="android.intent.action.VIEW"
 android:targetClass="com.keno.shortcuts.ScanActivity"
 android:targetPackage="com.keno.shortcuts" />
 <categories android:name="android.shortcut.conversation" />
 </shortcut>
 <shortcut
 android:enabled="true"
 android:icon="@mipmap/icon_wallet"
 android:shortcutDisabledMessage="@string/shortcutDisabledMessage"
 android:shortcutId="wallet"
 android:shortcutLongLabel="@string/title_wallet"
 android:shortcutShortLabel="@string/title_wallet">
 <intent
 android:action="android.intent.action.VIEW"
 android:targetClass="com.keno.shortcuts.WalletActivity"
 android:targetPackage="com.keno.shortcuts" />
 <categories android:name="android.shortcut.conversation" />
 </shortcut>
 <shortcut
 android:enabled="true"
 android:icon="@mipmap/icon_contact_phone"
 android:shortcutDisabledMessage="@string/shortcutDisabledMessage"
 android:shortcutId="contactPhone"
 android:shortcutLongLabel="@string/title_contact_phone"
 android:shortcutShortLabel="@string/title_contact_phone">
 <intent
 android:action="android.intent.action.VIEW"
 android:targetClass="com.keno.shortcuts.ContactActivity"
 android:targetPackage="com.keno.shortcuts" />
 <categories android:name="android.shortcut.conversation" />
 </shortcut>
</shortcuts>

2. 在AndroidManifest.xml的 启动Activity节点下 指定第一步声明的shortcuts;

<meta-data
 android:name="android.app.shortcuts"
 android:resource="@xml/shortcuts_home" />

<activity android:name=".MainActivity">
 <intent-filter>
 <action android:name="android.intent.action.MAIN" />
 <category android:name="android.intent.category.LAUNCHER" />
 </intent-filter>
 <!--静态声明shortcut-->
 <meta-data
 android:name="android.app.shortcuts"
 android:resource="@xml/shortcuts_home" />
</activity>

完成以上两步后,运行程序,长按桌面图标,就能弹出快捷方式了

动态配置Shortcut快捷方式,支持新增、删除快捷配置

1. 初始化获取,设置默认配置方式

//设置指定动态方式
shortcutManager.setDynamicShortcuts(shortcutInfoList);

@RequiresApi(api = Build.VERSION_CODES.N_MR1)
 private void initShortcuts() {
 ShortcutManager shortcutManager = getSystemService(ShortcutManager.class);
 if (shortcutManager == null) {
 return;
 }
 List<ShortcutInfo> shortcutInfoList = shortcutManager.getDynamicShortcuts();
 if (shortcutInfoList.isEmpty()) {
 shortcutInfoList = new ArrayList<>();
 //构建动态快捷方式的详细信息
 ShortcutInfo shortcutInfoSetting = new ShortcutInfo.Builder(this, ShortcutConfig.SHORTCUT_SETTING)
 .setShortLabel(getString(R.string.title_shortcut_setting))
 .setLongLabel(getString(R.string.title_shortcut_setting))
 .setIcon(Icon.createWithResource(this, R.drawable.ic_settings_black))
 .setIntents(new Intent[]{
 new Intent(Intent.ACTION_MAIN, Uri.EMPTY, this, ShortcutSettingActivity.class)
 })
 .build();
 shortcutInfoList.add(shortcutInfoSetting);
 shortcutManager.setDynamicShortcuts(shortcutInfoList);
 }
 }

2. 新增配置项

/**
 * Publish the list of dynamic shortcuts. If there are already dynamic or pinned shortcuts with
 * the same IDs, each mutable shortcut is updated.
 *
 * <p>This API will be rate-limited.
 *
 * @return {@code true} if the call has succeeded. {@code false} if the call is rate-limited.
 *
 * @throws IllegalArgumentException if {@link #getMaxShortcutCountPerActivity()} is exceeded,
 * or when trying to update immutable shortcuts.
 *
 * @throws IllegalStateException when the user is locked.
 */
public boolean addDynamicShortcuts(@NonNull List<ShortcutInfo> shortcutInfoList) {
 try {
 return mService.addDynamicShortcuts(mContext.getPackageName(),
 new ParceledListSlice(shortcutInfoList), injectMyUserId());
 } catch (RemoteException e) {
 throw e.rethrowFromSystemServer();
 }
}

/***
 * 添加快捷方式配置
 * @param shortcutModelList
 */
@RequiresApi(api = Build.VERSION_CODES.N_MR1)
private void addShortcutSetting(List<ShortcutModel> shortcutModelList) {
 ShortcutManager shortcutManager = (ShortcutManager) getSystemService(SHORTCUT_SERVICE);
 if (shortcutManager == null) {
 return;
 }
 shortcutManager.addDynamicShortcuts(ShortCutBiz.convertToShortcutInfoList(this, shortcutModelList));
}

3. 删除配置项

/***
 * 移除快捷方式配置
 * @param shortcutModelList
 */
@RequiresApi(api = Build.VERSION_CODES.N_MR1)
private void removeShortcutSetting(List<ShortcutModel> shortcutModelList) {
 ShortcutManager shortcutManager = (ShortcutManager) getSystemService(SHORTCUT_SERVICE);
 if (shortcutManager == null) {
 return;
 }
 List<String> shortcutIds = new ArrayList<>();
 for (ShortcutModel shortcutModel : shortcutModelList) {
 shortcutIds.add(shortcutModel.getId());
 }
 shortcutManager.removeDynamicShortcuts(shortcutIds);
}