【详细】长按APP图标弹出快捷方式，ShortCut功能实现 |
您所在的位置：网站首页 › 创建桌面快捷方式是什么功能 › 【详细】长按APP图标弹出快捷方式，ShortCut功能实现 |
【详细】长按APP图标弹出快捷方式，ShortCut功能实现
|
Shortcuts介绍
Android7.1（API Level 25）及以上系统可以自定义Shortcuts，通过在桌面上长按App Icon弹出Shortcut列表，点击某个shortcut可使用户快捷得打开App里常用的或推荐的任务。国内各个厂商基本上在安卓8.0上集成了该功能。见下图  
1.1 Shortcuts的简单作用
每个Shortcut可以关联一个或多个intents，每个intent启动一个指定的action； 官方给出了几个可以作为shortcut的例子，比如： 在地图类app中，指导用户到特定的位置；在社交类app中，发送消息给一个朋友；在媒体类app中，播放视频的下一片段；在游戏类app中，下载最后保存的要点；在实际开发中，我们具体想让哪些操作作为快捷方式，可自行定义。 1.2 静态实现1. 在app的AndroidManifest.xml文件中，找到MainActivity，即设置了action为，且category设置为 的activity；为其添加….指向定义Shortcuts的资源文件。代码如下： 2. 创建定义AppShortcuts的资源文件，res/xml/shortcuts.xml文件 3. 属性讲解 以shortcuts元素为根，可以包含多个shortcut元素，每个shortcut元素标示一个shortcut。其中属性分别标示： shortcutId：shortcut唯一标识符，相同的shortcutId会被覆盖。（必设属性）enable：shortcut是否启用，true启用，false是禁用（若设置为false，不如删除掉该快捷方式）（可选属性）icon：显示在快捷方式左边的图标。（可选属性）shortcutLongLabel：当launcher的空间足够时将会显示shortcut的长文本描述，不宜过长，如果过长或未设置时会显示shortcutShortLabel （可选属性）shortcutShortLabel : shortcut的简要说明，这项是必须的。（必设属性）intent : 这里定义快捷方式被点击之后将会打开的intent （必设属性）shortcutDisabledMessage : 当你禁用了shortcut之后，它将不会显示在用户长按应用图标后打开的快捷方式里，但是用户可以把一个快捷方式拖拽到launcher的某个页面成为Pinned Shortcut，被禁用之后这个快捷方式就会显示为灰色，点击这个Pinned Shortcut则会显示一个内容为shortcutDisabledMessage的Toast。(可选属性) 1.3 动态实现代码创建Dynamic shortcut，需要使用API ShortcutManager和ShortcutInfo.Builder；通过ShortcutInfo.Builder新建ShortcutInfo，再通过ShortcutManager添加即可。动态shortcut可以在运行时动态改变内容，无需重写部署App。下面直接看代码，而不在叙述创建的具体步骤： public class MainActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); //要确保API Level 大于等于 25才可以创建动态shortcut，否则会报异常。 if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1) { initDynamicShortcuts(); } } /** * 为App创建动态Shortcuts */ private void initDynamicShortcuts() { //①、创建动态快捷方式的第一步，创建ShortcutManager ShortcutManager scManager = getSystemService(ShortcutManager.class); //②、构建动态快捷方式的详细信息 ShortcutInfo scInfoOne = new ShortcutInfo.Builder(this, "dynamic_one") .setShortLabel("Dynamic Web site") .setLongLabel("to open Dynamic Web Site") .setIcon(Icon.createWithResource(this, R.mipmap.tool_music_icon)) .setIntent(new Intent(Intent.ACTION_VIEW, Uri.parse("https://www.baidu.com"))) .build(); ShortcutInfo scInfoTwo = new ShortcutInfo.Builder(this, "dynamic_two") .setShortLabel("Dynamic Activity") .setLongLabel("to open dynamic one activity") .setIcon(Icon.createWithResource(this, R.mipmap.tool_luck_icon)) .setIntents(new Intent[]{ new Intent(Intent.ACTION_MAIN, Uri.EMPTY, this, MainActivity.class).setFlags(Intent.FLAG_ACTIVITY_CLEAR_TASK),//加该FLAG的目的是让MainActivity作为根activity，清空已有的任务 new Intent(DynamicASOneActivity.ACTION) }) .build(); //③、为ShortcutManager设置动态快捷方式集合 scManager.setDynamicShortcuts(Arrays.asList(scInfoOne, scInfoTwo)); //如果想为两个动态快捷方式进行排序，可执行下面的代码 ShortcutInfo dynamicWebShortcut = new ShortcutInfo.Builder(this, "dynamic_one") .setRank(0) .build(); ShortcutInfo dynamicActivityShortcut = new ShortcutInfo.Builder(this, "dynamic_two") .setRank(1) .build(); //④、更新快捷方式集合 scManager.updateShortcuts(Arrays.asList(dynamicWebShortcut, dynamicActivityShortcut)); } }ShortcutManager API可以帮助我们实现新建、更新、移除快捷方式的操作： 新建：方法setDynamicShortcuts() 可以添加或替换所有的shortcut；方法addDynamicShortcuts() 来添加新的shortcut到列表中，超过最大个数会报异常更新：方法updateShortcuts(List shortcutInfoList) 更新已有的动态快捷方式；删除：方法removeDynamicShortcuts(List shortcutIds) 根据动态快捷方式的ID，删除已有的动态快捷方式；方法removeAllDynamicShortcuts() 删除掉app中所有的动态快捷方式；List getDynamicShortcuts() ： 得到所有的动态shortcuts； |
【本文地址】
今日新闻 |
推荐新闻 |