本模块提供应用对于[快捷方式](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/typical-scenario-configuration)的管理能力，包括设置快捷方式是否显示等。

说明

本模块首批接口从API version 20开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

## 导入模块

PhonePC/2in1TabletTVWearable



```
1. import { shortcutManager } from '@kit.AbilityKit';
```

## shortcutManager.setShortcutVisibleForSelf

PhonePC/2in1TabletTVWearable

setShortcutVisibleForSelf(id: string, visible: boolean) : Promise<void>

设置当前应用指定的快捷方式是否显示。使用Promise异步回调。

**系统能力：** SystemCapability.BundleManager.BundleFramework.Launcher

**参数：**

展开

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| id | string | 是 | 快捷方式的ID，通过[module.json5配置文件](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file)中的shortcuts标签下的shortcutId字段获取，取值为长度不超过63字节的字符串。 |
| visible | boolean | 是 | 快捷方式是否显示。true：快捷方式显示；false：快捷方式不显示。 |

**返回值：**

展开

| 类型 | 说明 |
| --- | --- |
| Promise<void> | Promise对象，无返回结果。 |

**错误码：**

以下错误码的详细介绍请参见[包管理子系统通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-bundle)。

展开

| 错误码ID | 错误信息 |
| --- | --- |
| 17700070 | The specified shortcut id is illegal. |

**示例：**



```
1. import { shortcutManager } from '@kit.AbilityKit';
2. import { BusinessError } from '@kit.BasicServicesKit';

4. // 请替换为module.json5配置文件中的shortcuts标签下实际配置的shortcutId字段
5. shortcutManager.setShortcutVisibleForSelf("shortcut_id", false)
6. .then(() => {
7. console.info('setShortcutVisibleForSelf success');
8. }).catch((err: BusinessError) => {
9. console.error(`setShortcutVisibleForSelf errData is errCode:${err.code}  message:${err.message}`);
10. });
```

## shortcutManager.getAllShortcutInfoForSelf

PhonePC/2in1TabletTVWearable

getAllShortcutInfoForSelf(): Promise<Array<ShortcutInfo>>

查询当前应用[配置文件](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#shortcuts标签)中定义的所有快捷方式信息。使用Promise异步回调。

**系统能力：** SystemCapability.BundleManager.BundleFramework.Launcher

**返回值：**

展开

| 类型 | 说明 |
| --- | --- |
| Promise<Array<[ShortcutInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-shortcutinfo)>> | Promise对象，返回应用配置文件中定义的所有快捷方式信息。 |

**示例：**



```
1. import { shortcutManager } from '@kit.AbilityKit';
2. import { BusinessError } from '@kit.BasicServicesKit';

4. shortcutManager.getAllShortcutInfoForSelf()
5. .then((data: shortcutManager.ShortcutInfo[]) => {
6. console.info('getAllShortcutInfoForSelf shortcut data is' + JSON.stringify(data));
7. }).catch((err: BusinessError) => {
8. console.error(`getAllShortcutInfoForSelf errData is errCode:${err.code}  message:${err.message}`);
9. });
```

## ShortcutInfo

PhonePC/2in1TabletTVWearable

type ShortcutInfo = \_ShortcutInfo

应用[module.json5配置文件](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#shortcuts标签)中定义的快捷方式信息。

**系统能力：** SystemCapability.BundleManager.BundleFramework.Launcher

展开

| 类型 | 说明 |
| --- | --- |
| [\_ShortcutInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-shortcutinfo#shortcutinfo-1) | 应用module.json5配置文件中定义的快捷方式信息。 |

## ShortcutWant

PhonePC/2in1TabletTVWearable

type ShortcutWant = \_ShortcutWant

快捷方式内定义的目标[wants](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#wants标签)信息集合。

**系统能力：** SystemCapability.BundleManager.BundleFramework.Launcher

展开

| 类型 | 说明 |
| --- | --- |
| [\_ShortcutWant](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-shortcutinfo#shortcutwant) | 快捷方式内定义的目标[wants](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#wants标签)信息集合。 |

## ParameterItem

PhonePC/2in1TabletTVWearable

type ParameterItem = \_ParameterItem

快捷方式配置信息中的自定义数据。

**系统能力：** SystemCapability.BundleManager.BundleFramework.Launcher

展开

| 类型 | 说明 |
| --- | --- |
| [\_ParameterItem](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-shortcutinfo#parameteritem) | 快捷方式配置信息中的自定义数据。 |