# @ohos.bundle (Bundle模块)

本模块提供应用信息查询能力，支持包信息、应用信息、Ability组件信息等信息的查询，以及应用禁用状态的查询、设置等。

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

从API version 9开始，该模块不再维护，建议使用@ohos.bundle.bundleManager替代。

#### 导入模块

```
import bundle from '@ohos.bundle';
```

#### 权限列表

| 权限 | 权限等级 | 描述 |
| --- | --- | --- |
| ohos.permission.GET_BUNDLE_INFO | normal | 查询指定应用信息。 |
| ohos.permission.GET_BUNDLE_INFO_PRIVILEGED | system_basic | 可查询所有应用信息。 |

权限等级参考权限APL等级说明。

#### bundle.getApplicationInfodeprecated

从API version 7开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。

getApplicationInfo(bundleName: string, bundleFlags: number, userId?: number): Promise<ApplicationInfo>

根据给定的Bundle名称获取ApplicationInfo。使用Promise异步回调。

获取调用方自己的信息时不需要权限。

**需要权限：**

ohos.permission.GET\_BUNDLE\_INFO\_PRIVILEGED 或 ohos.permission.GET\_BUNDLE\_INFO

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| bundleName | string | 是 | 要查询的应用Bundle名称。 |
| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围请参考BundleFlag说明中应用信息相关flag。 |
| userId | number | 否 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 |

**返回值：**

| 类型 | 说明 |
| --- | --- |
| Promise<ApplicationInfo> | Promise形式返回应用程序信息。 |

**示例：**

```
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';

let bundleName: string = "com.example.myapplication";
let bundleFlags: number = 0;
let userId: number = 100;

bundle.getApplicationInfo(bundleName, bundleFlags, userId)
  .then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
  }).catch((error: BusinessError) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
  })
```

#### bundle.getApplicationInfodeprecated

从API version 7开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。

getApplicationInfo(bundleName: string, bundleFlags: number, userId: number, callback: AsyncCallback<ApplicationInfo>): void

根据给定的Bundle名称获取指定用户下的ApplicationInfo，使用callback异步回调。

获取调用方自己的信息时不需要权限。

**需要权限：**

ohos.permission.GET\_BUNDLE\_INFO\_PRIVILEGED 或 ohos.permission.GET\_BUNDLE\_INFO

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| bundleName | string | 是 | 要查询的应用Bundle名称。 |
| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考BundleFlag说明中应用信息相关flag。 |
| userId | number | 是 | 用户ID。取值范围：大于等于0。 |
| callback | AsyncCallback<ApplicationInfo> | 是 | 程序启动作为入参的回调函数，返回应用程序信息。 |

**示例：**

```
import bundle from '@ohos.bundle';

let bundleName: string = "com.example.myapplication";
let bundleFlags: number = 0;
let userId: number = 100;

bundle.getApplicationInfo(bundleName, bundleFlags, userId, (err, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful. Data:' + JSON.stringify(data));
})
```

#### bundle.getApplicationInfodeprecated

从API version 7开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。

getApplicationInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback<ApplicationInfo>): void

根据给定的Bundle名称获取ApplicationInfo，使用callback异步回调。

获取调用方自己的信息时不需要权限。

**需要权限：**

ohos.permission.GET\_BUNDLE\_INFO\_PRIVILEGED 或 ohos.permission.GET\_BUNDLE\_INFO

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| bundleName | string | 是 | 要查询的应用Bundle名称。 |
| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考BundleFlag说明中应用信息相关flag。 |
| callback | AsyncCallback<ApplicationInfo> | 是 | 程序启动作为入参的回调函数，返回应用程序信息。 |

**示例：**

```
import bundle from '@ohos.bundle';

let bundleName: string = "com.example.myapplication";
let bundleFlags: number = 0;

bundle.getApplicationInfo(bundleName, bundleFlags, (err, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful. Data:' + JSON.stringify(data));
})
```

#### bundle.getAllBundleInfodeprecated

从API version 7开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。

getAllBundleInfo(bundleFlag: BundleFlag, userId?: number): Promise<Array<BundleInfo>>

获取指定用户所有的BundleInfo，使用Promise形式异步回调。

**需要权限：**

ohos.permission.GET\_BUNDLE\_INFO\_PRIVILEGED

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| bundleFlag | BundleFlag | 是 | 用于指定返回的包信息对象中包含信息的标记。取值范围：参考BundleFlag说明中包信息相关flag。 |
| userId | number | 否 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 |

**返回值：**

| 类型 | 说明 |
| --- | --- |
| Promise<Array<BundleInfo>> | Promise形式返回所有可用的BundleInfo |

**示例：**

```
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';

let bundleFlag: number = 0;
let userId: number = 100;

bundle.getAllBundleInfo(bundleFlag, userId)
  .then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
  }).catch((error: BusinessError) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
  })
```

#### bundle.getAllBundleInfodeprecated

从API version 7开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。

getAllBundleInfo(bundleFlag: BundleFlag, callback: AsyncCallback<Array<BundleInfo>>): void

获取当前用户所有的BundleInfo，使用callback异步回调。

**需要权限：**

ohos.permission.GET\_BUNDLE\_INFO\_PRIVILEGED

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| bundleFlag | BundleFlag | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考BundleFlag说明中包信息相关flag。 |
| callback | AsyncCallback<Array<BundleInfo>> | 是 | 程序启动作为入参的回调函数，返回所有可用的BundleInfo。 |

**示例：**

```
import bundle from '@ohos.bundle';

let bundleFlag: number = 0;

bundle.getAllBundleInfo(bundleFlag, (err, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful. Data:' + JSON.stringify(data));
})
```

#### bundle.getAllBundleInfodeprecated

从API version 7开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。

getAllBundleInfo(bundleFlag: BundleFlag, userId: number, callback: AsyncCallback<Array<BundleInfo>>): void

获取系统中指定用户下所有的BundleInfo，使用callback异步回调。

**需要权限：**

ohos.permission.GET\_BUNDLE\_INFO\_PRIVILEGED

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| bundleFlag | BundleFlag | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考BundleFlag说明中包信息相关flag。 |
| userId | number | 是 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 |
| callback | AsyncCallback<Array<BundleInfo>> | 是 | 程序启动作为入参的回调函数，返回指定用户下所有包的BundleInfo。 |

**示例：**

```
import bundle from '@ohos.bundle';

let bundleFlag: number = 0;
let userId: number = 100;

bundle.getAllBundleInfo(bundleFlag, userId, (err, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful. Data:' + JSON.stringify(data));
})
```

#### bundle.getBundleInfodeprecated

从API version 7开始支持，从API version 9开始废弃，建议使用getBundleInfo替代。

getBundleInfo(bundleName: string, bundleFlags: number, options?: BundleOptions): Promise<BundleInfo>

根据给定的Bundle名称获取BundleInfo，使用Promise异步回调。

获取调用方自己的信息时不需要权限。

**需要权限：**

ohos.permission.GET\_BUNDLE\_INFO\_PRIVILEGED 或 ohos.permission.GET\_BUNDLE\_INFO

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| bundleName | string | 是 | 要查询的应用Bundle名称。 |
| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考BundleFlag说明中包信息相关flag。 |
| options | BundleOptions | 否 | 包含userid的查询选项。 |

**返回值：**

| 类型 | 说明 |
| --- | --- |
| Promise<BundleInfo> | Promise对象，获取成功时返回包信息。 |

**示例：**

```
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';

let bundleName: string = "com.example.myapplication";
let bundleFlags: number = 1;
let options: bundle.BundleOptions = {
  "userId": 100
};

bundle.getBundleInfo(bundleName, bundleFlags, options)
  .then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
  }).catch((error: BusinessError) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
  })
```

#### bundle.getBundleInfodeprecated

从API version 7开始支持，从API version 9开始废弃，建议使用getBundleInfo替代。

getBundleInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback<BundleInfo>): void

根据给定的Bundle名称获取BundleInfo，使用callback异步回调。

获取调用方自己的信息时不需要权限。

**需要权限：**

ohos.permission.GET\_BUNDLE\_INFO\_PRIVILEGED 或 ohos.permission.GET\_BUNDLE\_INFO

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| bundleName | string | 是 | 需要查询的应用Bundle名称。 |
| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考BundleFlag说明中包信息相关flag。 |
| callback | AsyncCallback<BundleInfo> | 是 | 程序启动作为入参的回调函数，返回包信息。 |

**示例：**

```
import bundle from '@ohos.bundle';

let bundleName: string = "com.example.myapplication";
let bundleFlags: number = 1;

bundle.getBundleInfo(bundleName, bundleFlags, (err, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful. Data:' + JSON.stringify(data));
})
```

#### bundle.getBundleInfodeprecated

从API version 7开始支持，从API version 9开始废弃，建议使用getBundleInfo替代。

getBundleInfo(bundleName: string, bundleFlags: number, options: BundleOptions, callback: AsyncCallback<BundleInfo>): void

根据给定的Bundle名称获取BundleInfo，使用callback异步回调。

获取调用方自己的信息时不需要权限。

**需要权限：**

ohos.permission.GET\_BUNDLE\_INFO\_PRIVILEGED 或 ohos.permission.GET\_BUNDLE\_INFO

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| bundleName | string | 是 | 要查询的应用Bundle名称。 |
| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考BundleFlag说明中包信息相关flag。 |
| options | BundleOptions | 是 | 包含userid。 |
| callback | AsyncCallback<BundleInfo> | 是 | 程序启动作为入参的回调函数，返回包信息。 |

**示例：**

```
import bundle from '@ohos.bundle';

let bundleName: string = "com.example.myapplication";
let bundleFlags: number = 1;
let options: bundle.BundleOptions = {
  "userId": 100
};

bundle.getBundleInfo(bundleName, bundleFlags, options, (err, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful. Data:' + JSON.stringify(data));
})
```

#### bundle.getAllApplicationInfodeprecated

从API version 7开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。

getAllApplicationInfo(bundleFlags: number, userId?: number): Promise<Array<ApplicationInfo>>

获取指定用户下所有已安装的应用信息，使用promise异步回调。

**需要权限：**

ohos.permission.GET\_BUNDLE\_INFO\_PRIVILEGED

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考BundleFlag说明中应用信息相关flag。 |
| userId | number | 否 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 |

**返回值：**

| 类型 | 说明 |
| --- | --- |
| Promise<Array<ApplicationInfo>> | Promise对象，获取成功时返回应用信息列表。 |

**示例：**

```
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';

let bundleFlags: number = 8;
let userId: number = 100;

bundle.getAllApplicationInfo(bundleFlags, userId)
  .then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
  }).catch((error: BusinessError) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
  })
```

#### bundle.getAllApplicationInfodeprecated

从API version 7开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。

getAllApplicationInfo(bundleFlags: number, userId: number, callback: AsyncCallback<Array<ApplicationInfo>>): void

获取指定用户下所有已安装的应用信息，使用callback异步回调。

**需要权限：**

ohos.permission.GET\_BUNDLE\_INFO\_PRIVILEGED

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考BundleFlag说明中应用信息相关flag。 |
| userId | number | 是 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 |
| callback | AsyncCallback<Array<ApplicationInfo>> | 是 | 程序启动作为入参的回调函数，返回应用信息列表。 |

**示例：**

```
import bundle from '@ohos.bundle';

let bundleFlags: number = bundle.BundleFlag.GET_APPLICATION_INFO_WITH_PERMISSION;
let userId: number = 100;

bundle.getAllApplicationInfo(bundleFlags, userId, (err, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful. Data:' + JSON.stringify(data));
})
```

#### bundle.getAllApplicationInfodeprecated

从API version 7开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。

getAllApplicationInfo(bundleFlags: number, callback: AsyncCallback<Array<ApplicationInfo>>): void

获取调用方所在用户下已安装的应用信息，使用callback异步回调。

**需要权限：**

ohos.permission.GET\_BUNDLE\_INFO\_PRIVILEGED

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考BundleFlag说明中应用信息相关flag。 |
| callback | AsyncCallback<Array<ApplicationInfo>> | 是 | 程序启动作为入参的回调函数，返回应用信息列表。 |

**示例：**

```
import bundle from '@ohos.bundle';

let bundleFlags: number = bundle.BundleFlag.GET_APPLICATION_INFO_WITH_PERMISSION;

bundle.getAllApplicationInfo(bundleFlags, (err, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful. Data:' + JSON.stringify(data));
})
```

#### bundle.getBundleArchiveInfodeprecated

从API version 7开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。

getBundleArchiveInfo(hapFilePath: string, bundleFlags: number) : Promise<BundleInfo>

获取有关HAP中包含的应用程序包的信息，使用Promise异步回调。

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| hapFilePath | string | 是 | HAP存放路径。支持当前应用程序的绝对路径和数据目录沙箱路径。 |
| bundleFlags | number | 是 | 用于指定要返回的BundleInfo对象中包含信息的标记。取值范围：参考BundleFlag说明中包信息相关flag。 |

**返回值：**

| 类型 | 说明 |
| --- | --- |
| Promise<BundleInfo> | 返回值为Promise对象，Promise中包含有关HAP中包含的应用程序的信息。 |

**示例：**

```
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';

let hapFilePath: string = "/data/storage/el2/base/test.hap";
let bundleFlags: number = 0;

bundle.getBundleArchiveInfo(hapFilePath, bundleFlags)
  .then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
  }).catch((error: BusinessError) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
  })
```

#### bundle.getBundleArchiveInfodeprecated

从API version 7开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。

getBundleArchiveInfo(hapFilePath: string, bundleFlags: number, callback: AsyncCallback<BundleInfo>) : void

获取有关HAP中包含的应用程序包的信息，使用callback异步回调。

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| hapFilePath | string | 是 | HAP存放路径，支持当前应用程序的绝对路径和数据目录沙箱路径。 |
| bundleFlags | number | 是 | 用于指定要返回的BundleInfo对象中包含信息的标记。取值范围：参考BundleFlag说明中包信息相关flag。 |
| callback | AsyncCallback<BundleInfo> | 是 | 程序启动作为入参的回调函数，返回HAP中包含的应用程序包的信息。 |

**示例：**

```
import bundle from '@ohos.bundle';

let hapFilePath: string = "/data/storage/el2/base/test.hap";
let bundleFlags: number = 0;

bundle.getBundleArchiveInfo(hapFilePath, bundleFlags, (err, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful. Data:' + JSON.stringify(data));
})
```

#### bundle.getAbilityInfodeprecated

从API version 7开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。

getAbilityInfo(bundleName: string, abilityName: string): Promise<AbilityInfo>

通过Bundle名称和组件名获取Ability组件信息，使用Promise形式异步回调。

获取调用方自己的信息时不需要权限。

**需要权限：**

ohos.permission.GET\_BUNDLE\_INFO\_PRIVILEGED 或 ohos.permission.GET\_BUNDLE\_INFO

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| bundleName | string | 是 | 应用Bundle名称。 |
| abilityName | string | 是 | Ability组件名称。 |

**返回值：**

| 类型 | 说明 |
| --- | --- |
| Promise<AbilityInfo> | Promise形式返回Ability信息。 |

**示例：**

```
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';

let bundleName: string = "com.example.myapplication";
let abilityName: string = "EntryAbility";

bundle.getAbilityInfo(bundleName, abilityName)
  .then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
  }).catch((error: BusinessError) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
  })
```

#### bundle.getAbilityInfodeprecated

从API version 7开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。

getAbilityInfo(bundleName: string, abilityName: string, callback: AsyncCallback<AbilityInfo>): void

通过Bundle名称和组件名获取Ability组件信息，使用callback异步回调。

获取调用方自己的信息时不需要权限。

**需要权限：**

ohos.permission.GET\_BUNDLE\_INFO\_PRIVILEGED 或 ohos.permission.GET\_BUNDLE\_INFO

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| bundleName | string | 是 | 应用Bundle名称。 |
| abilityName | string | 是 | Ability名称。 |
| callback | AsyncCallback<AbilityInfo> | 是 | 程序启动作为入参的回调函数，返回Ability信息。 |

**示例：**

```
import bundle from '@ohos.bundle';

let bundleName: string = "com.example.myapplication";
let abilityName: string = "EntryAbility";

bundle.getAbilityInfo(bundleName, abilityName, (err, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful. Data:' + JSON.stringify(data));
})
```

#### bundle.getAbilityLabel8+ deprecated

从API version 8开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。

getAbilityLabel(bundleName: string, abilityName: string): Promise<string>

通过Bundle名称和ability名称获取应用名称，使用Promise异步回调。

获取调用方自己的信息时不需要权限。

**需要权限：**

ohos.permission.GET\_BUNDLE\_INFO\_PRIVILEGED 或 ohos.permission.GET\_BUNDLE\_INFO

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| bundleName | string | 是 | 应用Bundle名称。 |
| abilityName | string | 是 | Ability名称。 |

**返回值：**

| 类型 | 说明 |
| --- | --- |
| Promise<string> | Promise形式返回应用名称信息。 |

**示例：**

```
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';

let bundleName: string = "com.example.myapplication";
let abilityName: string = "EntryAbility";

bundle.getAbilityLabel(bundleName, abilityName)
  .then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
  }).catch((error: BusinessError) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
  })
```

#### bundle.getAbilityLabel8+ deprecated

从API version 8开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。

getAbilityLabel(bundleName: string, abilityName: string, callback : AsyncCallback<string>): void

通过Bundle名称和Ability组件名获取应用名称，使用callback异步回调。

获取调用方自己的信息时不需要权限。

**需要权限：**

ohos.permission.GET\_BUNDLE\_INFO\_PRIVILEGED 或 ohos.permission.GET\_BUNDLE\_INFO

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| bundleName | string | 是 | 应用Bundle名称。 |
| abilityName | string | 是 | Ability名称。 |
| callback | AsyncCallback<string> | 是 | 程序启动作为入参的回调函数，返回应用名称信息。 |

**示例：**

```
import bundle from '@ohos.bundle';

let bundleName: string = "com.example.myapplication";
let abilityName: string = "EntryAbility";

bundle.getAbilityLabel(bundleName, abilityName, (err, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful. Data:' + JSON.stringify(data));
})
```

#### bundle.isAbilityEnabled8+ deprecated

从API version 8开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。

isAbilityEnabled(info: AbilityInfo): Promise<boolean>

根据给定的AbilityInfo查询ability是否已经启用，使用Promise异步回调。

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| info | AbilityInfo | 是 | Ability的配置信息。 |

**返回值：**

| 类型 | 说明 |
| --- | --- |
| Promise<boolean> | Promise形式返回boolean代表是否启用。 |

**示例：**

```
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';

let bundleName: string = "com.example.myapplication";
let abilityName: string = "EntryAbility";

bundle.getAbilityInfo(bundleName, abilityName).then((abilityInfo) => {
  bundle.isAbilityEnabled(abilityInfo).then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
  }).catch((error: BusinessError) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
  })
})
```

#### bundle.isAbilityEnabled8+ deprecated

从API version 8开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。

isAbilityEnabled(info : AbilityInfo, callback : AsyncCallback<boolean>): void

根据给定的AbilityInfo查询ability是否已经启用，使用callback异步回调。

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| info | AbilityInfo | 是 | Ability的配置信息。 |
| callback | AsyncCallback<boolean> | 是 | 回调函数，返回boolean代表是否启用。 |

**示例：**

```
import bundle from '@ohos.bundle';

let bundleName: string = "com.example.myapplication";
let abilityName: string = "EntryAbility";

bundle.getAbilityInfo(bundleName, abilityName).then((abilityInfo) => {
  bundle.isAbilityEnabled(abilityInfo, (err, data) => {
    if (err) {
      console.error('Operation failed. Cause: ' + JSON.stringify(err));
      return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
  })
})
```

#### bundle.isApplicationEnabled8+ deprecated

从API version 8开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。

isApplicationEnabled(bundleName: string): Promise<boolean>

根据给定的bundleName查询指定应用程序是否已经启用，使用Promise异步回调。

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| bundleName | string | 是 | 要查询的应用Bundle名称。 |

**返回值：**

| 类型 | 说明 |
| --- | --- |
| Promise<boolean> | Promise形式返回boolean代表是否启用。 |

**示例：**

```
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';

let bundleName: string = "com.example.myapplication";

bundle.isApplicationEnabled(bundleName)
  .then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
  }).catch((error: BusinessError) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
  })
```

#### bundle.isApplicationEnabled8+ deprecated

从API version 8开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。

isApplicationEnabled(bundleName: string, callback : AsyncCallback<boolean>): void

根据给定的bundleName查询指定应用程序是否已经启用，使用callback异步回调。

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| bundleName | string | 是 | 要查询的应用Bundle名称。 |
| callback | AsyncCallback<boolean> | 是 | 回调函数，返回boolean代表是否启用。 |

**示例：**

```
import bundle from '@ohos.bundle';

let bundleName: string = "com.example.myapplication";

bundle.isApplicationEnabled(bundleName, (err, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful. Data:' + JSON.stringify(data));
})
```

#### bundle.queryAbilityByWantdeprecated

从API version 7开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。

queryAbilityByWant(want: Want, bundleFlags: number, userId?: number): Promise<Array<AbilityInfo>>

根据给定的意图获取Ability组件信息，使用Promise异步回调。

获取调用方自己的信息时不需要权限。

**需要权限：**

ohos.permission.GET\_BUNDLE\_INFO\_PRIVILEGED 或 ohos.permission.GET\_BUNDLE\_INFO

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| want | Want | 是 | 包含要查询的应用Bundle名称的意图。 |
| bundleFlags | number | 是 | 用于指定返回abilityInfo信息。取值范围：参考BundleFlag说明中Ability信息相关flag。 |
| userId | number | 否 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 |

**返回值：**

| 类型 | 说明 |
| --- | --- |
| Promise<Array<AbilityInfo>> | Promise形式返回Ability信息。 |

**示例：**

```
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';
import Want from '@ohos.app.ability.Want';

let bundleFlags: number = 0;
let userId: number = 100;
let want: Want = {
  bundleName: "com.example.myapplication",
  abilityName: "EntryAbility"
};

bundle.queryAbilityByWant(want, bundleFlags, userId)
  .then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
  }).catch((error: BusinessError) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
  })
```

#### bundle.queryAbilityByWantdeprecated

从API version 7开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。

queryAbilityByWant(want: Want, bundleFlags: number, userId: number, callback: AsyncCallback<Array<AbilityInfo>>): void

根据给定的意图获取指定用户下Ability信息，使用callback异步回调。

获取调用方自己的信息时不需要权限。

**需要权限：**

ohos.permission.GET\_BUNDLE\_INFO\_PRIVILEGED 或 ohos.permission.GET\_BUNDLE\_INFO

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| want | Want | 是 | 指示包含要查询的应用Bundle名称的意图。 |
| bundleFlags | number | 是 | 用于指定返回abilityInfo信息。取值范围：参考BundleFlag说明中Ability信息相关flag。 |
| userId | number | 是 | 用户ID。取值范围：大于等于0。 |
| callback | AsyncCallback<Array<AbilityInfo>> | 是 | 程序启动作为入参的回调函数，返回Ability信息。 |

**示例：**

```
import bundle from '@ohos.bundle';
import Want from '@ohos.app.ability.Want';

let bundleFlags: number = 0;
let userId: number = 100;
let want: Want = {
  bundleName: "com.example.myapplication",
  abilityName: "EntryAbility"
};

bundle.queryAbilityByWant(want, bundleFlags, userId, (err, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful. Data:' + JSON.stringify(data));
})
```

#### bundle.queryAbilityByWantdeprecated

从API version 7开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。

queryAbilityByWant(want: Want, bundleFlags: number, callback: AsyncCallback<Array<AbilityInfo>>): void

根据给定的意图获取Ability信息，使用callback异步回调。

获取调用方自己的信息时不需要权限。

**需要权限：**

ohos.permission.GET\_BUNDLE\_INFO\_PRIVILEGED 或 ohos.permission.GET\_BUNDLE\_INFO

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| want | Want | 是 | 指示包含要查询的应用Bundle名称的意图。 |
| bundleFlags | number | 是 | 用于指定返回abilityInfo信息。取值范围：参考BundleFlag说明中Ability信息相关flag。 |
| callback | AsyncCallback<Array<AbilityInfo>> | 是 | 程序启动作为入参的回调函数，返回Ability信息。 |

**示例：**

```
import bundle from '@ohos.bundle';
import Want from '@ohos.app.ability.Want';

let bundleFlags: number = 0;
let want: Want = {
  bundleName: "com.example.myapplication",
  abilityName: "EntryAbility"
};

bundle.queryAbilityByWant(want, bundleFlags, (err, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful. Data:' + JSON.stringify(data));
})
```

#### bundle.getLaunchWantForBundledeprecated

从API version 7开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。

getLaunchWantForBundle(bundleName: string): Promise<Want>

查询拉起指定应用的want对象，使用Promise异步回调。

**需要权限：**

ohos.permission.GET\_BUNDLE\_INFO\_PRIVILEGED

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| bundleName | string | 是 | 要查询的应用Bundle名称。 |

**返回值：**

| 类型 | 说明 |
| --- | --- |
| Promise<Want> | 返回值为Promise对象，Promise中包含拉起指定应用的Want对象。 |

**示例：**

```
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';

let bundleName: string = "com.example.myapplication";

bundle.getLaunchWantForBundle(bundleName)
  .then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
  }).catch((error: BusinessError) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
  })
```

#### bundle.getLaunchWantForBundledeprecated

从API version 7开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。

getLaunchWantForBundle(bundleName: string, callback: AsyncCallback<Want>): void

查询拉起指定应用的want对象，使用callback异步回调。

**需要权限：**

ohos.permission.GET\_BUNDLE\_INFO\_PRIVILEGED

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| bundleName | string | 是 | 要查询的应用Bundle名称。 |
| callback | AsyncCallback<Want> | 是 | 程序启动作为入参的回调函数，返回拉起指定应用的want对象。 |

**示例：**

```
import bundle from '@ohos.bundle';

let bundleName: string = "com.example.myapplication";

bundle.getLaunchWantForBundle(bundleName, (err, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful. Data:' + JSON.stringify(data));
})
```

#### bundle.getNameForUid8+ deprecated

从API version 8开始支持，从API version 9开始废弃，建议使用getBundleNameByUid替代。

getNameForUid(uid: number): Promise<string>

通过uid获取对应的Bundle名称，使用Promise异步回调。

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| uid | number | 是 | 要查询的uid。 |

**返回值：**

| 类型 | 说明 |
| --- | --- |
| Promise<string> | 返回值为Promise对象，Promise中包含指定uid的Bundle名称。 |

**示例：**

```
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';

let uid: number = 20010005;

bundle.getNameForUid(uid)
  .then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
  }).catch((error: BusinessError) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
  })
```

#### bundle.8+ deprecated

从API version 8开始支持，从API version 9开始废弃，建议使用getBundleNameByUid替代。

getNameForUid(uid: number, callback: AsyncCallback<string>) : void

通过uid获取对应的Bundle名称，使用callback异步回调。

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| uid | number | 是 | 要查询的uid。 |
| callback | AsyncCallback<string> | 是 | 程序启动作为入参的回调函数，返回指定uid的Bundle名称。 |

**示例：**

```
import bundle from '@ohos.bundle';

let uid: number = 20010005;

bundle.getNameForUid(uid, (err, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful. Data:' + JSON.stringify(data));
})
```

#### bundle.getAbilityIcon8+ deprecated

从API version 8开始支持，从API version 9开始废弃，建议使用resourceManager.getMediaContent替代。

getAbilityIcon(bundleName: string, abilityName: string): Promise<image.PixelMap>

通过bundleName和abilityName获取对应Icon的PixelMap，使用Promise异步回调。

获取调用方自己的信息时不需要权限。

**需要权限：**

ohos.permission.GET\_BUNDLE\_INFO\_PRIVILEGED 或 ohos.permission.GET\_BUNDLE\_INFO

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| bundleName | string | 是 | 要查询的应用Bundle名称。 |
| abilityName | string | 是 | 要查询的Ability组件名。 |

**返回值：**

| 类型 | 说明 |
| --- | --- |
| Promise<image.PixelMap> | 返回值为PixelMap。 |

**示例：**

```
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';

let bundleName: string = "com.example.myapplication";
let abilityName: string = "EntryAbility";

bundle.getAbilityIcon(bundleName, abilityName)
  .then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
  }).catch((error: BusinessError) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
  })
```

#### bundle.getAbilityIcon8+ deprecated

从API version 8开始支持，从API version 9开始废弃，建议使用resourceManager.getMediaContent替代。

getAbilityIcon(bundleName: string, abilityName: string, callback: AsyncCallback<image.PixelMap>): void

通过bundleName和abilityName获取对应Icon的PixelMap，使用callback异步回调。

获取调用方自己的信息时不需要权限。

**需要权限：**

ohos.permission.GET\_BUNDLE\_INFO\_PRIVILEGED 或 ohos.permission.GET\_BUNDLE\_INFO

**系统能力：**

SystemCapability.BundleManager.BundleFramework

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| bundleName | string | 是 | 要查询的应用Bundle名称。 |
| abilityName | string | 是 | 要查询的Ability组件名。 |
| callback | AsyncCallback<image.PixelMap> | 是 | 程序启动作为入参的回调函数，返回指定PixelMap。 |

**示例：**

```
import bundle from '@ohos.bundle';

let bundleName: string = "com.example.myapplication";
let abilityName: string = "EntryAbility";

bundle.getAbilityIcon(bundleName, abilityName, (err, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful. Data:' + JSON.stringify(data));
})
```

#### InstallErrorCodedeprecated

从API version 7开始支持，从API version 9开始废弃，建议使用包管理子系统通用错误码替代。

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

| 名称 | 值 | 说明 |
| --- | --- | --- |
| SUCCESS | 0 | 安装成功。 |
| STATUS_INSTALL_FAILURE | 1 | 安装失败（不存在安装的应用）。 |
| STATUS_INSTALL_FAILURE_ABORTED | 2 | 安装中止。 |
| STATUS_INSTALL_FAILURE_INVALID | 3 | 安装参数无效。 |
| STATUS_INSTALL_FAILURE_CONFLICT | 4 | 安装冲突 （常见于升级和已有应用基本信息不一致）。 |
| STATUS_INSTALL_FAILURE_STORAGE | 5 | 存储包信息失败。 |
| STATUS_INSTALL_FAILURE_INCOMPATIBLE | 6 | 安装不兼容（常见于版本降级安装或者签名信息错误）。 |
| STATUS_UNINSTALL_FAILURE | 7 | 卸载失败 （不存在卸载的应用）。 |
| STATUS_UNINSTALL_FAILURE_BLOCKED | 8 | 卸载中止 （没有使用）。 |
| STATUS_UNINSTALL_FAILURE_ABORTED | 9 | 卸载中止 （参数无效导致）。 |
| STATUS_UNINSTALL_FAILURE_CONFLICT | 10 | 卸载冲突 （卸载系统应用失败， 结束应用进程失败）。 |
| STATUS_INSTALL_FAILURE_DOWNLOAD_TIMEOUT | 0x0B | 安装失败 （下载超时）。 |
| STATUS_INSTALL_FAILURE_DOWNLOAD_FAILED | 0x0C | 安装失败 （下载失败）。 |
| STATUS_RECOVER_FAILURE_INVALID8+ | 0x0D | 恢复预置应用失败。 |
| STATUS_ABILITY_NOT_FOUND | 0x40 | Ability未找到。 |
| STATUS_BMS_SERVICE_ERROR | 0x41 | BMS服务错误。 |
| STATUS_FAILED_NO_SPACE_LEFT8+ | 0x42 | 设备空间不足。 |
| STATUS_GRANT_REQUEST_PERMISSIONS_FAILED8+ | 0x43 | 应用授权失败。 |
| STATUS_INSTALL_PERMISSION_DENIED8+ | 0x44 | 缺少安装权限。 |
| STATUS_UNINSTALL_PERMISSION_DENIED8+ | 0x45 | 缺少卸载权限。 |

#### BundleFlagdeprecated

从API version 7开始支持，从API version 9开始废弃，建议使用bundleManager.BundleFlag替代。

包信息标志，指示需要获取的包信息的内容。

当接口与标志不匹配时，该标志会被忽略，例如获取application时使用GET\_ABILITY\_INFO\_WITH\_PERMISSION对结果不会产生影响。

标志可以叠加使用，例如使用GET\_APPLICATION\_INFO\_WITH\_PERMISSION + GET\_APPLICATION\_INFO\_WITH\_DISABLE可以使结果同时包含应用权限信息和被禁用的应用信息。

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

| 名称 | 值 | 说明 |
| --- | --- | --- |
| GET_BUNDLE_DEFAULT | 0x00000000 | 获取默认的应用信息。 |
| GET_BUNDLE_WITH_ABILITIES | 0x00000001 | 获取包括Ability信息的包信息。 |
| GET_ABILITY_INFO_WITH_PERMISSION | 0x00000002 | 获取包括权限的Ability信息。 |
| GET_ABILITY_INFO_WITH_APPLICATION | 0x00000004 | 获取包括Application的ability信息。 |
| GET_APPLICATION_INFO_WITH_PERMISSION | 0x00000008 | 获取包括权限的应用信息。 |
| GET_BUNDLE_WITH_REQUESTED_PERMISSION | 0x00000010 | 获取包括所需权限的包信息。 |
| GET_ABILITY_INFO_WITH_METADATA8+ | 0x00000020 | 获取ability的元数据信息。 |
| GET_APPLICATION_INFO_WITH_METADATA8+ | 0x00000040 | 获取应用的元数据信息。 |
| GET_ABILITY_INFO_SYSTEMAPP_ONLY8+ | 0x00000080 | 获取仅包括系统应用的ability信息。 |
| GET_ABILITY_INFO_WITH_DISABLE8+ | 0x00000100 | 获取包括被禁用的ability信息。 |
| GET_APPLICATION_INFO_WITH_DISABLE8+ | 0x00000200 | 获取包括被禁用的应用信息。 |
| GET_ALL_APPLICATION_INFO | 0xFFFF0000 | 获取应用所有的信息。 |

#### BundleOptionsdeprecated

从API version 7开始支持，从API version 9开始废弃，暂无替代接口。

查询选项，包含userId。

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

| 名称 | 类型 | 只读 | 可选 | 说明 |
| --- | --- | --- | --- | --- |
| userId | number | 否 | 是 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 |

#### AbilityTypedeprecated

从API version 7开始支持，从API version 9开始废弃，建议使用bundleManager.AbilityType替代。

Ability组件类型。

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

| 名称 | 值 | 说明 |
| --- | --- | --- |
| UNKNOWN | 无 | 未知Ability类型。 |
| PAGE | 无 | 表示基于Page模板开发的FA，用于提供与用户交互的能力。 |
| SERVICE | 无 | 表示基于Service模板开发的PA，用于提供后台运行任务的能力。 |
| DATA | 无 | 表示基于Data模板开发的PA，用于对外部提供统一的数据访问对象。 |

#### DisplayOrientationdeprecated

从API version 7开始支持，从API version 9开始废弃，建议使用bundleManager.DisplayOrientation替代。

屏幕显示方向。

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

| 名称 | 值 | 说明 |
| --- | --- | --- |
| UNSPECIFIED | 无 | 屏幕方向--不指定。 |
| LANDSCAPE | 无 | 屏幕方向--横屏。 |
| PORTRAIT | 无 | 屏幕方向--竖屏。 |
| FOLLOW_RECENT | 无 | 屏幕方向--紧跟上一个组件。 |

#### LaunchModedeprecated

从API version 7开始支持，从API version 9开始废弃，建议使用bundleManager.LaunchType替代。

Ability组件的启动模式。

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

| 名称 | 值 | 说明 |
| --- | --- | --- |
| SINGLETON | 0 | Ability只有一个实例。 |
| STANDARD | 1 | Ability有多个实例。 |

#### AbilitySubTypedeprecated

从API version 7开始支持，从API version 9开始废弃，暂无替代接口。

Ability组件的子类型。

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

| 名称 | 值 | 说明 |
| --- | --- | --- |
| UNSPECIFIED | 0 | 未定义Ability子类型。 |
| CA | 1 | Ability子类型是带有 UI 的服务。 |

#### ColorModedeprecated

从API version 7开始支持，从API version 9开始废弃，暂无替代接口。

应用、卡片等的颜色模式。

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

| 名称 | 值 | 说明 |
| --- | --- | --- |
| AUTO_MODE | -1 | 自动模式。 |
| DARK_MODE | 0 | 黑色模式。 |
| LIGHT_MODE | 1 | 亮度模式。 |

#### GrantStatusdeprecated

从API version 7开始支持，从API version 9开始废弃，建议使用bundleManager.PermissionGrantState替代。

权限授予状态。

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

| 名称 | 值 | 说明 |
| --- | --- | --- |
| PERMISSION_DENIED | -1 | 拒绝授予权限。 |
| PERMISSION_GRANTED | 0 | 授予权限。 |