参考:https://blog.csdn.net/qibin0506/article/details/52878690
我这里就不解释什么是Shortcuts了,有什么不理解的看上面的地址,我这里只说如何实现,总结一下内容。
一、静态注册
第一步:在res/xml
目录下创建一个新的xml文件, 这里我们命名为shortcuts.xml
<?xml version ="1.0" encoding ="utf-8"?>
https://developer.android.com/guide/actions/index.html -->
<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
<shortcut
android:shortcutId="home"
android:enabled="true"
android:icon="@mipmap/ic_launcher"
android:shortcutShortLabel="@string/short_name"
android:shortcutLongLabel="@string/long_name"
android:shortcutDisabledMessage="@string/no_name">
<intent
android:action="android.intent.action.VIEW"
android:targetPackage="com.example.myshortcuts"
android:targetClass="com.example.myshortcuts.HomeActivity" />
<categories android:name="android.shortcut.conversation"/>
</shortcut>
</shortcuts>
首先一个shortcuts
标签, 然后是一个shortcut
, 到这里我们大概可以猜测到这里可以注册多个shortcut
, shortcut
标签有很多属性, 我们来一个个的了解下.
1. shortcutId, 不用多说, 这肯定是一个唯一的id
2. enabled, 表示这个shortcut是否可用
3. icon,文本提示语句旁边的图标
4. shortcutShortLabel, 这里是配置的短名称, 下面还会有长名称, 如果长名称显示不下, 就显示短名称
5. shortcutLongLabel, 这里是配置的长名称, launcher会优先选择长名称显示
6. shortcutDisabledMessage, 这个配置是在我们选择一个不可用的shortcut时给用户的一个提示
7. intent, 这里表示我们点击shortcut时要干嘛
8. targetPackage是指定一个目标应用的包名
9. targetClass是我们要跳转的目标类, 这里要注意的是android:action一定要配置, 否则会崩溃
10. categories, 这个东西目前位置官方只给提供了android.shortcut.conversation
注意:shortcutShortLabel、shortcutLongLabel、shortcutDisabledMessage必须用string引入文本内容,不能直接输入文本。
第二步:配置清单文件。必须在有<action android:name="android.intent.action.MAIN" />和<category android:name="android.intent.category.LAUNCHER" />的Activity中配置。
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:supportsRtl="true"
android:theme="@style/AppTheme">
<activity android:name=".MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
<meta-data
android:name="android.app.shortcuts"
android:resource="@xml/shortcuts" />
</activity>
</application>
大功告成,静态配置就到这里。
二、动态配置
1.动态配置一个
@SuppressLint("NewApi")
private void initData() {
mShortcutManager = getSystemService(ShortcutManager.class);
List<ShortcutInfo> infos = new ArrayList<>();
Intent intent = new Intent(this, MessageActivity.class);
intent.setAction(Intent.ACTION_VIEW);
intent.putExtra("msg", "哈哈哈");
ShortcutInfo info = new ShortcutInfo.Builder(this, "id")
.setShortLabel("哈")
.setLongLabel("联系人:哈哈哈")
.setIcon(Icon.createWithResource(this, R.mipmap.ic_launcher_round))
.setIntent(intent)
.build();
infos.add(info);
mShortcutManager.setDynamicShortcuts(infos);
}
2. 动态配置多个(最多四个)
@SuppressLint("NewApi")
private void setupShortcuts() {
for (int i = 0; i < 4; i++) {
list.add("条目"+i);
}
mShortcutManager = getSystemService(ShortcutManager.class);
List<ShortcutInfo> infos = new ArrayList<>();
for (int i = 0; i < mShortcutManager.getMaxShortcutCountPerActivity(); i++) {//mShortcutManager.getMaxShortcutCountPerActivity()表示快捷方式的最大个数
Intent intent = new Intent(this, MessageActivity.class);
intent.setAction(Intent.ACTION_VIEW);
intent.putExtra("msg", "我和" + list.get(i) + "的对话");
ShortcutInfo info = new ShortcutInfo.Builder(this, "id" + i)
.setShortLabel(list.get(i))
.setLongLabel("联系人:" + list.get(i))
.setIcon(Icon.createWithResource(this, R.mipmap.ic_launcher_round))
.setIntent(intent)
.build();
infos.add(info);
}
mShortcutManager.setDynamicShortcuts(infos);
}
3. 删除和禁止Item
private void removeItem() {
List<ShortcutInfo> infos = mShortcutManager.getPinnedShortcuts();
for (ShortcutInfo info : infos) {
if (info.getId().equals("id")) {
mShortcutManager.disableShortcuts(Arrays.asList(info.getId()), "暂无该联系人");//删除和禁止后,再次点击的提示文本内容
}
}
mShortcutManager.removeDynamicShortcuts(Arrays.asList("id"));
}
4. 修改了某个条目后,shortcut也应该相应的修改
private void initData() {
mShortcutManager = getSystemService(ShortcutManager.class);
List<ShortcutInfo> infos = new ArrayList<>();
Intent intent = new Intent(this, HomeActivity.class);
intent.setAction(Intent.ACTION_VIEW);
intent.putExtra("msg", "嘿嘿嘿");
ShortcutInfo info = new ShortcutInfo.Builder(this, "id1")
.setShortLabel("涛")
.setLongLabel("联系人:嘿嘿嘿!!!")
.setIcon(Icon.createWithResource(this, R.mipmap.ic_launcher_round))
.setIntent(intent)
.build();
infos.add(info);
mShortcutManager.updateShortcuts(Arrays.asList(info));
}
OK,就这样了。