@ohos.bundle (Bundle Module)
The 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.
The APIs of this module have been deprecated since API version 9. You are advised to use @ohos.bundle.bundleManager instead.
Modules to Import
import bundle from '@ohos.bundle';
Required Permissions
| Permission | APL | 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. |
For details about the APL, see Basic Concepts in the Permission Mechanism.
bundle.getApplicationInfodeprecated
NOTE
This API has been supported since API version 7 and deprecated since API version 9. Its substitute is available only to system applications. You are advised to use 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
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';
let bundleName: string = "com.example.myapplication";
let bundleFlags: number = 0;
let userId: number = 100;
bundle.getApplicationInfo(bundleName, bundleFlags, userId)
.then((data) => {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getApplicationInfodeprecated
NOTE
This API has been supported since API version 7 and deprecated since API version 9. Its substitute is available only to system applications. You are advised to use 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
import bundle from '@ohos.bundle';
let bundleName: string = "com.example.myapplication";
let bundleFlags: number = 0;
let userId: number = 100;
bundle.getApplicationInfo(bundleName, bundleFlags, userId, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getApplicationInfodeprecated
NOTE
This API has been supported since API version 7 and deprecated since API version 9. Its substitute is available only to system applications. You are advised to use 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
import bundle from '@ohos.bundle';
let bundleName: string = "com.example.myapplication";
let bundleFlags: number = 0;
bundle.getApplicationInfo(bundleName, bundleFlags, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getAllBundleInfodeprecated
NOTE
This API has been supported since API version 7 and deprecated since API version 9. Its substitute is available only to system applications. You are advised to use 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
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';
let bundleFlag: number = 0;
let userId: number = 100;
bundle.getAllBundleInfo(bundleFlag, userId)
.then((data) => {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getAllBundleInfodeprecated
NOTE
This API has been supported since API version 7 and deprecated since API version 9. Its substitute is available only to system applications. You are advised to use 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
import bundle from '@ohos.bundle';
let bundleFlag: number = 0;
bundle.getAllBundleInfo(bundleFlag, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getAllBundleInfodeprecated
NOTE
This API has been supported since API version 7 and deprecated since API version 9. Its substitute is available only to system applications. You are advised to use 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
import bundle from '@ohos.bundle';
let bundleFlag: number = 0;
let userId: number = 100;
bundle.getAllBundleInfo(bundleFlag, userId, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getBundleInfodeprecated
NOTE
This API has been supported since API version 7 and deprecated since API version 9. You are advised to use 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
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';
let bundleName: string = "com.example.myapplication";
let bundleFlags: number = 1;
let options: bundle.BundleOptions = {
"userId": 100
};
bundle.getBundleInfo(bundleName, bundleFlags, options)
.then((data) => {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getBundleInfodeprecated
NOTE
This API has been supported since API version 7 and deprecated since API version 9. You are advised to use 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
import bundle from '@ohos.bundle';
let bundleName: string = "com.example.myapplication";
let bundleFlags: number = 1;
bundle.getBundleInfo(bundleName, bundleFlags, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getBundleInfodeprecated
NOTE
This API has been supported since API version 7 and deprecated since API version 9. You are advised to use 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
import bundle from '@ohos.bundle';
let bundleName: string = "com.example.myapplication";
let bundleFlags: number = 1;
let options: bundle.BundleOptions = {
"userId": 100
};
bundle.getBundleInfo(bundleName, bundleFlags, options, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getAllApplicationInfodeprecated
NOTE
This API has been supported since API version 7 and deprecated since API version 9. Its substitute is available only to system applications. You are advised to use 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
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';
let bundleFlags: number = 8;
let userId: number = 100;
bundle.getAllApplicationInfo(bundleFlags, userId)
.then((data) => {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getAllApplicationInfodeprecated
NOTE
This API has been supported since API version 7 and deprecated since API version 9. Its substitute is available only to system applications. You are advised to use 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
import bundle from '@ohos.bundle';
let bundleFlags: number = bundle.BundleFlag.GET_APPLICATION_INFO_WITH_PERMISSION;
let userId: number = 100;
bundle.getAllApplicationInfo(bundleFlags, userId, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getAllApplicationInfodeprecated
NOTE
This API has been supported since API version 7 and deprecated since API version 9. Its substitute is available only to system applications. You are advised to use 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
import bundle from '@ohos.bundle';
let bundleFlags: number = bundle.BundleFlag.GET_APPLICATION_INFO_WITH_PERMISSION;
bundle.getAllApplicationInfo(bundleFlags, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getBundleArchiveInfodeprecated
NOTE
This API has been supported since API version 7 and deprecated since API version 9. Its substitute is available only to system applications. You are advised to use 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
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';
let hapFilePath: string = "/data/storage/el2/base/test.hap";
let bundleFlags: number = 0;
bundle.getBundleArchiveInfo(hapFilePath, bundleFlags)
.then((data) => {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getBundleArchiveInfodeprecated
NOTE
This API has been supported since API version 7 and deprecated since API version 9. Its substitute is available only to system applications. You are advised to use 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
import bundle from '@ohos.bundle';
let hapFilePath: string = "/data/storage/el2/base/test.hap";
let bundleFlags: number = 0;
bundle.getBundleArchiveInfo(hapFilePath, bundleFlags, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getAbilityInfodeprecated
NOTE
This API has been supported since API version 7 and deprecated since API version 9. Its substitute is available only to system applications. You are advised to use 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
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';
let bundleName: string = "com.example.myapplication";
let abilityName: string = "EntryAbility";
bundle.getAbilityInfo(bundleName, abilityName)
.then((data) => {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getAbilityInfodeprecated
NOTE
This API has been supported since API version 7 and deprecated since API version 9. Its substitute is available only to system applications. You are advised to use 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
import bundle from '@ohos.bundle';
let bundleName: string = "com.example.myapplication";
let abilityName: string = "EntryAbility";
bundle.getAbilityInfo(bundleName, abilityName, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getAbilityLabel8+ deprecated
NOTE
This API has been supported since API version 8 and deprecated since API version 9. Its substitute is available only to system applications. You are advised to use 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
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';
let bundleName: string = "com.example.myapplication";
let abilityName: string = "EntryAbility";
bundle.getAbilityLabel(bundleName, abilityName)
.then((data) => {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getAbilityLabel8+ deprecated
NOTE
This API has been supported since API version 8 and deprecated since API version 9. Its substitute is available only to system applications. You are advised to use 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
import bundle from '@ohos.bundle';
let bundleName: string = "com.example.myapplication";
let abilityName: string = "EntryAbility";
bundle.getAbilityLabel(bundleName, abilityName, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.isAbilityEnabled8+ deprecated
NOTE
This API has been supported since API version 8 and deprecated since API version 9. Its substitute is available only to system applications. You are advised to use 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. true if enabled, false otherwise. |
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.isAbilityEnabled8+ deprecated
NOTE
This API has been supported since API version 8 and deprecated since API version 9. Its substitute is available only to system applications. You are advised to use 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. true if enabled, false otherwise. |
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.isApplicationEnabled8+ deprecated
NOTE
This API has been supported since API version 8 and deprecated since API version 9. Its substitute is available only to system applications. You are advised to use 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. true if enabled, false otherwise. |
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.isApplicationEnabled8+ deprecated
NOTE
This API has been supported since API version 8 and deprecated since API version 9. Its substitute is available only to system applications. You are advised to use 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. true if enabled, false otherwise. |
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.queryAbilityByWantdeprecated
NOTE
This API has been supported since API version 7 and deprecated since API version 9. Its substitute is available only to system applications. You are advised to use 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
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';
import Want from '@ohos.app.ability.Want';
let bundleFlags: number = 0;
let userId: number = 100;
let want: Want = {
bundleName: "com.example.myapplication",
abilityName: "EntryAbility"
};
bundle.queryAbilityByWant(want, bundleFlags, userId)
.then((data) => {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.queryAbilityByWantdeprecated
NOTE
This API has been supported since API version 7 and deprecated since API version 9. Its substitute is available only to system applications. You are advised to use 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
import bundle from '@ohos.bundle';
import Want from '@ohos.app.ability.Want';
let bundleFlags: number = 0;
let userId: number = 100;
let want: Want = {
bundleName: "com.example.myapplication",
abilityName: "EntryAbility"
};
bundle.queryAbilityByWant(want, bundleFlags, userId, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.queryAbilityByWantdeprecated
NOTE
This API has been supported since API version 7 and deprecated since API version 9. Its substitute is available only to system applications. You are advised to use 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
import bundle from '@ohos.bundle';
import Want from '@ohos.app.ability.Want';
let bundleFlags: number = 0;
let want: Want = {
bundleName: "com.example.myapplication",
abilityName: "EntryAbility"
};
bundle.queryAbilityByWant(want, bundleFlags, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getLaunchWantForBundledeprecated
NOTE
This API has been supported since API version 7 and deprecated since API version 9. Its substitute is available only to system applications. You are advised to use 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
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';
let bundleName: string = "com.example.myapplication";
bundle.getLaunchWantForBundle(bundleName)
.then((data) => {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getLaunchWantForBundledeprecated
NOTE
This API has been supported since API version 7 and deprecated since API version 9. Its substitute is available only to system applications. You are advised to use 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
import bundle from '@ohos.bundle';
let bundleName: string = "com.example.myapplication";
bundle.getLaunchWantForBundle(bundleName, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getNameForUid8+ deprecated
NOTE
This API has been supported since API version 8 and deprecated since API version 9. You are advised to use 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
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';
let uid: number = 20010005;
bundle.getNameForUid(uid)
.then((data) => {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.8+ deprecated
NOTE
This API has been supported since API version 8 and deprecated since API version 9. You are advised to use 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
import bundle from '@ohos.bundle';
let uid: number = 20010005;
bundle.getNameForUid(uid, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getAbilityIcon8+ deprecated
NOTE
This API has been supported since API version 8 and deprecated since API version 9. You are advised to use resourceManager.getMediaContent instead.
getAbilityIcon(bundleName: string, abilityName: string): Promise<image.PixelMap>
Obtains the PixelMap 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 PixelMap. |
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.getAbilityIcon8+ deprecated
NOTE
This API has been supported since API version 8 and 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 PixelMap 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 PixelMap. |
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));
})
InstallErrorCodedeprecated
NOTE
This API has been supported since API version 7 and deprecated since API version 9. You are advised to use errorcode-bundle instead.
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
NOTE
This API has been supported since API version 7 and 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
NOTE
This API has been supported since API version 7 and deprecated since API version 9. No substitute is provided.
Options that contain the user ID.
System capability: SystemCapability.BundleManager.BundleFramework
| Name | Type | Read-Only | Optional | Description |
|---|---|---|---|---|
| userId | number | No | Yes | User ID. The default value is the user ID of the caller. The value must be greater than or equal to 0. |
AbilityTypedeprecated
NOTE
This API has been supported since API version 7 and 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
NOTE
This API has been supported since API version 7 and 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
NOTE
This API has been supported since API version 7 and 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
NOTE
This API has been supported since API version 7 and deprecated since API version 9. No substitute is provided.
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
NOTE
This API has been supported since API version 7 and deprecated since API version 9. No substitute is provided.
Enumerates the color modes of applications and widgets.
System capability: SystemCapability.BundleManager.BundleFramework
| Name | Value | Description |
|---|---|---|
| AUTO_MODE | -1 | Auto mode. |
| DARK_MODE | 0 | Dark mode. |
| LIGHT_MODE | 1 | Light mode. |
GrantStatusdeprecated
NOTE
This API has been supported since API version 7 and 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. |