@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. The APIs of this module are 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.CHANGE_ABILITY_ENABLED_STATE | system_basic | Permission to enable or disable an application or ability. |
| ohos.permission.GET_BUNDLE_INFO | normal | Permission to query information about a specified bundle. |
| ohos.permission.GET_BUNDLE_INFO_PRIVILEGED | system_basic | Permission to query information about all bundles. |
| ohos.permission.INSTALL_BUNDLE | system_core | Permission to install or uninstall bundles. |
| ohos.permission.REMOVE_CACHE_FILES | system_basic | Permission to clear cache files of a bundle. |
For details, see Permission levels.
bundle.getApplicationInfodeprecated
This API is deprecated since API version 9.
getApplicationInfo(bundleName: string, bundleFlags: number, userId?: number): Promise<ApplicationInfo>
Obtains the application information based on a given bundle name. This API uses a promise to return the result.
No permission is required for obtaining the caller's own information.
Required permissions
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| bundleName | string | Yes | Bundle name. |
| bundleFlags | number | Yes | Type of information that will be returned. For details about the available enumerated values, see the application information flags in BundleFlag. |
| userId | number | No | User ID. The default value is the user ID of the caller. The value must be greater than or equal to 0. |
Return value
| Type | Description |
|---|---|
| Promise<ApplicationInfo> | Promise used to return the application information. |
Example
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';
let bundleName: string = "com.example.myapplication";
let bundleFlags: number = 0;
let userId: number = 100;
bundle.getApplicationInfo(bundleName, bundleFlags, userId)
.then((data) => {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getApplicationInfodeprecated
This API is deprecated since API version 9.
getApplicationInfo(bundleName: string, bundleFlags: number, userId: number, callback: AsyncCallback<ApplicationInfo>): void
Obtains the application information of the specified user based on a given bundle name. This API uses an asynchronous callback to return the result.
No permission is required for obtaining the caller's own information.
Required permissions
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| bundleName | string | Yes | Bundle name. |
| bundleFlags | number | Yes | Type of information that will be returned. For details about the available enumerated values, see the application information flags in BundleFlag. |
| userId | number | Yes | User ID. The value must be greater than or equal to 0. |
| callback | AsyncCallback<ApplicationInfo> | Yes | Callback used to return the application information. |
Example
import bundle from '@ohos.bundle';
let bundleName: string = "com.example.myapplication";
let bundleFlags: number = 0;
let userId: number = 100;
bundle.getApplicationInfo(bundleName, bundleFlags, userId, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getApplicationInfodeprecated
This API is deprecated since API version 9.
getApplicationInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback<ApplicationInfo>): void
Obtains the application information based on a given bundle name. This API uses an asynchronous callback to return the result.
No permission is required for obtaining the caller's own information.
Required permissions
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| bundleName | string | Yes | Bundle name. |
| bundleFlags | number | Yes | Type of information that will be returned. For details about the available enumerated values, see the application information flags in BundleFlag. |
| callback | AsyncCallback<ApplicationInfo> | Yes | Callback used to return the application information. |
Example
import bundle from '@ohos.bundle';
let bundleName: string = "com.example.myapplication";
let bundleFlags: number = 0;
bundle.getApplicationInfo(bundleName, bundleFlags, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getAllBundleInfodeprecated
This API is deprecated since API version 9.
getAllBundleInfo(bundleFlag: BundleFlag, userId?: number): Promise<Array<BundleInfo>>
Obtains the information of all bundles of the specified user. This API uses a promise to return the result.
Required permissions
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| bundleFlag | BundleFlag | Yes | Type of information that will be returned. For details about the available enumerated values, see the bundle information flags in BundleFlag. |
| userId | number | No | User ID. The default value is the user ID of the caller. The value must be greater than or equal to 0. |
Return value
| Type | Description |
|---|---|
| Promise<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
This API is deprecated since API version 9.
getAllBundleInfo(bundleFlag: BundleFlag, callback: AsyncCallback<Array<BundleInfo>>): void
Obtains the information of all bundles of the current user. This API uses an asynchronous callback to return the result.
Required permissions
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| bundleFlag | BundleFlag | Yes | Type of information that will be returned. For details about the available enumerated values, see the bundle information flags in BundleFlag. |
| callback | AsyncCallback<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
This API is deprecated since API version 9.
getAllBundleInfo(bundleFlag: BundleFlag, userId: number, callback: AsyncCallback<Array<BundleInfo>>): void
Obtains the information of all bundles of the specified user. This API uses an asynchronous callback to return the result.
Required permissions
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| bundleFlag | BundleFlag | Yes | Type of information that will be returned. For details about the available enumerated values, see the bundle information flags in BundleFlag. |
| userId | number | Yes | User ID. The default value is the user ID of the caller. The value must be greater than or equal to 0. |
| callback | AsyncCallback<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
This API is deprecated since API version 9.
getBundleInfo(bundleName: string, bundleFlags: number, options?: BundleOptions): Promise<BundleInfo>
Obtains the bundle information based on a given bundle name. This API uses a promise to return the result.
No permission is required for obtaining the caller's own information.
Required permissions
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| bundleName | string | Yes | Bundle name. |
| bundleFlags | number | Yes | Type of information that will be returned. For details about the available enumerated values, see the bundle information flags in BundleFlag. |
| options | BundleOptions | No | Options that contain the user ID. |
Return value
| Type | Description |
|---|---|
| Promise<BundleInfo> | Promise used to return the bundle information. |
Example
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';
let bundleName: string = "com.example.myapplication";
let bundleFlags: number = 1;
let options: bundle.BundleOptions = {
"userId": 100
};
bundle.getBundleInfo(bundleName, bundleFlags, options)
.then((data) => {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getBundleInfodeprecated
This API is deprecated since API version 9.
getBundleInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback<BundleInfo>): void
Obtains the bundle information based on a given bundle name. This API uses an asynchronous callback to return the result.
No permission is required for obtaining the caller's own information.
Required permissions
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| bundleName | string | Yes | Bundle name. |
| bundleFlags | number | Yes | Type of information that will be returned. For details about the available enumerated values, see the bundle information flags in BundleFlag. |
| callback | AsyncCallback<BundleInfo> | Yes | Callback used to return the bundle information. |
Example
import bundle from '@ohos.bundle';
let bundleName: string = "com.example.myapplication";
let bundleFlags: number = 1;
bundle.getBundleInfo(bundleName, bundleFlags, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getBundleInfodeprecated
This API is deprecated since API version 9.
getBundleInfo(bundleName: string, bundleFlags: number, options: BundleOptions, callback: AsyncCallback<BundleInfo>): void
Obtains the bundle information based on a given bundle name and bundle options. This API uses an asynchronous callback to return the result.
No permission is required for obtaining the caller's own information.
Required permissions
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| bundleName | string | Yes | Bundle name. |
| bundleFlags | number | Yes | Type of information that will be returned. For details about the available enumerated values, see the bundle information flags in BundleFlag. |
| options | BundleOptions | Yes | Includes userId. |
| callback | AsyncCallback<BundleInfo> | Yes | Callback used to return the bundle information. |
Example
import bundle from '@ohos.bundle';
let bundleName: string = "com.example.myapplication";
let bundleFlags: number = 1;
let options: bundle.BundleOptions = {
"userId": 100
};
bundle.getBundleInfo(bundleName, bundleFlags, options, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.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.
Return value
| Type | Description |
|---|---|
| Promise<BundleInstaller> | Promise used to return the installation package. |
Example
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';
bundle.getBundleInstaller().then((data) => {
console.info('getBundleInstaller successfully.');
}).catch((error: BusinessError) => {
console.error('getBundleInstaller failed.');
});
bundle.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.
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| callback | AsyncCallback<BundleInstaller> | Yes | Callback used to return the installation package. |
Example
import bundle from '@ohos.bundle';
bundle.getBundleInstaller((err, data) => {
if (err.code == 0) {
console.error('getBundleInstaller failed.');
} else {
console.info('getBundleInstaller successfully');
}
});
bundle.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.
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| bundleName | string | Yes | Bundle name. |
| callback | AsyncCallback<void> | Yes | Callback used to return the result. |
Example
import bundle from '@ohos.bundle';
let bundleName: string = "com.example.myapplication";
bundle.cleanBundleCacheFiles(bundleName, err => {
if (err) {
console.error('cleanBundleCacheFiles failed.');
} else {
console.info('cleanBundleCacheFiles successfully.');
}
});
bundle.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.
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| bundleName | string | Yes | Bundle name. |
Return value
| Type | Description |
|---|---|
| Promise<void> | Promise that returns no value. |
Example
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';
let bundleName: string = "com.example.myapplication";
bundle.cleanBundleCacheFiles(bundleName).then(()=> {
console.info('cleanBundleCacheFiles successfully.');
}).catch((error: BusinessError) => {
console.error('cleanBundleCacheFiles failed.');
});
bundle.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.
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| bundleName | string | Yes | Bundle name. |
| isEnable | boolean | Yes | Whether to enable the application. The value true means to enable the application, and false means the opposite. |
| callback | AsyncCallback<void> | Yes | Callback used to return the result. |
Example
import bundle from '@ohos.bundle';
let bundleName: string = "com.example.myapplication";
bundle.setApplicationEnabled(bundleName, false, err => {
if (err) {
console.error('setApplicationEnabled failed.');
} else {
console.info('setApplicationEnabled successfully.');
}
});
bundle.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.
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| bundleName | string | Yes | Bundle name. |
| isEnable | boolean | Yes | Whether to enable the application. The value true means to enable the application, and false means the opposite. |
Return value
| Type | Description |
|---|---|
| Promise<void> | Promise that returns no value. |
Example
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';
let bundleName: string = "com.example.myapplication";
bundle.setApplicationEnabled(bundleName, false).then(()=> {
console.info('setApplicationEnabled successfully.');
}).catch((error: BusinessError) => {
console.error('setApplicationEnabled failed.');
});
bundle.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.
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.
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| info | AbilityInfo | Yes | Ability information. |
| isEnable | boolean | Yes | Whether to enable the application. The value true means to enable the application, and false means the opposite. |
Return value
| Type | Description |
|---|---|
| Promise<void> | Promise that returns no value. |
Example
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';
let bundleName: string = "com.example.myapplication";
let abilityName: string = "EntryAbility";
bundle.getAbilityInfo(bundleName, abilityName).then((abilityInfo) => {
console.info('getAbilityInfo successfully. Data: ' + JSON.stringify(abilityInfo));
bundle.setAbilityEnabled(abilityInfo, false).then(data => {
console.info('setAbilityEnabled successfully.');
}).catch((error: BusinessError) => {
console.error('setAbilityEnabled failed:' + JSON.stringify(error));
})
}).catch((error: BusinessError) => {
console.error('getAbilityInfo failed. Cause: ' + JSON.stringify(error));
});
bundle.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.
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| permissionName | string | Yes | Name of the permission. |
| callback | AsyncCallback<PermissionDef> | Yes | Callback used to return the permission details. |
Example
import bundle from '@ohos.bundle';
let permission: string = "ohos.permission.GET_BUNDLE_INFO";
bundle.getPermissionDef(permission, (err, data) => {
if (err) {
console.error('getPermissionDef failed:' + err.message);
} else {
console.info('getPermissionDef successfully:' + JSON.stringify(data));
}
});
bundle.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.
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| permissionName | string | Yes | Name of the permission. |
Return value
| Type | Description |
|---|---|
| Promise<PermissionDef> | Promise used to return the permission details. |
Example
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';
let permissionName: string = "ohos.permission.GET_BUNDLE_INFO";
bundle.getPermissionDef(permissionName).then((data) => {
console.info('getPermissionDef successfully. Data: ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
console.error('getPermissionDef failed. Cause: ' + error.message);
});
bundle.getAllApplicationInfodeprecated
This API is deprecated since API version 9.
getAllApplicationInfo(bundleFlags: number, userId?: number): Promise<Array<ApplicationInfo>>
Obtains the information about all applications of the specified user. This API uses a promise to return the result.
Required permissions
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| bundleFlags | number | Yes | Type of information that will be returned. For details about the available enumerated values, see the application information flags in BundleFlag. |
| userId | number | No | User ID. The default value is the user ID of the caller. The value must be greater than or equal to 0. |
Return value
| Type | Description |
|---|---|
| Promise<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
This API is deprecated since API version 9.
getAllApplicationInfo(bundleFlags: number, userId: number, callback: AsyncCallback<Array<ApplicationInfo>>): void
Obtains the information about all applications. This API uses an asynchronous callback to return the result.
Required permissions
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| bundleFlags | number | Yes | Type of information that will be returned. For details about the available enumerated values, see the application information flags in BundleFlag. |
| userId | number | Yes | User ID. The default value is the user ID of the caller. The value must be greater than or equal to 0. |
| callback | AsyncCallback<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
This API is deprecated since API version 9.
getAllApplicationInfo(bundleFlags: number, callback: AsyncCallback<Array<ApplicationInfo>>): void
Obtains the information about all applications of the current user. This API uses an asynchronous callback to return the result.
Required permissions
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| bundleFlags | number | Yes | Type of information that will be returned. For details about the available enumerated values, see the application information flags in BundleFlag. |
| callback | AsyncCallback<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
This API is deprecated since API version 9.
getBundleArchiveInfo(hapFilePath: string, bundleFlags: number) : Promise<BundleInfo>
Obtains information about the bundles contained in a HAP file. This API uses a promise to return the result.
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| hapFilePath | string | Yes | Path where the HAP file is stored. The absolute path of the application and the data directory sandbox path are supported. |
| bundleFlags | number | Yes | Flags used to specify information contained in the BundleInfo object that will be returned. For details about the available enumerated values, see the bundle information flags in BundleFlag. |
Return value
| Type | Description |
|---|---|
| Promise<BundleInfo> | Promise used to return the information about the bundles. |
Example
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';
let hapFilePath: string = "/data/storage/el2/base/test.hap";
let bundleFlags: number = 0;
bundle.getBundleArchiveInfo(hapFilePath, bundleFlags)
.then((data) => {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getBundleArchiveInfodeprecated
This API is deprecated since API version 9.
getBundleArchiveInfo(hapFilePath: string, bundleFlags: number, callback: AsyncCallback<BundleInfo>) : void
Obtains information about the bundles contained in a HAP file. This API uses an asynchronous callback to return the result.
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| hapFilePath | string | Yes | Path where the HAP file is stored. The absolute path of the application and the data directory sandbox path are supported. |
| bundleFlags | number | Yes | Flags used to specify information contained in the BundleInfo object that will be returned. For details about the available enumerated values, see the bundle information flags in BundleFlag. |
| callback | AsyncCallback<BundleInfo> | Yes | Callback used to return the information about the bundles. |
Example
import bundle from '@ohos.bundle';
let hapFilePath: string = "/data/storage/el2/base/test.hap";
let bundleFlags: number = 0;
bundle.getBundleArchiveInfo(hapFilePath, bundleFlags, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getAbilityInfodeprecated
This API is deprecated since API version 9.
getAbilityInfo(bundleName: string, abilityName: string): Promise<AbilityInfo>
Obtains the ability information based on a given bundle name and ability name. This API uses a promise to return the result.
No permission is required for obtaining the caller's own information.
Required permissions
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| bundleName | string | Yes | Bundle name. |
| abilityName | string | Yes | Ability name. |
Return value
| Type | Description |
|---|---|
| Promise<AbilityInfo> | Promise used to return the ability information. |
Example
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';
let bundleName: string = "com.example.myapplication";
let abilityName: string = "EntryAbility";
bundle.getAbilityInfo(bundleName, abilityName)
.then((data) => {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getAbilityInfodeprecated
This API is deprecated since API version 9.
getAbilityInfo(bundleName: string, abilityName: string, callback: AsyncCallback<AbilityInfo>): void
Obtains the ability information based on a given bundle name and ability name. This API uses an asynchronous callback to return the result.
No permission is required for obtaining the caller's own information.
Required permissions
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| bundleName | string | Yes | Bundle name. |
| abilityName | string | Yes | Ability name. |
| callback | AsyncCallback<AbilityInfo> | Yes | Callback used to return the ability information. |
Example
import bundle from '@ohos.bundle';
let bundleName: string = "com.example.myapplication";
let abilityName: string = "EntryAbility";
bundle.getAbilityInfo(bundleName, abilityName, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getAbilityLabel8+ deprecated
This API is deprecated since API version 9.
getAbilityLabel(bundleName: string, abilityName: string): Promise<string>
Obtains the application name based on a given bundle name and ability name. This API uses a promise to return the result.
No permission is required for obtaining the caller's own information.
Required permissions
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| bundleName | string | Yes | Bundle name. |
| abilityName | string | Yes | Ability name. |
Return value
| Type | Description |
|---|---|
| Promise<string> | Promise used to return the application name. |
Example
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';
let bundleName: string = "com.example.myapplication";
let abilityName: string = "EntryAbility";
bundle.getAbilityLabel(bundleName, abilityName)
.then((data) => {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getAbilityLabel8+ deprecated
This API is deprecated since API version 9.
getAbilityLabel(bundleName: string, abilityName: string, callback : AsyncCallback<string>): void
Obtains the application name based on a given bundle name and ability name. This API uses an asynchronous callback to return the result.
No permission is required for obtaining the caller's own information.
Required permissions
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| bundleName | string | Yes | Bundle name. |
| abilityName | string | Yes | Ability name. |
| callback | AsyncCallback<string> | Yes | Callback used to return the application name. |
Example
import bundle from '@ohos.bundle';
let bundleName: string = "com.example.myapplication";
let abilityName: string = "EntryAbility";
bundle.getAbilityLabel(bundleName, abilityName, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.isAbilityEnabled8+ deprecated
This API is deprecated since API version 9.
isAbilityEnabled(info: AbilityInfo): Promise<boolean>
Checks whether the ability that matches a given AbilityInfo object is enabled. This API uses a promise to return the result.
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| info | AbilityInfo | Yes | Ability information. |
Return value
| Type | Description |
|---|---|
| Promise<boolean> | Promise used to return the result. If the ability is enabled, true will be returned; otherwise, false will be returned. |
Example
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';
let bundleName: string = "com.example.myapplication";
let abilityName: string = "EntryAbility";
bundle.getAbilityInfo(bundleName, abilityName).then((abilityInfo)=>{
bundle.isAbilityEnabled(abilityInfo).then((data) => {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
})
bundle.isAbilityEnabled8+ deprecated
This API is deprecated since API version 9.
isAbilityEnabled(info : AbilityInfo, callback : AsyncCallback<boolean>): void
Checks whether the ability that matches a given AbilityInfo object is enabled. This API uses an asynchronous callback to return the result.
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| info | AbilityInfo | Yes | Ability information. |
| callback | AsyncCallback<boolean> | Yes | Callback used to return the result. If the ability is enabled, true will be returned; otherwise, false will be returned. |
Example
import bundle from '@ohos.bundle';
let bundleName: string = "com.example.myapplication";
let abilityName: string = "EntryAbility";
bundle.getAbilityInfo(bundleName, abilityName).then((abilityInfo)=>{
bundle.isAbilityEnabled(abilityInfo, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
})
bundle.isApplicationEnabled8+ deprecated
This API is deprecated since API version 9.
isApplicationEnabled(bundleName: string): Promise<boolean>
Checks whether an application is enabled based on a given bundle name. This API uses a promise to return the result.
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| bundleName | string | Yes | Bundle name. |
Return value
| Type | Description |
|---|---|
| Promise<boolean> | Promise used to return the result. If the application is enabled, true will be returned; otherwise, false will be returned. |
Example
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';
let bundleName: string = "com.example.myapplication";
bundle.isApplicationEnabled(bundleName)
.then((data) => {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.isApplicationEnabled8+ deprecated
This API is deprecated since API version 9.
isApplicationEnabled(bundleName: string, callback : AsyncCallback<boolean>): void
Checks whether an application is enabled based on a given bundle name. This API uses an asynchronous callback to return the result.
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| bundleName | string | Yes | Bundle name. |
| callback | AsyncCallback<boolean> | Yes | Callback used to return the result. If the application is enabled, true will be returned; otherwise, false will be returned. |
Example
import bundle from '@ohos.bundle';
let bundleName: string = "com.example.myapplication";
bundle.isApplicationEnabled(bundleName, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.queryAbilityByWantdeprecated
This API is deprecated since API version 9.
queryAbilityByWant(want: Want, bundleFlags: number, userId?: number): Promise<Array<AbilityInfo>>
Obtains the ability information based on given Want. This API uses a promise to return the result.
No permission is required for obtaining the caller's own information.
Required permissions
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| want | Want | Yes | Want containing the bundle name. |
| bundleFlags | number | Yes | Ability information to be returned. For details about the available enumerated values, see the ability information flags in BundleFlag. |
| userId | number | No | User ID. The default value is the user ID of the caller. The value must be greater than or equal to 0. |
Return value
| Type | Description |
|---|---|
| Promise<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
This API is deprecated since API version 9.
queryAbilityByWant(want: Want, bundleFlags: number, userId: number, callback: AsyncCallback<Array<AbilityInfo>>): void
Obtains the ability information of the specified user based on given Want. This API uses an asynchronous callback to return the result.
No permission is required for obtaining the caller's own information.
Required permissions
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| want | Want | Yes | Want containing the bundle name. |
| bundleFlags | number | Yes | Ability information to be returned. For details about the available enumerated values, see the ability information flags in BundleFlag. |
| userId | number | Yes | User ID. The value must be greater than or equal to 0. |
| callback | AsyncCallback<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
This API is deprecated since API version 9.
queryAbilityByWant(want: Want, bundleFlags: number, callback: AsyncCallback<Array<AbilityInfo>>): void
Obtains the ability information based on given Want. This API uses an asynchronous callback to return the result.
No permission is required for obtaining the caller's own information.
Required permissions
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| want | Want | Yes | Want containing the bundle name. |
| bundleFlags | number | Yes | Ability information to be returned. For details about the available enumerated values, see the ability information flags in BundleFlag. |
| callback | AsyncCallback<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
This API is deprecated since API version 9.
getLaunchWantForBundle(bundleName: string): Promise<Want>
Obtains the Want object that launches the specified application. This API uses a promise to return the result.
Required permissions
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| bundleName | string | Yes | Bundle name. |
Return value
| Type | Description |
|---|---|
| Promise<Want> | Promise used to return the Want object. |
Example
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';
let bundleName: string = "com.example.myapplication";
bundle.getLaunchWantForBundle(bundleName)
.then((data) => {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getLaunchWantForBundledeprecated
This API is deprecated since API version 9.
getLaunchWantForBundle(bundleName: string, callback: AsyncCallback<Want>): void
Obtains the Want object that launches the specified application. This API uses an asynchronous callback to return the result.
Required permissions
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| bundleName | string | Yes | Bundle name. |
| callback | AsyncCallback<Want> | Yes | Callback used to return the Want object. |
Example
import bundle from '@ohos.bundle';
let bundleName: string = "com.example.myapplication";
bundle.getLaunchWantForBundle(bundleName, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.getNameForUid8+ deprecated
This API is deprecated since API version 9.
getNameForUid(uid: number): Promise<string>
Obtains the bundle name based on a UID. This API uses a promise to return the result.
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| uid | number | Yes | UID based on which the bundle name is to obtain. |
Return value
| Type | Description |
|---|---|
| Promise<string> | Promise used to return the bundle name. |
Example
import bundle from '@ohos.bundle';
import { BusinessError } from '@ohos.base';
let uid: number = 20010005;
bundle.getNameForUid(uid)
.then((data) => {
console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
bundle.getNameForUid8+ deprecated
This API is deprecated since API version 9.
getNameForUid(uid: number, callback: AsyncCallback<string>) : void
Obtains the bundle name based on a UID. This API uses an asynchronous callback to return the result.
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| uid | number | Yes | UID based on which the bundle name is to obtain. |
| callback | AsyncCallback<string> | Yes | Callback used to return the bundle name. |
Example
import bundle from '@ohos.bundle';
let uid: number = 20010005;
bundle.getNameForUid(uid, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
bundle.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
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
This API is deprecated since API version 9. You are advised to use resourceManager.getMediaContent instead.
getAbilityIcon(bundleName: string, abilityName: string, callback: AsyncCallback<image.PixelMap>): void
Obtains the pixel map of the icon corresponding to a given bundle name and ability name. This API uses an asynchronous callback to return the result.
No permission is required for obtaining the caller's own information.
Required permissions
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO
System capability
SystemCapability.BundleManager.BundleFramework
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| bundleName | string | Yes | Bundle name. |
| abilityName | string | Yes | Ability name. |
| callback | AsyncCallback<image.PixelMap> | Yes | Callback used to return the pixel map. |
Example
import bundle from '@ohos.bundle';
let bundleName: string = "com.example.myapplication";
let abilityName: string = "EntryAbility";
bundle.getAbilityIcon(bundleName, abilityName, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
return;
}
console.info('Operation successful. Data:' + JSON.stringify(data));
})
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. |