Android7.1(API25)开始推出新的功能Shortcuts,通过ShortcutManager进行管理
1.Static Shortcuts
静态注册即利用xml进行注册:
在res/xm下新建shortcuts.xml,其中的属性
shortcutId 一个唯一的id
enabled, 表示这个shortcut是否可用
shortcutShortLabel, 这里是配置的短名称, 下面还会有长名称, 如果长名称显示不下, 就显示短名称
shortcutLongLabel, 这里是配置的长名称, launcher会优先选择长名称显示
shortcutDisabledMessage, 这个配置是在我们选择一个不可用的shortcut时给用户的一个提示
intent, 这里表示我们点击shortcut时要干嘛, targetPackage是指定一个目标应用的包名, targetClass是我们要跳转的目标类, 这里要注意的是android:action一定要配置, 否则会崩溃
categories, 这个东西目前位置官方只给提供了android.shortcut.conversation
能配置shortcuts的activity必须要有action是android.intent.action.MAIN和category是android.intent.category.LAUNCHER!
最后在Activity的Manifest中
2.Dynamic Shortcuts
动态添加shortCut
private void addDynamicShortcut() {
ShortcutManager shortcutManager = (ShortcutManager) getSystemService(SHORTCUT_SERVICE);
//最大添加的个数,即多了会添加不上
int maxAddSize = shortcutManager.getMaxShortcutCountPerActivity();
Intent intent =new Intent(this, MainActivity.class);
intent.setAction("cn.wx.test");
ShortcutInfo shortcutInfo =new ShortcutInfo.Builder(this, "id123")
.setShortLabel("ShortLabel")
.setLongLabel("LongLabel")
.setIcon(Icon.createWithResource(this, R.mipmap.ic_launcher))
.setIntent(intent)
.build();
List infoList =new ArrayList<>();
infoList.add(shortcutInfo);
//shortcutManager.addDynamicShortcuts(Arrays.asList(shortcutInfo));
shortcutManager.setDynamicShortcuts(infoList);
}
//DynamicShortcut是可以拖到桌面的,此时就是pinShortcut,此时移除可以通过
private void removeDynamicShortcut() {
ShortcutManager shortcutManager = (ShortcutManager) getSystemService(SHORTCUT_SERVICE);
List infoList = shortcutManager.getPinnedShortcuts();
for (ShortcutInfo shortcutInfo : infoList) {
if("id123".equals(shortcutInfo.getId())) {
shortcutManager.disableShortcuts(Arrays.asList(shortcutInfo.getId(), "暂不支持此功能"));
}
}
shortcutManager.removeDynamicShortcuts(Arrays.asList("id123"));
}
private void updateDynamicShortcut(String id ) {
ShortcutManager shortcutManager = (ShortcutManager) getSystemService(SHORTCUT_SERVICE);
Intent intent =new Intent(this, MainActivity.class);
intent.setAction("cn.wx.test");
ShortcutInfo shortcutInfo =new ShortcutInfo.Builder(this, id)
.setShortLabel("ShortLabel_new")
.setLongLabel("LongLabel_new")
.setIcon(Icon.createWithResource(this, R.mipmap.ic_launcher))
.setIntent(intent)
.build();
shortcutManager.updateShortcuts(Arrays.asList(shortcutInfo));
}
API 26上,ShortcutManager新增了对Pinned Shortcuts(固定快捷方式) 的管理。
增加了isRequestPinShortcutSupported、requestPinShortcut、createShortcutResultIntent三个方法。
isRequestPinShortcutSupported()判断是否支持添加pinned shortcut。
requestPinShortcut()请求创建固定快捷方式。
例如:
private void addPinnedShortcut() {
ShortcutManager shortcutManager = (ShortcutManager) getSystemService(SHORTCUT_SERVICE);
if(shortcutManager.isRequestPinShortcutSupported()) {
Intent intent =new Intent(Intent.ACTION_MAIN);
intent.addCategory(Intent.CATEGORY_LAUNCHER);
ComponentName component =new ComponentName(getPackageName(), MainActivity.class.getName());
intent.setComponent(component);
ShortcutInfo info =new ShortcutInfo.Builder(this, mId)
.setIcon(Icon.createWithResource(this, R.mipmap.ic_launcher))
.setShortLabel("My shortcut")
.setIntent(intent)
.build();
Intent reIntent =new Intent(this, MyBroadcastReceiver.class);
reIntent.setAction("wx_add_shortcut");
PendingIntent pendingIntent = PendingIntent.getBroadcast(this,0 , reIntent, PendingIntent.FLAG_UPDATE_CURRENT);
shortcutManager.requestPinShortcut(info, pendingIntent.getIntentSender());
}
}
private class MyBroadcastReceiverextends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
Log.e("wx", "onReceive");
}
}
//请求后会通过ShortcutManager发出Action(android.content.pm.action.CONFIRM_PIN_SHORTCUT),桌面会适配此Action启动Activity,确定添加成功后回调发送广播到传入的接受器。
getPinnedShortcuts();可以返回当前应用已经添加shortcut。
当然启动shortcut只有默认launcher次可以启动,系统里有做是否默认launcher的判断,其他应用没有权限启动。
当然还有其他方式,因为launcher的其他实质也是通过shortcutManager做个控制,最终调用的也是startActivity,所以如果你能把shortcutInfo对象存储的相关Intent信息拼接起来也可以启动。
例如常用的微信快捷方式启动可以通过如下方式:
Intent intent =new Intent();
intent.setAction("com.tencent.mm.action.BIZSHORTCUT");
intent.setPackage("com.tencent.mm");
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);
intent.putExtra("LauncherUI.From.Biz.Shortcut", true);
intent.putExtra("app_shortcut_custom_id", "shortcut_500ac29cc3993fc28dc387c28bc289c3ab48c28559c38a0c70013cc3b1");
intent.putExtra("LauncherUI.Shortcut.Username", "shortcut_500ac29cc3993fc28dc387c28bc289c3ab48c28559c38a0c70013cc3b1");
startActivity(intent);