你可以为你的应用发布以下类型的快捷方式
- 静态的快捷方式: 其直接会打包到 apk 或 apk bundle 中,安装完应用便存在快捷方式入口。
- 动态的快捷方式: 只有在应用运行时才会创建,可以随时的更新、添加和删除对应的快捷方式。
- 桌面快捷方式: 必须在用户授权的情况下,可以主动的添加快捷方式到桌面,同样可以拷贝动态和静态的快捷方式到桌面。
Shortcuts 限制条件
虽然对于一个应用程序一般可以创建五个快捷方式,其中包括静态和动态的,但是但多数的设备上只能展示** 四个**。
但是桌面快捷方式是不做限制的,不过桌面快捷方式非用户主动删除的话,是没法移除的,只能通过禁用的方式让该桌面快捷方式失效。
##使用
快捷方式可以帮助用户快速访问常用的路径和页面,从而为用户提供特定类型的内容。
Shortcuts 类型选择
那该如何选择快捷方式类型,这取决你的快捷方式是应用驱动还是用户驱动。虽然静态快捷方式意图不可更改,动态的可更改,但是这两种都是属于应用驱动。如果用户想自定义想要的意图,通过桌面快捷方式形式的展现,那这就是用户驱动。
怎么理解呢?用简书作为例子进行讲解:
静态快捷方式: 这种最适合那种在整个程序的生命周期中,意图不会改变,始完成整同一种行为。鉴于程序一般只能显示四个快捷方式,那静态的快捷方式一般对于那种比较常见的行为非常有用和有必要。
例如上图简书中,像「搜索」入口就比较常见,不需要传递参数或传递的参数不会改变,那这种就建议使用静态快捷方式。
动态快捷方式: 这种一般对意图较为敏感的操作。意图可能在应用运行中发生改变,需要更新快捷方式。
例如简书入口中的 「我的公开文章」,因为多账号的原因,可能切换账号,那跳转的页面所携带的参数就会改变,快捷方式就需要更新,这种就需要使用静态快捷方式。
桌面快捷方式: 这种允许用户自定义跳转意图。
例如简书支持将关注的人创建快捷方式到桌面,下次直接可以访问该人的动态信息,这种完全是用户自发的创建,所以使用桌面快捷方式。
Shortcuts 类型创建
有了上述类型的具体描述,下面针对这三种快捷方式的创建进行例子介绍。
创建静态快捷方式
静态快捷方式提供应用程序内的通用跳转,这些一般在整个程序的生命周期内是保持不变的。
通过以下步骤完成静态快捷方式的创建:
-
在 AndroidManifest.xml 中找到配置 android.intent.action.MAIN 和 android.intent.category.LAUNCHER 的 Activity。
-
添加 元素到 Activity 中
创建新的资源文件:res/xml/shortcuts.xml
<?xml version="1.0" encoding="utf-8"?>具体参数配置说明如下:
如果有数据的传递,要有对应的解析
if (getIntent().getData() != null && TextUtils.equals(getIntent().getAction(), Intent.ACTION_VIEW)) {
Uri uri = getIntent().getData();
List pathSegments = uri.getPathSegments();
if (pathSegments != null && pathSegments.size() > 0) {
tvTest.setText(pathSegments.get(0));
}
}
最终的运行效果:
创建动态快捷方式
动态快捷方式提供向指向应用内特定的跳转或数据传递,这些跳转和数据可能会在应用执行中发生变化。
此时需要借助 ShortcutManager 提供的 API 来完成动态快捷方式的相应操作:
- 创建: 使用 setDynamicShortcuts() 重新定义动态快捷方式的完整列表
- 添加: 使用 addDynamicShortcut() 来扩充现有的动态快捷方式列表
- **更新: **使用 updateShortcuts() 方法进行更新现有的动态快捷方式列表
- 删除: 使用 removeDynamicShortcuts() 移除一组动态快捷方式,或者使用 removeAllDynamicShortcuts() 移除所有动态快捷方式
以创建为例,其他差不多,自行尝试,具体的操作可参考下面的代码:
1. 创建 ShortcutInfo 对象
@TargetApi(Build.VERSION_CODES.N_MR1)
private ShortcutInfo createShortcutInfo1() {
return new ShortcutInfo.Builder(this, ID_DYNAMIC_1)
.setShortLabel(getString(R.string.dynamic_shortcut_short_label1))
.setLongLabel(getString(R.string.dynamic_shortcut_long_label1))
.setIcon(Icon.createWithResource(this, R.drawable.add))
.setIntent(new Intent(Intent.ACTION_VIEW, Uri.parse(“http://xiaweizi.cn/”)))
.build();
}
2. 调用 setDynamicShortcuts() 覆盖掉之前的,重新设置新的动态快捷方式列表
private void setDynamicShortcuts() {
if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.N_MR1) {
ShortcutManager shortcutManager = getSystemService(ShortcutManager.class);
List shortcutInfo = new ArrayList<>();
shortcutInfo.add(createShortcutInfo1());
shortcutInfo.add(createShortcutInfo2());
if (shortcutManager != null) {
shortcutManager.setDynamicShortcuts(shortcutInfo);
}
}
}
3. 可以配置 label 的字体颜色
@TargetApi(Build.VERSION_CODES.N_MR1)
private ShortcutInfo createShortcutInfo2() {
Intent intent = new Intent(this, TestActivity.class);
intent.setAction(Intent.ACTION_VIEW);
intent.putExtra(“key”, “fromDynamicShortcut”);
ForegroundColorSpan colorSpan = new ForegroundColorSpan(Color.BLUE);
String label = getResources().getString(R.string.dynamic_shortcut_short_label2);
SpannableStringBuilder colouredLabel = new SpannableStringBuilder(label);
colouredLabel.setSpan(colorSpan, 0, label.length(), Spanned.SPAN_INCLUSIVE_INCLUSIVE);
return new ShortcutInfo.Builder(this, ID_DYNAMIC_2)
.setShortLabel(colouredLabel)
.setLongLabel(getString(R.string.dynamic_shortcut_long_label2))
.setIcon(Icon.createWithResource(this, R.drawable.link))
.setIntent(intent)
.build();
}
最终的运行效果:
创建桌面快捷方式
在 Android 8.0(API26)或者更高的版本上,可以创建桌面快捷方式。与静态和动态快捷方式不同,桌面快捷方式支持在设备上单独的 icon 展示。
如果想创建桌面快捷方式,按照以下步骤进行完成:
1. 使用 isRequestPinShortcutSupported() 来验证设备是否支持应用创建桌面快捷方式
2. 根据快捷方式是否已经存在,用下面两种方式之一来创建 ShortcutInfo 对象:
3. 如果快捷方式已经存在,请创建仅包含现有快捷方式 id 的 ShortcutInfo 对象,系统自动查找并带上与快捷方式有关的所有相关数据
**4.**如果要固定新的快捷方式,请创建一个 ShortcutInfo 对象,其中包含新的快捷方式 id、意图和短标签
5. 尝试通过调用 requestPinShortcut() 将快捷方式固定到设备桌面上,在此过程中,可以传入 pendingIntent 对象,该对象仅在快捷方式成功固定时告知应用。
具体的代码可参考下面:
private void createPinnedShortcuts() {
if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.O) {
ShortcutManager shortcutManager = getSystemService(ShortcutManager.class);
if (shortcutManager != null && shortcutManager.isRequestPinShortcutSupported()) {
Intent intent = new Intent(this, TestActivity.class);
intent.setAction(Intent.ACTION_VIEW);
intent.putExtra(“key”, “fromPinnedShortcut”);
ShortcutInfo pinShortcutInfo = new ShortcutInfo.Builder(this, “my-shortcut”)
.setShortLabel(getString(R.string.pinned_shortcut_short_label2))
.setLongLabel(getString(R.string.pinned_shortcut_long_label2))
.setIcon(Icon.createWithResource(this, R.drawable.add))
.setIntent(intent)
.build();
Intent pinnedShortcutCallbackIntent = shortcutManager.createShortcutResultIntent(pinShortcutInfo);
PendingIntent successCallback = PendingIntent.getBroadcast(this, 0,
pinnedShortcutCallbackIntent, 0);
boolean b = shortcutManager.requestPinShortcut(pinShortcutInfo, successCallback.getIntentSender());
Utils.showToast(this, "set pinned shortcuts " + (b ? “success” : “failed”) + “!”);
}
}
}
最终运行效果:
好了,基础简单的使用就介绍到这了,相信对 Shortcuts 的使用场景和具体实现都有一定的了解了,接下来开始介绍进阶的使用。
##Shortcuts进阶使用
快捷方式创建完成后,可能还需要对其进行管理,比如动态更新或者禁用某些快捷方式,此时就需要了解一些进阶的使用了。
移除 Shortcut
对于 静态快捷方式 而言,其在一开始就打包到了 apk 或者 apk bundle 中,是不允许对其进行更改的,除非发布新的版本覆盖掉之前的快捷方式,不然会一直存在。
对于 动态快捷方式 ,既然可以在代码中进行创建,同样也可以在代码中进行移除,这个之前也介绍过。
而对于 桌面快捷方式,它直接展示在桌面上,始终可见,仅在以下情况才能删除桌面快捷方式。
- 用户主动移除
- 卸载与快捷方式的应用
- 用户在应用信息中,清除全部的缓存数据
Shortcut 展示顺序
对于一个应用上所有的快捷方式,展示的规则按照以下顺序:
- 静态快捷方式: isDeclaredInManifest() 放回 true 的快捷方式
- 动态快捷方式:ShortcutInfo.isDynamic() 返回 true 的快捷方式
在每种快捷方式中,又会按照 ShortcutInfo.getRank() 按等级递增的顺序排序。等级是非负的,连续的整数, 调用 updateShortcuts(List),addDynamicShortcuts(List) 或 setDynamicShortcuts(List) 时,可以更新现有快捷方式的等级。
排名是自动调整的,因此它们对于每种类型的快捷方式都是唯一的。 例如,有三个 rank 分别为 0、1和2 的动态快捷方式,此时再添加一个 rank 为 1 的动态快捷方式放在第二的位置上,那最后两个就会被顺延一个位置,rank 变成 2和3。
Shortcut intents 配置
如果希望应用在用户激活快捷方式时执行多项操作,则可以将其配置为触发后多项活动。你可以通过分配多个 intent,启动一个 activity 到另一个 activity,具体的要取决你快捷方式的类型。
使用 ShortcutInfo.Builder 创建快捷方式时,可以使用 setIntents() 而不是 setIntent()。通过调用 setIntents() 你可以在用户点击快捷方式时触发多个 activity,将除列表中最后一个 activity 之外的所有 activity 放在后续堆栈中。如果此时点击返回按钮,会按照之前存储的堆栈 activity 顺序进行展示,而不是直接回到首页。
比如按照下面代码配置多个 intent:
@TargetApi(Build.VERSION_CODES.N_MR1)
private ShortcutInfo createShortcutInfo1() {
Intent intent1 = new Intent(Intent.ACTION_VIEW, Uri.parse(“http://xiaweizi.cn/”));
Intent intent = new Intent(this, TestActivity.class);
intent.setAction(Intent.ACTION_VIEW);
intent.putExtra(“key”, “fromDynamicShortcut”);
return new ShortcutInfo.Builder(this, ID_DYNAMIC_1)
.setShortLabel(getString(R.string.dynamic_shortcut_short_label1))
.setLongLabel(getString(R.string.dynamic_shortcut_long_label1))
.setIcon(Icon.createWithResource(this, R.drawable.add))
.setIntents(new Intent[]{intent, intent1})
.build();
}
那么它会一次触发 intent 和 intent1,此时 intent 被压入 intent1 的栈底,点击返回,则展示 intent 的信息。如图:
还有一个问题,静态快捷方式是不能拥有自定的 intent flag 的,静态快捷方式始终设置为 Intent.FLAG_ACTIVITY_NEW_TASK 和 Intent.FLAG_ACTIVITY_CLEAR_TASK 这意味着,当应用程序已经在运行时,启动静态快捷方式时,应用中所有的活动都将被销毁。
如果不希望出现这种情况,可以使用 trampoline activity,或者在 Activity.onCreate(Bundle) 中启动一个 不可见的 activity,然后调用 Activity.finish()。
1. 在 AndroidManifest.xml 中, trampoline activity 应用设置 android:taskAffinity=“”。
2. 在快捷方式资源文件中,静态快捷方式中的 intent 应引用 trampoline activity。
最后
在这里我和身边一些朋友特意整理了一份快速进阶为Android高级工程师的系统且全面的学习资料。涵盖了Android初级——Android高级架构师进阶必备的一些学习技能。
附上:我们之前因为秋招收集的二十套一二线互联网公司Android面试真题(含BAT、小米、华为、美团、滴滴)和我自己整理Android复习笔记(包含Android基础知识点、Android扩展知识点、Android源码解析、设计模式汇总、Gradle知识点、常见算法题汇总。)
《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》,点击传送门,即可获取!
之前因为秋招收集的二十套一二线互联网公司Android面试真题(含BAT、小米、华为、美团、滴滴)和我自己整理Android复习笔记(包含Android基础知识点、Android扩展知识点、Android源码解析、设计模式汇总、Gradle知识点、常见算法题汇总。)
[外链图片转存中…(img-l5FbAjK1-1714463226458)]
《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》,点击传送门,即可获取!