@ohos.bundle (Bundle)

The bundle module provides APIs for obtaining information about an application, including bundle information, application information, and ability information. It also provides APIs to obtain and set the application disabling state.

NOTE

The initial APIs of this module are supported since API version 7. Newly added APIs will be marked with a superscript to indicate their earliest API version. This module is deprecated since API version 9.

Modules to Import

import bundle from '@ohos.bundle';

Required Permissions

Required Permissions	Permission Level	Description
ohos.permission.CHANGE_ABILITY_ENABLED_STATE	system_basic	Permission to enable or disable an application or ability.
ohos.permission.GET_BUNDLE_INFO	normal	Permission to query information about a specified bundle.
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED	system_basic	Permission to query information about all bundles.
ohos.permission.INSTALL_BUNDLE	system_core	Permission to install or uninstall bundles.
ohos.permission.REMOVE_CACHE_FILES	system_basic	Permission to clear cache files of a bundle.

For details, see Permission Levels.

bundle.getApplicationInfo^deprecated

This API is deprecated since API version 9.

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

Obtains the application information based on a given bundle name. This API uses a promise to return the result.

No permission is required for obtaining the caller’s own information.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
bundleName	string	Yes	Bundle name.
bundleFlags	number	Yes	Type of information that will be returned. For details about the available enumerated values, see the application information flags in BundleFlag.
userId	number	No	User ID. The default value is the user ID of the caller. The value must be greater than or equal to 0.

Return value

Type	Description
Promise<ApplicationInfo>	Promise used to return the application information.

Example

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.getApplicationInfo^deprecated

This API is deprecated since API version 9.

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

Obtains the application information of the specified user based on a given bundle name. This API uses an asynchronous callback to return the result.

No permission is required for obtaining the caller’s own information.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
bundleName	string	Yes	Bundle name.
bundleFlags	number	Yes	Type of information that will be returned. For details about the available enumerated values, see the application information flags in BundleFlag.
userId	number	Yes	User ID. The value must be greater than or equal to 0.
callback	AsyncCallback<ApplicationInfo>	Yes	Callback used to return the application information.

Example

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.getApplicationInfo^deprecated

This API is deprecated since API version 9.

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

Obtains the application information based on a given bundle name. This API uses an asynchronous callback to return the result.

No permission is required for obtaining the caller’s own information.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
bundleName	string	Yes	Bundle name.
bundleFlags	number	Yes	Type of information that will be returned. For details about the available enumerated values, see the application information flags in BundleFlag.
callback	AsyncCallback<ApplicationInfo>	Yes	Callback used to return the application information.

Example

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.getAllBundleInfo^deprecated

This API is deprecated since API version 9.

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

Obtains the information of all bundles of the specified user. This API uses a promise to return the result.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
bundleFlag	BundleFlag	Yes	Type of information that will be returned. For details about the available enumerated values, see the bundle information flags in BundleFlag.
userId	number	No	User ID. The default value is the user ID of the caller. The value must be greater than or equal to 0.

Return value

Type	Description
Promise>	Promise used to return the information of all bundles.

Example

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.getAllBundleInfo^deprecated

This API is deprecated since API version 9.

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

Obtains the information of all bundles of the current user. This API uses an asynchronous callback to return the result.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
bundleFlag	BundleFlag	Yes	Type of information that will be returned. For details about the available enumerated values, see the bundle information flags in BundleFlag.
callback	AsyncCallback>	Yes	Callback used to return the information of all bundles.

Example

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.getAllBundleInfo^deprecated

This API is deprecated since API version 9.

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

Obtains the information of all bundles of the specified user. This API uses an asynchronous callback to return the result.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
bundleFlag	BundleFlag	Yes	Type of information that will be returned. For details about the available enumerated values, see the bundle information flags in BundleFlag.
userId	number	Yes	User ID. The default value is the user ID of the caller. The value must be greater than or equal to 0.
callback	AsyncCallback>	Yes	Callback used to return the information of all bundles.

Example

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.getBundleInfo^deprecated

This API is deprecated since API version 9.

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

Obtains the bundle information based on a given bundle name. This API uses a promise to return the result.

No permission is required for obtaining the caller’s own information.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
bundleName	string	Yes	Bundle name.
bundleFlags	number	Yes	Type of information that will be returned. For details about the available enumerated values, see the bundle information flags in BundleFlag.
options	BundleOptions	No	Options that contain the user ID.

Return value

Type	Description
Promise<BundleInfo>	Promise used to return the bundle information.

Example

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.getBundleInfo^deprecated

This API is deprecated since API version 9.

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

Obtains the bundle information based on a given bundle name. This API uses an asynchronous callback to return the result.

No permission is required for obtaining the caller’s own information.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
bundleName	string	Yes	Bundle name.
bundleFlags	number	Yes	Type of information that will be returned. For details about the available enumerated values, see the bundle information flags in BundleFlag.
callback	AsyncCallback<BundleInfo>	Yes	Callback used to return the bundle information.

Example

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.getBundleInfo^deprecated

This API is deprecated since API version 9.

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

Obtains the bundle information based on a given bundle name and bundle options. This API uses an asynchronous callback to return the result.

No permission is required for obtaining the caller’s own information.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
bundleName	string	Yes	Bundle name.
bundleFlags	number	Yes	Type of information that will be returned. For details about the available enumerated values, see the bundle information flags in BundleFlag.
options	BundleOptions	Yes	Includes userId.
callback	AsyncCallback<BundleInfo>	Yes	Callback used to return the bundle information.

Example

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.getBundleInstaller^deprecated

This API is deprecated since API version 9. You are advised to use installer.getBundleInstaller instead.

getBundleInstaller(): Promise&lt;BundleInstaller&gt;;

Obtains the installation package. This API uses a promise to return the result.

Required permissions

ohos.permission.INSTALL_BUNDLE

System capability

SystemCapability.BundleManager.BundleFramework

System API

This is a system API.

Return value

Type	Description
Promise<BundleInstaller>	Promise used to return the installation package.

Example

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

bundle.getBundleInstaller().then((data) => {
    console.info('getBundleInstaller successfully.');
}).catch((error: BusinessError) => {
    console.error('getBundleInstaller failed.');
});

bundle.getBundleInstaller^deprecated

This API is deprecated since API version 9. You are advised to use installer.getBundleInstaller instead.

getBundleInstaller(callback: AsyncCallback&lt;BundleInstaller&gt;): void;

Obtains the installation package. This API uses an asynchronous callback to return the result.

Required permissions

ohos.permission.INSTALL_BUNDLE

System capability

SystemCapability.BundleManager.BundleFramework

System API

This is a system API.

Parameters

Name	Type	Mandatory	Description
callback	AsyncCallback<BundleInstaller>	Yes	Callback used to return the installation package.

Example

import bundle from '@ohos.bundle';

bundle.getBundleInstaller((err, data) => {
    if (err.code == 0) {
        console.error('getBundleInstaller failed.');
    } else {
        console.info('getBundleInstaller successfully');
    }
});

bundle.cleanBundleCacheFiles^{8+ deprecated}

This API is deprecated since API version 9. You are advised to use bundleManager.cleanBundleCacheFiles instead.

cleanBundleCacheFiles(bundleName: string, callback: AsyncCallback&lt;void&gt;): void;

Clears the cache data of an application. This API uses an asynchronous callback to return the result.

Required permissions

ohos.permission.REMOVE_CACHE_FILES

System capability

SystemCapability.BundleManager.BundleFramework

System API

This is a system API.

Parameters

Name	Type	Mandatory	Description
bundleName	string	Yes	Bundle name.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Example

import bundle from '@ohos.bundle';

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

bundle.cleanBundleCacheFiles(bundleName, err => {
    if (err) {
        console.error('cleanBundleCacheFiles failed.');
    } else {
        console.info('cleanBundleCacheFiles successfully.');
    }
});

bundle.cleanBundleCacheFiles^{8+ deprecated}

This API is deprecated since API version 9. You are advised to use bundleManager.cleanBundleCacheFiles instead.

cleanBundleCacheFiles(bundleName: string): Promise&lt;void&gt;

Clears the cache data of an application. This API uses a promise to return the result.

Required permissions

ohos.permission.REMOVE_CACHE_FILES

System capability

SystemCapability.BundleManager.BundleFramework

System API

This is a system API.

Parameters

Name	Type	Mandatory	Description
bundleName	string	Yes	Bundle name.

Return value

Type	Description
Promise<void>	Promise that returns no value.

Example

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

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

bundle.cleanBundleCacheFiles(bundleName).then(()=> {
    console.info('cleanBundleCacheFiles successfully.');
}).catch((error: BusinessError) => {
    console.error('cleanBundleCacheFiles failed.');
});

bundle.setApplicationEnabled^{8+ deprecated}

This API is deprecated since API version 9. You are advised to use bundleManager.setApplicationEnabled instead.

setApplicationEnabled(bundleName: string, isEnable: boolean, callback: AsyncCallback&lt;void&gt;): void;

Sets whether to enable an application. This API uses an asynchronous callback to return the result.

Required permissions

ohos.permission.CHANGE_ABILITY_ENABLED_STATE

System capability

SystemCapability.BundleManager.BundleFramework

System API

This is a system API.

Parameters

Name	Type	Mandatory	Description
bundleName	string	Yes	Bundle name.
isEnable	boolean	Yes	Whether to enable the application. The value true means to enable the application, and false means the opposite.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Example

import bundle from '@ohos.bundle';

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

bundle.setApplicationEnabled(bundleName, false, err => {
    if (err) {
        console.error('setApplicationEnabled failed.');
    } else {
        console.info('setApplicationEnabled successfully.');
    }
});

bundle.setApplicationEnabled^{8+ deprecated}

This API is deprecated since API version 9. You are advised to use bundleManager.setApplicationEnabled instead.

setApplicationEnabled(bundleName: string, isEnable: boolean): Promise&lt;void&gt;

Sets whether to enable an application. This API uses a promise to return the result.

Required permissions

ohos.permission.CHANGE_ABILITY_ENABLED_STATE

System capability

SystemCapability.BundleManager.BundleFramework

System API

This is a system API.

Parameters

Name	Type	Mandatory	Description
bundleName	string	Yes	Bundle name.
isEnable	boolean	Yes	Whether to enable the application. The value true means to enable the application, and false means the opposite.

Return value

Type	Description
Promise<void>	Promise that returns no value.

Example

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

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

bundle.setApplicationEnabled(bundleName, false).then(()=> {
    console.info('setApplicationEnabled successfully.');
}).catch((error: BusinessError) => {
    console.error('setApplicationEnabled failed.');
});

bundle.setAbilityEnabled^{8+ deprecated}

This API is deprecated since API version 9. You are advised to use bundleManager.setAbilityEnabled instead.

setAbilityEnabled(info: AbilityInfo, isEnable: boolean, callback: AsyncCallback&lt;void&gt;): void;

Sets whether to enable an ability. This API uses an asynchronous callback to return the result.

Required permissions

ohos.permission.CHANGE_ABILITY_ENABLED_STATE

System capability

SystemCapability.BundleManager.BundleFramework

System API

This is a system API.

Parameters

Name	Type	Mandatory	Description
info	AbilityInfo	Yes	Ability information.
isEnable	boolean	Yes	Whether to enable the application. The value true means to enable the application, and false means the opposite.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

bundle.setAbilityEnabled^{8+ deprecated}

This API is deprecated since API version 9. You are advised to use bundleManager.setAbilityEnabled instead.

setAbilityEnabled(info: AbilityInfo, isEnable: boolean): Promise&lt;void&gt;

Sets whether to enable an ability. This API uses a promise to return the result.

Required permissions

ohos.permission.CHANGE_ABILITY_ENABLED_STATE

System capability

SystemCapability.BundleManager.BundleFramework

System API

This is a system API.

Parameters

Name	Type	Mandatory	Description
info	AbilityInfo	Yes	Ability information.
isEnable	boolean	Yes	Whether to enable the application. The value true means to enable the application, and false means the opposite.

Return value

Type	Description
Promise<void>	Promise that returns no value.

Example

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) => {
    console.info('getAbilityInfo successfully. Data: ' + JSON.stringify(abilityInfo));

    bundle.setAbilityEnabled(abilityInfo, false).then(data => {
        console.info('setAbilityEnabled successfully.');
    }).catch((error: BusinessError) => {
        console.error('setAbilityEnabled failed:' + JSON.stringify(error));
    })
}).catch((error: BusinessError) => {
    console.error('getAbilityInfo failed. Cause: ' + JSON.stringify(error));
});

bundle.getPermissionDef^{8+ deprecated}

This API is deprecated since API version 9. You are advised to use bundleManager.getPermissionDef instead.

getPermissionDef(permissionName: string, callback: AsyncCallback&lt;PermissionDef&gt;): void;

Obtains the permission details by permission name. This API uses an asynchronous callback to return the result.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

System capability

SystemCapability.BundleManager.BundleFramework

System API

This is a system API.

Parameters

Name	Type	Mandatory	Description
permissionName	string	Yes	Name of the permission.
callback	AsyncCallback<PermissionDef>	Yes	Callback used to return the permission details.

Example

import bundle from '@ohos.bundle';

let permission: string = "ohos.permission.GET_BUNDLE_INFO";
bundle.getPermissionDef(permission, (err, data) => {
    if (err) {
        console.error('getPermissionDef failed:' + err.message);
    } else {
        console.info('getPermissionDef successfully:' + JSON.stringify(data));
    }
});

bundle.getPermissionDef^{8+ deprecated}

This API is deprecated since API version 9. You are advised to use bundleManager.getPermissionDef instead.

getPermissionDef(permissionName: string): Promise&lt;PermissionDef&gt;

Obtains the permission details by permission name. This API uses a promise to return the result.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

System capability

SystemCapability.BundleManager.BundleFramework

System API

This is a system API.

Parameters

Name	Type	Mandatory	Description
permissionName	string	Yes	Name of the permission.

Return value

Type	Description
Promise<PermissionDef>	Promise used to return the permission details.

Example

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

let permissionName: string = "ohos.permission.GET_BUNDLE_INFO";
bundle.getPermissionDef(permissionName).then((data) => {
    console.info('getPermissionDef successfully. Data: ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
    console.error('getPermissionDef failed. Cause: ' + error.message);
});

bundle.getAllApplicationInfo^deprecated

This API is deprecated since API version 9.

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

Obtains the information about all applications of the specified user. This API uses a promise to return the result.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
bundleFlags	number	Yes	Type of information that will be returned. For details about the available enumerated values, see the application information flags in BundleFlag.
userId	number	No	User ID. The default value is the user ID of the caller. The value must be greater than or equal to 0.

Return value

Type	Description
Promise>	Promise used to return the application information.

Example

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.getAllApplicationInfo^deprecated

This API is deprecated since API version 9.

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

Obtains the information about all applications. This API uses an asynchronous callback to return the result.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
bundleFlags	number	Yes	Type of information that will be returned. For details about the available enumerated values, see the application information flags in BundleFlag.
userId	number	Yes	User ID. The default value is the user ID of the caller. The value must be greater than or equal to 0.
callback	AsyncCallback>	Yes	Callback used to return the application information.

Example

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.getAllApplicationInfo^deprecated

This API is deprecated since API version 9.

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

Obtains the information about all applications of the current user. This API uses an asynchronous callback to return the result.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
bundleFlags	number	Yes	Type of information that will be returned. For details about the available enumerated values, see the application information flags in BundleFlag.
callback	AsyncCallback>	Yes	Callback used to return the application information.

Example

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.getBundleArchiveInfo^deprecated

This API is deprecated since API version 9.

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

Obtains information about the bundles contained in a HAP file. This API uses a promise to return the result.

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
hapFilePath	string	Yes	Path where the HAP file is stored. The absolute path of the application and the data directory sandbox path are supported.
bundleFlags	number	Yes	Flags used to specify information contained in the BundleInfo object that will be returned. For details about the available enumerated values, see the bundle information flags in BundleFlag.

Return value |Type |Description | |—————————————————-|————————————————————| |Promise<BundleInfo>|Promise used to return the information about the bundles.|

Example

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.getBundleArchiveInfo^deprecated

This API is deprecated since API version 9.

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

Obtains information about the bundles contained in a HAP file. This API uses an asynchronous callback to return the result.

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
hapFilePath	string	Yes	Path where the HAP file is stored. The absolute path of the application and the data directory sandbox path are supported.
bundleFlags	number	Yes	Flags used to specify information contained in the BundleInfo object that will be returned. For details about the available enumerated values, see the bundle information flags in BundleFlag.
callback	AsyncCallback<BundleInfo>	Yes	Callback used to return the information about the bundles.

Example

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.getAbilityInfo^deprecated

This API is deprecated since API version 9.

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

Obtains the ability information based on a given bundle name and ability name. This API uses a promise to return the result.

No permission is required for obtaining the caller’s own information.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
bundleName	string	Yes	Bundle name.
abilityName	string	Yes	Ability name.

Return value

Type	Description
Promise<AbilityInfo>	Promise used to return the ability information.

Example

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.getAbilityInfo^deprecated

This API is deprecated since API version 9.

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

Obtains the ability information based on a given bundle name and ability name. This API uses an asynchronous callback to return the result.

No permission is required for obtaining the caller’s own information.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
bundleName	string	Yes	Bundle name.
abilityName	string	Yes	Ability name.
callback	AsyncCallback<AbilityInfo>	Yes	Callback used to return the ability information.

Example

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.getAbilityLabel^{8+ deprecated}

This API is deprecated since API version 9.

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

Obtains the application name based on a given bundle name and ability name. This API uses a promise to return the result.

No permission is required for obtaining the caller’s own information.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
bundleName	string	Yes	Bundle name.
abilityName	string	Yes	Ability name.

Return value

Type	Description
Promise<string>	Promise used to return the application name.

Example

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.getAbilityLabel^{8+ deprecated}

This API is deprecated since API version 9.

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

Obtains the application name based on a given bundle name and ability name. This API uses an asynchronous callback to return the result.

No permission is required for obtaining the caller’s own information.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
bundleName	string	Yes	Bundle name.
abilityName	string	Yes	Ability name.
callback	AsyncCallback<string>	Yes	Callback used to return the application name.

Example

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.isAbilityEnabled^{8+ deprecated}

This API is deprecated since API version 9.

isAbilityEnabled(info: AbilityInfo): Promise<boolean>

Checks whether the ability that matches a given AbilityInfo object is enabled. This API uses a promise to return the result.

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
info	AbilityInfo	Yes	Ability information.

Return value

Type	Description
Promise<boolean>	Promise used to return the result. If the ability is enabled, true will be returned; otherwise, false will be returned.

Example

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.isAbilityEnabled^{8+ deprecated}

This API is deprecated since API version 9.

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

Checks whether the ability that matches a given AbilityInfo object is enabled. This API uses an asynchronous callback to return the result.

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
info	AbilityInfo	Yes	Ability information.
callback	AsyncCallback<boolean>	Yes	Callback used to return the result. If the ability is enabled, true will be returned; otherwise, false will be returned.

Example

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.isApplicationEnabled^{8+ deprecated}

This API is deprecated since API version 9.

isApplicationEnabled(bundleName: string): Promise<boolean>

Checks whether an application is enabled based on a given bundle name. This API uses a promise to return the result.

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
bundleName	string	Yes	Bundle name.

Return value

Type	Description
Promise<boolean>	Promise used to return the result. If the application is enabled, true will be returned; otherwise, false will be returned.

Example

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.isApplicationEnabled^{8+ deprecated}

This API is deprecated since API version 9.

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

Checks whether an application is enabled based on a given bundle name. This API uses an asynchronous callback to return the result.

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
bundleName	string	Yes	Bundle name.
callback	AsyncCallback<boolean>	Yes	Callback used to return the result. If the application is enabled, true will be returned; otherwise, false will be returned.

Example

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.queryAbilityByWant^deprecated

This API is deprecated since API version 9.

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

Obtains the ability information based on given Want. This API uses a promise to return the result.

No permission is required for obtaining the caller’s own information.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
want	Want	Yes	Want containing the bundle name.
bundleFlags	number	Yes	Ability information to be returned. For details about the available enumerated values, see the ability information flags in BundleFlag.
userId	number	No	User ID. The default value is the user ID of the caller. The value must be greater than or equal to 0.

Return value

Type	Description
Promise>	Promise used to return the ability information.

Example

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.queryAbilityByWant^deprecated

This API is deprecated since API version 9.

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

Obtains the ability information of the specified user based on given Want. This API uses an asynchronous callback to return the result.

No permission is required for obtaining the caller’s own information.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
want	Want	Yes	Want containing the bundle name.
bundleFlags	number	Yes	Ability information to be returned. For details about the available enumerated values, see the ability information flags in BundleFlag.
userId	number	Yes	User ID. The value must be greater than or equal to 0.
callback	AsyncCallback>	Yes	Callback used to return the ability information.

Example

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.queryAbilityByWant^deprecated

This API is deprecated since API version 9.

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

Obtains the ability information based on given Want. This API uses an asynchronous callback to return the result.

No permission is required for obtaining the caller’s own information.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
want	Want	Yes	Want containing the bundle name.
bundleFlags	number	Yes	Ability information to be returned. For details about the available enumerated values, see the ability information flags in BundleFlag.
callback	AsyncCallback>	Yes	Callback used to return the ability information.

Example

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.getLaunchWantForBundle^deprecated

This API is deprecated since API version 9.

getLaunchWantForBundle(bundleName: string): Promise<Want>

Obtains the Want object that launches the specified application. This API uses a promise to return the result.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
bundleName	string	Yes	Bundle name.

Return value |Type |Description | |————–|————————————–| |Promise<Want>|Promise used to return the Want object.|

Example

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.getLaunchWantForBundle^deprecated

This API is deprecated since API version 9.

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

Obtains the Want object that launches the specified application. This API uses an asynchronous callback to return the result.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
bundleName	string	Yes	Bundle name.
callback	AsyncCallback<Want>	Yes	Callback used to return the Want object.

Example

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.getNameForUid^{8+ deprecated}

This API is deprecated since API version 9.

getNameForUid(uid: number): Promise<string>

Obtains the bundle name based on a UID. This API uses a promise to return the result.

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
uid	number	Yes	UID based on which the bundle name is to obtain.

Return value |Type |Description | |—————-|———————————| |Promise<string>|Promise used to return the bundle name.|

Example

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.getNameForUid^{8+ deprecated}

This API is deprecated since API version 9.

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

Obtains the bundle name based on a UID. This API uses an asynchronous callback to return the result.

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
uid	number	Yes	UID based on which the bundle name is to obtain.
callback	AsyncCallback<string>	Yes	Callback used to return the bundle name.

Example

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.getAbilityIcon^{8+ deprecated}

This API is deprecated since API version 9. You are advised to use resourceManager.getMediaContent instead.

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

Obtains the pixel map of the icon corresponding to a given bundle name and ability name. This API uses a promise to return the result.

No permission is required for obtaining the caller’s own information.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
bundleName	string	Yes	Bundle name.
abilityName	string	Yes	Ability name.

Return value |Type |Description | |———————|————————————————————| |Promise<image.PixelMap>|Promise used to return the pixel map.|

Example

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.getAbilityIcon^{8+ deprecated}

This API is deprecated since API version 9. You are advised to use resourceManager.getMediaContent instead.

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

Obtains the pixel map of the icon corresponding to a given bundle name and ability name. This API uses an asynchronous callback to return the result.

No permission is required for obtaining the caller’s own information.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

System capability

SystemCapability.BundleManager.BundleFramework

Parameters

Name	Type	Mandatory	Description
bundleName	string	Yes	Bundle name.
abilityName	string	Yes	Ability name.
callback	AsyncCallback<image.PixelMap>	Yes	Callback used to return the pixel map.

Example

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));
})

InstallErrorCode^deprecated

This API is deprecated since API version 9. You are not advised using it anymore.

System capability: SystemCapability.BundleManager.BundleFramework

Name	Value	Description
SUCCESS	0	Installation succeeded.
STATUS_INSTALL_FAILURE	1	Installation failed. (The application to be installed is not found.)
STATUS_INSTALL_FAILURE_ABORTED	2	Installation aborted.
STATUS_INSTALL_FAILURE_INVALID	3	Invalid installation parameter.
STATUS_INSTALL_FAILURE_CONFLICT	4	Installation conflict. (The basic information of the application to update is inconsistent with that of the existing application.)
STATUS_INSTALL_FAILURE_STORAGE	5	Failed to store the bundle information.
STATUS_INSTALL_FAILURE_INCOMPATIBLE	6	Installation incompatibility. (A downgrade occurs or the signature information is incorrect.)
STATUS_UNINSTALL_FAILURE	7	Uninstallation failed. (The application to be uninstalled is not found.)
STATUS_UNINSTALL_FAILURE_BLOCKED	8	Uninstallation aborted. (This error code is not in use.)
STATUS_UNINSTALL_FAILURE_ABORTED	9	Uninstallation aborted. (Invalid parameters.)
STATUS_UNINSTALL_FAILURE_CONFLICT	10	Uninstallation conflict. (Failed to uninstall a system application or end the application process.)
STATUS_INSTALL_FAILURE_DOWNLOAD_TIMEOUT	0x0B	Installation failed. (Download timed out.)
STATUS_INSTALL_FAILURE_DOWNLOAD_FAILED	0x0C	Installation failed. (Download failed.)
STATUS_RECOVER_FAILURE_INVALID8+	0x0D	Failed to restore the pre-installed application.
STATUS_ABILITY_NOT_FOUND	0x40	Ability not found.
STATUS_BMS_SERVICE_ERROR	0x41	BMS service error.
STATUS_FAILED_NO_SPACE_LEFT8+	0x42	Insufficient device space.
STATUS_GRANT_REQUEST_PERMISSIONS_FAILED8+	0x43	Application authorization failed.
STATUS_INSTALL_PERMISSION_DENIED8+	0x44	No installation permission.
STATUS_UNINSTALL_PERMISSION_DENIED8+	0x45	No uninstallation permission.

BundleFlag^deprecated

This API is deprecated since API version 9. You are advised to use bundleManager.BundleFlag instead.

Enumerates the bundle flags, which indicate the type of bundle information to obtain.

If an API does not match the flag, the flag is ignored. For example, using GET_ABILITY_INFO_WITH_PERMISSION to obtain the application information does not affect the result.

Flags can be used together. For example, you can use the combination of GET_APPLICATION_INFO_WITH_PERMISSION and GET_APPLICATION_INFO_WITH_DISABLE to obtain the result that contains both application permission information and disabled application information.

System capability: SystemCapability.BundleManager.BundleFramework

Name	Value	Description
GET_BUNDLE_DEFAULT	0x00000000	Obtains the default application information.
GET_BUNDLE_WITH_ABILITIES	0x00000001	Obtains the bundle information with the ability information.
GET_ABILITY_INFO_WITH_PERMISSION	0x00000002	Obtains the ability information with the permission information.
GET_ABILITY_INFO_WITH_APPLICATION	0x00000004	Obtains the ability information with the application information.
GET_APPLICATION_INFO_WITH_PERMISSION	0x00000008	Obtains the application information with the permission information.
GET_BUNDLE_WITH_REQUESTED_PERMISSION	0x00000010	Obtains the bundle information with the information about the required permissions.
GET_ABILITY_INFO_WITH_METADATA8+	0x00000020	Obtains the ability metadata information.
GET_APPLICATION_INFO_WITH_METADATA8+	0x00000040	Obtains the application metadata information.
GET_ABILITY_INFO_SYSTEMAPP_ONLY8+	0x00000080	Obtains the ability information of system applications.
GET_ABILITY_INFO_WITH_DISABLE8+	0x00000100	Obtains information about disabled abilities.
GET_APPLICATION_INFO_WITH_DISABLE8+	0x00000200	Obtains information about disabled applications.
GET_ALL_APPLICATION_INFO	0xFFFF0000	Obtains all application information.

BundleOptions^deprecated

This API is deprecated since API version 9. You are not advised using it anymore.

Options that contain the user ID.

System capability: SystemCapability.BundleManager.BundleFramework

Name	Type	Readable	Writable	Description
userId	number	Yes	Yes	User ID. The default value is the user ID of the caller. The value must be greater than or equal to 0.

AbilityType^deprecated

This API is deprecated since API version 9. You are advised to use bundleManager.AbilityType instead.

Enumerates the ability types.

System capability: SystemCapability.BundleManager.BundleFramework

Name	Value	Description
UNKNOWN	None	Unknown ability type.
PAGE	None	FA developed using the Page template to provide the capability of interacting with users.
SERVICE	None	PA developed using the Service template to provide the capability of running tasks in the background.
DATA	None	PA developed using the Data template to provide unified data access for external systems.

DisplayOrientation^deprecated

This API is deprecated since API version 9. You are advised to use bundleManager.DisplayOrientation instead.

Enumerates display orientations.

System capability: SystemCapability.BundleManager.BundleFramework

Name	Value	Description
UNSPECIFIED	None	Unspecified display orientation.
LANDSCAPE	None	Landscape orientation.
PORTRAIT	None	Portrait orientation.
FOLLOW_RECENT	None	Orientation same as that of the nearest ability in the stack.

LaunchMode^deprecated

This API is deprecated since API version 9. You are advised to use bundleManager.LaunchType instead.

Enumerates the ability launch modes.

System capability: SystemCapability.BundleManager.BundleFramework

Name	Value	Description
SINGLETON	0	The ability has only one instance.
STANDARD	1	The ability can have multiple instances.

AbilitySubType^deprecated

This API is deprecated since API version 9. You are not advised using it anymore.

Enumerates the ability subtypes.

System capability: SystemCapability.BundleManager.BundleFramework

Name	Value	Description
UNSPECIFIED	0	Undefined ability subtype.
CA	1	Ability that has a UI.

ColorMode^deprecated

This API is deprecated since API version 9. You are not advised using it anymore.

Enumerates the color modes of applications and widgets.

System capability: SystemCapability.BundleManager.BundleFramework

Name	Value	Description
AUTO_MODE	-1	Automatic mode.
DARK_MODE	0	Dark mode.
LIGHT_MODE	1	Light mode.

GrantStatus^deprecated

This API is deprecated since API version 9. You are advised to use bundleManager.PermissionGrantState instead.

Enumerates the permission grant states.

System capability: SystemCapability.BundleManager.BundleFramework

Name	Value	Description
PERMISSION_DENIED	-1	Permission denied.
PERMISSION_GRANTED	0	Permission granted.

你可能感兴趣的鸿蒙文章

harmony 鸿蒙APIs

harmony 鸿蒙System Common Events (To Be Deprecated Soon)

harmony 鸿蒙System Common Events

harmony 鸿蒙API Reference Document Description

harmony 鸿蒙Enterprise Device Management Overview (for System Applications Only)

harmony 鸿蒙BundleStatusCallback

harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager)

harmony 鸿蒙@ohos.distributedBundle (Distributed Bundle Management)

harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (EnterpriseAdminExtensionAbility)

harmony 鸿蒙@ohos.WallpaperExtensionAbility (WallpaperExtensionAbility)