原文链接

快捷方式通过帮助用户快速访问 app 的某些部分，为用户提供特定类型的内容。

如何使用快捷方式提供内容取决于您的用例以及快捷方式的上下文是应用驱动还是用户驱动。 虽然静态快捷方式的上下文不会更改，并且动态快捷方式的上下文会不断更改，但两种情况下的上下文都是由您的应用程序驱动的。 如果用户选择他们希望您的应用向他们提供内容的方式，例如使用固定的快捷方式，则上下文由用户定义。 以下场景演示了每种快捷方式类型的一些用例：

静态快捷方式 最适合在用户与应用程序交互的整个生命周期内使用一致结构链接到内容的应用程序。 由于大多数启动器只能同时显示四个快捷方式，因此静态快捷方式对于常见  activities 非常有用。 例如，如果用户想要以特定方式查看他们的日历或电子邮件，则使用静态快捷方式可确保他们执行常规任务的体验是一致的。
	
动态快捷方式 用于对上下文敏感的应用程序中的操作。例如，如果您构建的游戏允许用户在启动时从当前级别开始，则需要频繁更新快捷方式。使用动态快捷方式可以在每次用户清除级别时更新快捷方式。
	
固定快捷方式用于特定的用户驱动操作。 例如，用户可能希望将特定网站固定到启动器。 这很有用，因为它允许用户执行自定义操作，例如一步导航到网站，比使用默认浏览器更快。
创建静态快捷方式

静态快捷方式提供到应用程序中常规操作的链接，这些操作在 app 当前版本的整个生命周期中都应保持一致。静态快捷方式的良好的候选者包括查看已发送的消息、设置警报和显示用户当天的锻炼活动。

要创建静态快捷方式，请完成以下步骤：


	
在应用程序的清单文件（AndroidManifest.xml）中，查找其 intent 过滤器设置为 android.intent.action.MAIN action 和android.intent.category.LAUNCHER category 的 activity。
	
	

	
向此 activity 中添加 <meta-data> 元素，该元素引用定义应用程序快捷方式的资源文件：

	
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          package="com.example.myapplication">
  <application ... >
    <activity android:name="Main">
      <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>
</manifest>

	
 
	
	

	
创建一个新的资源文件： res/xml/shortcuts.xml。
	
	

	
在此新资源文件中，添加 <shortcuts> 根元素，其中包含 <shortcut> 元素的列表。 每个 <shortcut> 元素都包含有关静态快捷方式的信息，包括其图标，描述标签以及它在应用程序中启动的 intents：

	
<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
  <shortcut
    android:shortcutId="compose"
    android:enabled="true"
    android:icon="@drawable/compose_icon"
    android:shortcutShortLabel="@string/compose_shortcut_short_label1"
    android:shortcutLongLabel="@string/compose_shortcut_long_label1"
    android:shortcutDisabledMessage="@string/compose_disabled_message1">
    <intent
      android:action="android.intent.action.VIEW"
      android:targetPackage="com.example.myapplication"
      android:targetClass="com.example.myapplication.ComposeActivity" />
    <!-- 如果您的快捷方式与多个 intent 相关联，请在这里包含它们。 
         列表中的最后一个 intent 决定用户在启动这个快捷方式时看到的内容。 -->
    <categories android:name="android.shortcut.conversation" />
  </shortcut>
  <!-- 在此处指定更多快捷方式。-->
</shortcuts>

	
 
	
自定义属性值

以下列表包含静态快捷方式中不同属性的说明。 你必须为 android:shortcutId 和 android:shortcutShortLabel提供值。 其他所有值都是可选的。

android:shortcutId

字符串文字，代表 ShortcutManager 对象对其执行操作的快捷方式。


注意：您不能将此属性的值设置为资源字符串，例如 @string/foo。


 

android:shortcutShortLabel

描述快捷方式目的的简明短语。 如果可能，将快捷方式的“简短描述”的长度限制为10个字符。

要获取更多信息，请参见 setShortLabel()。


注意：此属性的值必须是资源字符串，例如 @string/shortcut_short_label。


 

android:shortcutLongLabel

描述快捷方式目的的扩展短语。 如果有足够的空间，启动器会显示此值而不是 android:shortcutShortLabel。 如果可能，将快捷方式的“长描述”的长度限制为25个字符。

要获取更多信息，参见 setLongLabel().


注意：此属性的值必须是资源字符串，例如 @string/shortcut_long_label。


 

android:shortcutDisabledMessage

当用户尝试启动已禁用的快捷方式时，在支持的启动器中显示的消息。 该消息应向用户解释为什么现在禁用该快捷方式。 如果 android:enabled为 true，则此属性的值无效。


注意：此属性的值必须是资源字符串，例如 @string/shortcut_disabled_message。


 

android:enabled

决定用户是否可以从支持的启动器与快捷方式进行交互。android:enabled 的默认值为 true。 如果将其设置为 false，则还应设置 android:shortcutDisabledMessage，以解释禁用快捷方式的原因。 如果您认为不需要提供此类消息，则最简单的方法是从 XML 文件中完全删除该快捷方式。

 

android:icon

启动器在显示用户快捷方式时使用的 bitmap（位图） 或自适应图标。 此值可以是图像的路径，也可以是包含图像的资源文件。 尽可能使用自适应图标以提高性能和一致性。


注意：快捷方式图标不能包含色调。


 

配置内部元素

列出应用程序的静态快捷方式的 XML 文件支持每个 <shortcut> 元素中的以下元素。 您必须为您定义的每个静态快捷方式包含一个 intent 内部元素。

intent

用户选择快捷方式时系统启动的操作。 此 intent 必须为 android:action 属性提供值。


注意：此 intent 元素不能包含字符串资源。


您可以为单个快捷方式提供多个 intent。 有关详细信息，请参阅  Manage multiple intents and activities ，Using intents，和 TaskStackBuilder 类参考。

 

categories

为应用程序快捷方式执行的操作类型提供分组，例如创建新的聊天消息。

有关支持的快捷方式 categories 的列表，请参阅 ShortcutInfo 类引用。

 

创建动态快捷方式

动态快捷方式提供指向应用内特定的上下文相关操作的链接。 这些操作可能会在您的应用使用之间发生变化，甚至在您的应用运行时也会发生变化。动态快捷方式的良好候选者包括呼叫特定人员，导航到特定位置，以及从用户的最后保存点加载游戏。

ShortcutManager API 允许您在动态快捷方式上完成以下操作：

发布：使用 setDynamicShortcuts() 重新定义动态快捷方式的完整列表，或使用addDynamicShortcuts() 来扩充现有的动态快捷方式列表。
	
更新：使用 updateShortcuts() 方法。
	
删除：使用 removeDynamicShortcuts() 删除一组动态快捷方式，或使用 removeAllDynamicShortcuts().删除所有动态快捷方式。
For more information about performing operations on shortcuts, read Manage shortcuts and the ShortcutManagerreference.有关在快捷方式上执行操作的更多信息，请阅读 Manage shortcuts 和 ShortcutManager 参考。

以下代码段中显示了创建动态快捷方式并将其与您的 app 相关联的示例：


注意：必须使用带有参数 ShortcutManager.class 的 Context.getSystemService(Class) 或带有参数 Context.SHORTCUT_SERVICE 的 Context.getSystemService(String) 获取 ShortcutManager 类的实例。


val shortcutManager = getSystemService<ShortcutManager>(ShortcutManager::class.java)

val shortcut = ShortcutInfo.Builder(context, "id1")
        .setShortLabel("Website")
        .setLongLabel("Open the website")
        .setIcon(Icon.createWithResource(context, R.drawable.icon_website))
        .setIntent(Intent(Intent.ACTION_VIEW,
                Uri.parse("https://www.mysite.example.com/")))
        .build()

shortcutManager!!.dynamicShortcuts = Arrays.asList(shortcut)

 

创建固定快捷方式

要使用您的应用程序将快捷方式固定到支持的启动器，请完成以下步骤：

使用 isRequestPinShortcutSupported() 验证设备的默认启动器是否支持应用程序固定快捷方式。
	

	
根据快捷方式是否已存在，以两种方式之一创建 ShortcutInfo 对象：

	
如果快捷方式已存在，请创建仅包含现有快捷方式 ID 的 ShortcutInfo 对象。 系统自动查找并固定与快捷方式相关的所有其他信息。
		
如果要固定新快捷方式，请创建一个 ShortcutInfo 对象，其中包含新快捷方式的 ID，intent 和短标签。
	

	
注意：由于系统会自动对固定快捷方式执行备份和还原，因此这些快捷方式的 ID 应包含稳定的常量字符串或服务器端标识符，而不是本地生成的标识符，这些标识符可能在其他设备上没有意义。
	
	
	

	
通过调用 requestPinShortcut() 尝试将快捷方式固定到设备的启动器。 在此过程中，您可以传入 PendingIntent 对象，该对象仅在快捷方式成功固定时通知您的应用。

	

	
注意：如果用户不允许将快捷方式固定到启动器，则您的应用程序不会收到回调。
	

	
固定快捷方式后，您的应用可以使用 updateShortcuts() 方法更新其内容。 有关更多信息，请阅读更新快捷方式。
	
以下代码段演示了如何创建固定快捷方式：


注意：必须使用带有参数 ShortcutManager.class 的 Context.getSystemService(Class) 或带有参数 Context.SHORTCUT_SERVICE 的 Context.getSystemService(String)获取 ShortcutManager 类的实例。


val shortcutManager = getSystemService(ShortcutManager::class.java)

if (shortcutManager!!.isRequestPinShortcutSupported) {
    // 假设已经有一个ID为 “my-shortcut” 的快捷方式。
    // 必须启用快捷方式。
    val pinShortcutInfo = ShortcutInfo.Builder(context, "my-shortcut").build()

    // 仅当需要通知您的应用程序用户允许固定快捷方式时，才创建 PendingIntent 对象。 
    // 请注意，如果固定操作失败，则不会通知您的应用。 我们假设应用程序已经实现了一个名为 
    //  createShortcutResultIntent() 的方法，该方法返回广播 itent。
    val pinnedShortcutCallbackIntent =         
shortcutManager.createShortcutResultIntent(pinShortcutInfo)

    // 配置 intent，以便应用程序的广播接收器成功获得回调。有关详细信息，请参阅            
    // PendingIntent.getBroadcast()。
    val successCallback = PendingIntent.getBroadcast(context, /* request code */ 0,
            pinnedShortcutCallbackIntent, /* flags */ 0)

    shortcutManager.requestPinShortcut(pinShortcutInfo,
            successCallback.intentSender)
}


注意：另请参阅 support 库 API，isRequestPinShortcutSupported() 和 requestPinShortcut()，它们适用于 Android 7.1（API 级别 25）及更低版本。support 库回退到已弃用的 EXTRA_SHORTCUT_INTENT extra 以尝试固定过程。


 

创建自定义快捷方式 activity

 



图 2. 自定义应用快捷方式对话框 activity 的示例

您还可以创建专门的 activity，帮助用户创建快捷方式，完成自定义选项和确认按钮。 图 2 显示了 Gmail 应用中此类 activity 的示例。

在应用程序的清单文件中，将 ACTION_CREATE_SHORTCUT 添加到 activity 的 <intent-filter> 元素中。 当用户尝试创建快捷方式时，此声明会设置以下行为：

系统启动应用程序的特定 activity。
	
用户为快捷方式设置选项。
	
用户选择确认按钮。
	
您的应用使用 createShortcutResultIntent() 方法创建快捷方式。 此方法返回一个Intent，您的应用程序使用 setResult().将其中继回到先前执行的 activity。
	
您的应用程序调用用于创建自定义快捷方式的 activity 的 finish() 。
同样，您的应用可以提示用户在安装后或第一次启动应用时将固定快捷方式添加到主屏幕。 此方法很有效，因为它可以帮助您的用户在普通工作流程中创建快捷方式。

 

测试快捷方式

要测试应用的快捷方式，请在具有支持快捷方式的启动器的设备上安装您的应用。 然后，执行以下操作：

长按您应用的启动器图标，即可查看您为应用定义的快捷方式。
	
点击并拖动快捷方式将其固定到设备的启动器。

本文讲述如何在Ubuntu Linux 系统下添加程序的桌面快捷方式，添加程序启动器到应用程序列表，创建程序启动器到收藏夹，建立桌面快捷方式等操作，实现快速，方便的打开程序，搜索程序以及访问文件夹

建立文件夹桌面快捷方式
对于windows 来说，只需要在目标文件夹鼠标右键，选择发送到桌面快捷方式就搞定了，Ubuntu 也不复杂，需要建立一个软链接，比如我要将 /home/qianqianjun/CODE 添加到桌面，那么我就执行下面的命令来：
sudo ln -sT /home/qianqianjun/CODE ~/桌面/CODE快捷方式

实现的效果如下所示：


建立程序启动器
对于一个不能自动创建快捷方式的程序来说，启动它很麻烦，因为你要找到它所在的目录，然后运行它，有些还是.sh 结尾的文件，这时候需要启动终端来运行，运行期间终端不可以关闭，十分蛋疼，解决办法如下：我这里有一个AppImage 文件，双击即可运行。

现在我想建立它的桌面快捷方式，我们记录下这个可执行文件所在的位置：/opt/软件名称.AppImage

我们进入到桌面，创建一个.desktop 的启动器文件
cd ~/桌面
touch 软件名称.desktop
vim 软件名称.desktop

输入 a 进入编辑模式，输入下面的内容，注意这里的所有的地址要换成你电脑上对应的地址：
[Desktop Entry]
Encoding=UTF-8
NAME=软件名称
Name[zh_CN]=软件中文名称
COMMENT=软件注释名称
Exec=/opt/软件名称.AppImage
Icon=/usr/share/icons/macOS11/apps/128/软件图标.png
Terminal=False
Type=Application
startupNotify=False
categories=Application;Development

各个字段的意思大家看英文也能看个大概，启动器做出来也可以看到效果，这里不再赘述每一个字段什么含义了。（特别说一下，Icon 可以设置启动器的图标，支持很多种图片格式，去百度上下载一个图片用编辑软件修改一下就好，注意，图片要做成方的。）

之后选择刚刚在桌面上创建的这个 desktop 文件，右键选择属性 --> 权限，勾选 “允许作为程序执行文件”，ok，大功告成，双击启动器，就可以打开程序了。
将程序启动器添加到应用列表
对于Ubuntu来说，有一个应用列表，这个列表有所有安装的软件快捷方式，如图所示：



经过寻找，确定了这个目录所在的位置是： /usr/share/applications，进入该文件夹，查看文件夹中的文件，如图所示：



可以看到这里有好多的desktop文件，确定是这里无疑了，那么我们如果想把程序启动器添加到应用列表中，只需要将来创建好的desktop 文件房间该目录即可
sudo mv ~/桌面/软件名称.desktop  /usr/share/applications

这时候你再看一下程序列表，可以看到刚刚安装的软件。
将程序添加收藏夹
这一步就比较简单了，打开程序列表，然后在启动器上右键，选择添加到收藏夹，就OK了。

创建快捷方式:  ln -s 源目录 目标快捷方式   

(目标快捷方式不需要先创建文件夹 , 会自动创建)

 

查看快捷方式的指向(源文件) : ls -l

今早有个网友邮件联系我，说一个流氓软件 丝瓜视频网页版 描述文件安装以后不能删除怎么办？
我做了一个实验，确实没办法手动删除，真是流氓啊？哈哈，安装这个软件的小伙伴本来想着看了后就删了的（?），但是删不了，怎么办？


网友在贴吧上询问，甚至有淘宝上开卖解决方案，不知道是不是真的。



今天研究了一下，确实可以制作不可删除的描述文件，制作方法，这公司也是，唉，让这用户?无处遁形，哈哈哈哈
解决方案
小伙伴的福利来了，我动手做了一个可删除的丝瓜视频网页版描述文件来覆盖它。哈哈，赞我噢！（当然，后续如果还有这种流氓的无法删除的描述文件，联系我就好，我会抽时间上传一个删除版供大家下载，为创造一个和谐的苹果生态环境）
安装后如下图所示：此时变成了可删除