@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.

Modules to Import

import bundle from '@ohos.bundle';

Required Permissions

Required Permissions Permission Level Description
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.MANAGE_DISPOSED_APP_STATUS system_core Permission to set and query the application disposal status.

For details, see Permission Levels.

bundle.getApplicationInfodeprecated

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

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

let bundleName = "com.example.myapplication";
let bundleFlags = 0;
let userId = 100;
bundle.getApplicationInfo(bundleName, bundleFlags, userId)
.then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})

bundle.getApplicationInfodeprecated

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

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

let bundleName = "com.example.myapplication";
let bundleFlags = 0;
let userId = 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

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

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

let bundleName = "com.example.myapplication";
let bundleFlags = 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

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

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<Array<BundleInfo>> Promise used to return the information of all bundles.

Example

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

bundle.getAllBundleInfodeprecated

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

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<Array<BundleInfo>> Yes Callback used to return the information of all bundles.

Example

let bundleFlag = 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

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

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<Array<BundleInfo>> Yes Callback used to return the information of all bundles.

|

Example

let bundleFlag = 0;
let userId = 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

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

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

let bundleName = "com.example.myapplication";
let bundleFlags = 1;
let options = {
  "userId" : 100
};
bundle.getBundleInfo(bundleName, bundleFlags, options)
.then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})

bundle.getBundleInfodeprecated

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

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

let bundleName = "com.example.myapplication";
let bundleFlags = 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

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

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

let bundleName = "com.example.myapplication";
let bundleFlags = 1;
let options = {
  "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.getBundleInstallerdeprecated

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

getBundleInstaller(): Promise<BundleInstaller>;

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 and cannot be called by third-party applications.

Return value

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

Example

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

bundle.getBundleInstallerdeprecated

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

getBundleInstaller(callback: AsyncCallback<BundleInstaller>): 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 and cannot be called by third-party applications.

Parameters

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

Example

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

bundle.cleanBundleCacheFiles8+ deprecated

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

cleanBundleCacheFiles(bundleName: string, callback: AsyncCallback<void>): 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 and cannot be called by third-party applications.

Parameters

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

Example

let bundleName = "com.example.myapplication";

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

bundle.cleanBundleCacheFiles8+ deprecated

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

cleanBundleCacheFiles(bundleName: string): Promise<void>

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 and cannot be called by third-party applications.

Parameters

Name Type Mandatory Description
bundleName string Yes Bundle name.

Return value

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

Example

let bundleName = "com.example.myapplication";

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

bundle.setApplicationEnabled8+ deprecated

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

setApplicationEnabled(bundleName: string, isEnable: boolean, callback: AsyncCallback<void>): 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 and cannot be called by third-party applications.

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

let bundleName = "com.example.myapplication";

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

bundle.setApplicationEnabled8+ deprecated

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

setApplicationEnabled(bundleName: string, isEnable: boolean): Promise<void>

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 and cannot be called by third-party applications.

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

let bundleName = "com.example.myapplication";

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

bundle.setAbilityEnabled8+ deprecated

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

setAbilityEnabled(info: AbilityInfo, isEnable: boolean, callback: AsyncCallback<void>): 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 and cannot be called by third-party applications.

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.setAbilityEnabled8+ deprecated

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

setAbilityEnabled(info: AbilityInfo, isEnable: boolean): Promise<void>

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 and cannot be called by third-party applications.

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

let flag = bundle.BundleFlag.GET_ABILITY_INFO_WITH_PERMISSION;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
    abilityName : "com.example.myapplication.MainAbility"
};

bundle.getAbilityInfo(want, flag, userId).then((abilityInfo) => {
    console.info('getAbilityInfo successfully. Data: ' + JSON.stringify(abilityInfo));

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

bundle.getPermissionDef8+ deprecated

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

getPermissionDef(permissionName: string, callback: AsyncCallback<PermissionDef>): 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 and cannot be called by third-party applications.

Parameters

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

Example

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

bundle.getPermissionDef8+ deprecated

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

getPermissionDef(permissionName: string): Promise<PermissionDef>

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 and cannot be called by third-party applications.

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

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

bundle.getAllApplicationInfodeprecated

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

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<Array<ApplicationInfo>> Promise used to return the application information.

Example

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

bundle.getAllApplicationInfodeprecated

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

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<Array<ApplicationInfo>> Yes Callback used to return the application information.

Example

let bundleFlags = bundle.BundleFlag.GET_APPLICATION_INFO_WITH_PERMISSION;
let userId = 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

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

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<Array<ApplicationInfo>> Yes Callback used to return the application information.

Example

let bundleFlags = 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

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

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

let hapFilePath = "/data/storage/el2/base/test.hap";
let bundleFlags = 0;
bundle.getBundleArchiveInfo(hapFilePath, bundleFlags)
.then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})

bundle.getBundleArchiveInfodeprecated

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

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

let hapFilePath = "/data/storage/el2/base/test.hap";
let bundleFlags = 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

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

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

let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityInfo(bundleName, abilityName)
.then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})

bundle.getAbilityInfodeprecated

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

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

let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
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

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

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

let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityLabel(bundleName, abilityName)
.then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})

bundle.getAbilityLabel8+ deprecated

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

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

let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
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

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

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

let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityInfo(bundleName, abilityName).then((abilityInfo)=>{
    bundle.isAbilityEnabled(abilityInfo).then((data) => {
        console.info('Operation successful. Data: ' + JSON.stringify(data));
    }).catch((error) => {
        console.error('Operation failed. Cause: ' + JSON.stringify(error));
    })
})

bundle.isAbilityEnabled8+ deprecated

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

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

let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
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

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

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

let bundleName = "com.example.myapplication";
bundle.isApplicationEnabled(bundleName)
.then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})

bundle.isApplicationEnabled8+ deprecated

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

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

let bundleName = "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

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

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<Array<AbilityInfo>> Promise used to return the ability information.

Example

let bundleFlags = 0;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
    abilityName : "com.example.myapplication.MainAbility"
};
bundle.queryAbilityByWant(want, bundleFlags, userId)
.then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})

bundle.queryAbilityByWantdeprecated

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

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<Array<AbilityInfo>> Yes Callback used to return the ability information.

Example

let bundleFlags = 0;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
    abilityName : "com.example.myapplication.MainAbility"
};
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

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

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<Array<AbilityInfo>> Yes Callback used to return the ability information.

Example

let bundleFlags = 0;
let want = {
    bundleName : "com.example.myapplication",
    abilityName : "com.example.myapplication.MainAbility"
};
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

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

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

let bundleName = "com.example.myapplication";
bundle.getLaunchWantForBundle(bundleName)
.then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})

bundle.getLaunchWantForBundledeprecated

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

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

let bundleName = "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

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

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

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

bundle.getNameForUid8+ deprecated

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

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

let uid = 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

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

let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityIcon(bundleName, abilityName)
.then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})

bundle.getAbilityIcon8+ 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

let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
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

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.

BundleFlagdeprecated

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.

BundleOptionsdeprecated

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.

AbilityTypedeprecated

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.

DisplayOrientationdeprecated

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.

LaunchModedeprecated

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.

AbilitySubTypedeprecated

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.

ColorModedeprecated

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.

GrantStatusdeprecated

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.