diff --git a/en/application-dev/reference/apis/js-apis-Bundle-InnerBundleManager.md b/en/application-dev/reference/apis/js-apis-Bundle-InnerBundleManager.md
index 9d023410fff66869318fca78d3cae361ff71217b..40725aefbf65838c8da46d75a13368c68118df0d 100644
--- a/en/application-dev/reference/apis/js-apis-Bundle-InnerBundleManager.md
+++ b/en/application-dev/reference/apis/js-apis-Bundle-InnerBundleManager.md
@@ -1,8 +1,8 @@
-# innerBundleManager(deprecated)
+# @ohos.bundle.innerBundleManager
The **innerBundleManager** module provides APIs for the **Home Screen** application.
->
+>
> The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version.
> This module is deprecated since API version 9. You are advised to use [launcherBundleManager](js-apis-launcherBundleManager.md) and [bundleMonitor](js-apis-bundleMonitor.md) instead.
@@ -41,7 +41,7 @@ This is a system API and cannot be called by third-party applications.
| Name | Type | Mandatory| Description |
| ---------- | ------------------------------------------------------------ | ---- | ----------------------------------------------------- |
| bundleName | string | Yes | Bundle name of an application. |
-| 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.|
+| userId | number | Yes | User ID. The value must be greater than or equal to 0.|
| callback | AsyncCallback\> | Yes | Callback used to return an array of the launcher ability information. |
@@ -69,7 +69,7 @@ This is a system API and cannot be called by third-party applications.
| Name | Type | Mandatory| Description |
| ---------- | ------ | ---- | ----------------------------------------------------- |
| bundleName | string | Yes | Bundle name of an application. |
-| 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.|
+| userId | number | Yes | User ID. The value must be greater than or equal to 0.|
**Return value**
@@ -216,7 +216,7 @@ This is a system API and cannot be called by third-party applications.
| Name | Type | Mandatory| Description |
| -------- | ------------------------------------------------------------ | ---- | ----------------------------------------------------- |
-| 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.|
+| userId | number | Yes | User ID. The value must be greater than or equal to 0.|
| callback | AsyncCallback\> | Yes | Callback used to return an array of the launcher ability information. |
## innerBundleManager.getAllLauncherAbilityInfos(deprecated)
@@ -242,7 +242,7 @@ This is a system API and cannot be called by third-party applications.
| Name| Type | Mandatory| Description |
| ------ | ------ | ---- | ----------------------------------------------------- |
-| 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.|
+| userId | number | Yes | User ID. The value must be greater than or equal to 0.|
**Return value**
diff --git a/en/application-dev/reference/apis/js-apis-Bundle.md b/en/application-dev/reference/apis/js-apis-Bundle.md
index 52a10b74d2346bc15d2fc17ce196b190bfbfa521..83cf9c77d2899e1c0c0969be8199c602e4374816 100644
--- a/en/application-dev/reference/apis/js-apis-Bundle.md
+++ b/en/application-dev/reference/apis/js-apis-Bundle.md
@@ -1,24 +1,24 @@
-# Bundle
+# @ohos.bundle
-The **Bundle** module provides APIs for querying the information about bundles, applications, abilities, Extension abilities, and application states.
+The **bundle** module provides APIs for obtaining information about an application, including [bundle information](js-apis-bundle-BundleInfo.md), [application information](js-apis-bundle-ApplicationInfo.md), and [ability information](js-apis-bundle-AbilityInfo.md). It also provides APIs to obtain and set the application disabling state.
> **NOTE**
>
> The initial APIs of this module are supported since API version 7. Newly added APIs will be marked with a superscript to indicate their earliest API version.
## Modules to Import
-```js
+```ts
import bundle from '@ohos.bundle';
```
## Required Permissions
-| Required Permissions | Permission Level | Description |
-| ------------------------------------------ | ------------ | ------------------ |
-| ohos.permission.GET_BUNDLE_INFO | normal | Permission to query information about a specified application. |
-| ohos.permission.GET_BUNDLE_INFO_PRIVILEGED| system_basic | Permission to query information about all applications.|
-| ohos.permission.INSTALL_BUNDLE | system_core | Permission to install or uninstall applications. |
-| ohos.permission.MANAGE_DISPOSED_APP_STATUS | system_core | Permission to set and query the application disposal status. |
+| Required Permissions | Permission Level | Description |
+|--------------------------------------------|--------------|---------------|
+| ohos.permission.GET_BUNDLE_INFO | normal | Permission to query information about a specified bundle. |
+| ohos.permission.GET_BUNDLE_INFO_PRIVILEGED| system_basic | Permission to query information about all bundles. |
+| ohos.permission.INSTALL_BUNDLE | system_core | Permission to install or uninstall bundles. |
+| ohos.permission.MANAGE_DISPOSED_APP_STATUS | system_core | Permission to set and query the application disposal status.|
For details, see [Permission Levels](../../security/accesstoken-overview.md#permission-levels).
@@ -30,6 +30,8 @@ getApplicationInfo(bundleName: string, bundleFlags: number, userId?: number): Pr
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
@@ -42,8 +44,8 @@ SystemCapability.BundleManager.BundleFramework
| Name | Type | Mandatory| Description |
| ----------- | ------ | ---- | ------------------------------------------------------------ |
-| bundleName | string | Yes | Bundle name of an application. |
-| bundleFlags | number | Yes | Type of information that will be returned. The default value is **0**. For details on the available enumerated values, see the application information flags in [BundleFlag](#bundleflag).|
+| bundleName | string | Yes | Bundle name of the application. |
+| bundleFlags | number | Yes | Type of information that will be returned. For details about the available enumerated values, see the application information flags in [BundleFlag](#bundleflagdeprecated).|
| 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**
@@ -54,7 +56,7 @@ SystemCapability.BundleManager.BundleFramework
**Example**
-```js
+```ts
let bundleName = "com.example.myapplication";
let bundleFlags = 0;
let userId = 100;
@@ -74,6 +76,8 @@ getApplicationInfo(bundleName: string, bundleFlags: number, userId: number, call
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
@@ -86,14 +90,14 @@ SystemCapability.BundleManager.BundleFramework
| Name | Type | Mandatory| Description |
| ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
-| bundleName | string | Yes | Bundle name of an application. |
-| bundleFlags | number | Yes | Type of information that will be returned. The default value is **0**. For details on the available enumerated values, see the application information flags in [BundleFlag](#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. |
+| bundleName | string | Yes | Bundle name of the application. |
+| bundleFlags | number | Yes | Type of information that will be returned. For details about the available enumerated values, see the application information flags in [BundleFlag](#bundleflag).|
+| userId | number | Yes | User ID. The value must be greater than or equal to 0. |
| callback | AsyncCallback\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)> | Yes | Callback used to return the application information. |
**Example**
-```js
+```ts
let bundleName = "com.example.myapplication";
let bundleFlags = 0;
let userId = 100;
@@ -115,6 +119,8 @@ getApplicationInfo(bundleName: string, bundleFlags: number, callback: AsyncCallb
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
@@ -127,13 +133,13 @@ SystemCapability.BundleManager.BundleFramework
| Name | Type | Mandatory| Description |
| ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
-| bundleName | string | Yes | Bundle name of an application. |
-| bundleFlags | number | Yes | Type of information that will be returned. The default value is **0**. For details on the available enumerated values, see the application information flags in [BundleFlag](#bundleflag).|
+| bundleName | string | Yes | Bundle name of the application. |
+| bundleFlags | number | Yes | Type of information that will be returned. For details about the available enumerated values, see the application information flags in [BundleFlag](#bundleflag).|
| callback | AsyncCallback\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)> | Yes | Callback used to return the application information. |
**Example**
-```js
+```ts
let bundleName = "com.example.myapplication";
let bundleFlags = 0;
bundle.getApplicationInfo(bundleName, bundleFlags, (err, data) => {
@@ -152,7 +158,7 @@ bundle.getApplicationInfo(bundleName, bundleFlags, (err, data) => {
getAllBundleInfo(bundleFlag: BundleFlag, userId?: number): Promise>
-Obtains the information of all available bundles of the specified user in the system. This API uses a promise to return the result.
+Obtains the information of all bundles of the specified user. This API uses a promise to return the result.
**Required permissions**
@@ -166,7 +172,7 @@ SystemCapability.BundleManager.BundleFramework
| Name | Type | Mandatory| Description |
| ---------- | ---------- | ---- | ------------------------------------------------------------ |
-| bundleFlag | BundleFlag | Yes | Type of information that will be returned. The default value is **0**. For details on the available enumerated values, see the bundle information flags in [BundleFlag](#bundleflag).|
+| bundleFlag | BundleFlag | Yes | Type of information that will be returned. For details about the available enumerated values, see the bundle information flags in [BundleFlag](#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**
@@ -177,7 +183,7 @@ SystemCapability.BundleManager.BundleFramework
**Example**
-```js
+```ts
let bundleFlag = 0;
let userId = 100;
bundle.getAllBundleInfo(bundleFlag, userId)
@@ -195,7 +201,7 @@ bundle.getAllBundleInfo(bundleFlag, userId)
getAllBundleInfo(bundleFlag: BundleFlag, callback: AsyncCallback>): void
-Obtains the information of all available bundles in the system. This API uses an asynchronous callback to return the result.
+Obtains the information of all bundles of the current user. This API uses an asynchronous callback to return the result.
**Required permissions**
@@ -209,12 +215,12 @@ SystemCapability.BundleManager.BundleFramework
| Name | Type | Mandatory| Description |
| ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
-| bundleFlag | BundleFlag | Yes | Type of information that will be returned. The default value is **0**. For details on the available enumerated values, see the bundle information flags in [BundleFlag](#bundleflag).|
-| callback | AsyncCallback> | Yes | Callback used to return the information of all available bundles. |
+| bundleFlag | BundleFlag | Yes | Type of information that will be returned. For details about the available enumerated values, see the bundle information flags in [BundleFlag](#bundleflag).|
+| callback | AsyncCallback> | Yes | Callback used to return the information of all bundles. |
**Example**
-```js
+```ts
let bundleFlag = 0;
bundle.getAllBundleInfo(bundleFlag, (err, data) => {
if (err) {
@@ -232,7 +238,7 @@ bundle.getAllBundleInfo(bundleFlag, (err, data) => {
getAllBundleInfo(bundleFlag: BundleFlag, userId: number, callback: AsyncCallback>): void
-Obtains the information of all available bundles of the specified user in the system. This API uses an asynchronous callback to return the result.
+Obtains the information of all bundles of the specified user. This API uses an asynchronous callback to return the result.
**Required permissions**
@@ -244,15 +250,16 @@ SystemCapability.BundleManager.BundleFramework
**Parameters**
-| Name | Type | Mandatory| Description |
-| ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
-| bundleFlag | BundleFlag | Yes | Type of information that will be returned. The default value is **0**. For details on the available enumerated values, see the bundle information flags in [BundleFlag](#bundleflag).|
-| userId | number | Yes | User ID. The default value is the user ID of the caller. The value must be greater than or equal to 0. |
-| callback | AsyncCallback> | Yes | Callback used to return the information of all available bundles. |
+| 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](#bundleflag).|
+| userId | number | Yes | User ID. The default value is the user ID of the caller. The value must be greater than or equal to 0. |
+| callback | AsyncCallback> | Yes | Callback used to return the information of all bundles. |
+|
**Example**
-```js
+```ts
let bundleFlag = 0;
let userId = 100;
bundle.getAllBundleInfo(bundleFlag, userId, (err, data) => {
@@ -273,6 +280,8 @@ getBundleInfo(bundleName: string, bundleFlags: number, options?: BundleOptions):
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
@@ -283,11 +292,11 @@ SystemCapability.BundleManager.BundleFramework
**Parameters**
-| Name | Type | Mandatory | Description |
-| ----------- | ------------- | ---- | --------------------------------------- |
-| bundleName | string | Yes | Bundle name of an application. |
-| bundleFlags | number | Yes | Type of information that will be returned. The default value is **0**. For details on the available enumerated values, see the bundle information flags in [BundleFlag](#bundleflag).|
-| options | [BundleOptions](#bundleoptions) | No | Includes **userId**. |
+| Name | Type | Mandatory | Description |
+| ----------- | ------------- | ---- |---------------------------------------------------------------------|
+| bundleName | string | Yes | Bundle name of the application. |
+| bundleFlags | number | Yes | Type of information that will be returned. For details about the available enumerated values, see the bundle information flags in [BundleFlag](#bundleflag).|
+| options | [BundleOptions](#bundleoptions) | No | Options that contain the user ID. |
**Return value**
@@ -297,7 +306,7 @@ SystemCapability.BundleManager.BundleFramework
**Example**
-```js
+```ts
let bundleName = "com.example.myapplication";
let bundleFlags = 1;
let options = {
@@ -319,6 +328,8 @@ getBundleInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback\<
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
@@ -329,15 +340,15 @@ SystemCapability.BundleManager.BundleFramework
**Parameters**
-| Name | Type | Mandatory| Description |
-| ----------- | ---------------------------------------------------------- | ---- | ------------------------------------------------------------ |
-| bundleName | string | Yes | Bundle name of an application. |
-| bundleFlags | number | Yes | Type of information that will be returned. The default value is **0**. For details on the available enumerated values, see the bundle information flags in [BundleFlag](#bundleflag).|
-| callback | AsyncCallback\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | Yes | Callback used to return the bundle information. |
+| Name | Type | Mandatory| Description |
+| ----------- | ---------------------------------------------------------- | ---- |---------------------------------------------------------------------|
+| bundleName | string | Yes | Bundle name of the application. |
+| bundleFlags | number | Yes | Type of information that will be returned. For details about the available enumerated values, see the bundle information flags in [BundleFlag](#bundleflag).|
+| callback | AsyncCallback\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | Yes | Callback used to return the bundle information. |
**Example**
-```js
+```ts
let bundleName = "com.example.myapplication";
let bundleFlags = 1;
bundle.getBundleInfo(bundleName, bundleFlags, (err, data) => {
@@ -358,6 +369,8 @@ getBundleInfo(bundleName: string, bundleFlags: number, options: BundleOptions, c
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
@@ -370,14 +383,14 @@ SystemCapability.BundleManager.BundleFramework
| Name | Type | Mandatory| Description |
| ----------- | ---------------------------------------------------------- | ---- | ------------------------------------------------------------ |
-| bundleName | string | Yes | Bundle name of an application. |
-| bundleFlags | number | Yes | Type of information that will be returned. The default value is **0**. For details on the available enumerated values, see the bundle information flags in [BundleFlag](#bundleflag).|
+| bundleName | string | Yes | Bundle name of the application. |
+| bundleFlags | number | Yes | Type of information that will be returned. For details about the available enumerated values, see the bundle information flags in [BundleFlag](#bundleflag).|
| options | [BundleOptions](#bundleoptions) | Yes | Includes **userId**. |
| callback | AsyncCallback\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | Yes | Callback used to return the bundle information. |
**Example**
-```js
+```ts
let bundleName = "com.example.myapplication";
let bundleFlags = 1;
let options = {
@@ -400,7 +413,7 @@ bundle.getBundleInfo(bundleName, bundleFlags, options, (err, data) => {
getBundleInstaller(): Promise<BundleInstaller>;
-Obtains the installation package information. This API uses a promise to return the result.
+Obtains the installation package. This API uses a promise to return the result.
**Required permissions**
@@ -418,7 +431,17 @@ This is a system API and cannot be called by third-party applications.
| Type | Description |
| ------------------------------------------------------------ | -------------------------------------------- |
-| Promise<[BundleInstaller](js-apis-bundle-BundleInstaller.md)> | Promise used to return the installation package information.|
+| Promise<[BundleInstaller](js-apis-bundle-BundleInstaller.md)> | Promise used to return the installation package.|
+
+**Example**
+
+```ts
+bundle.getBundleInstaller().then((data) => {
+ console.info('getBundleInstaller successfully.');
+}).catch((error) => {
+ console.error('getBundleInstaller failed.');
+});
+```
## bundle.getBundleInstallerdeprecated
@@ -426,7 +449,7 @@ This is a system API and cannot be called by third-party applications.
getBundleInstaller(callback: AsyncCallback<BundleInstaller>): void;
-Obtains the installation package information. This API uses an asynchronous callback to return the result.
+Obtains the installation package. This API uses an asynchronous callback to return the result.
**Required permissions**
@@ -444,8 +467,19 @@ This is a system API and cannot be called by third-party applications.
| Name | Type | Mandatory| Description |
| -------- | ------------------------------------------------------------ | ---- | ---------------- |
-| callback | AsyncCallback<[BundleInstaller](js-apis-bundle-BundleInstaller.md)> | Yes | Callback used to return the installation package information.|
+| callback | AsyncCallback<[BundleInstaller](js-apis-bundle-BundleInstaller.md)> | Yes | Callback used to return the installation package.|
+
+**Example**
+```ts
+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](js-apis-bundleManager.md#bundlemanagercleanbundlecachefiles) instead.
@@ -470,9 +504,23 @@ This is a system API and cannot be called by third-party applications.
| Name | Type | Mandatory| Description |
| ---------- | ------------------- | ---- | ------------------------------------- |
-| bundleName | string | Yes | Bundle name of an application.|
+| bundleName | string | Yes | Bundle name of the application.|
| callback | AsyncCallback\ | Yes | Callback used to return the result. |
+**Example**
+
+```ts
+let bundleName = "com.example.myapplication";
+
+bundle.cleanBundleCacheFiles(bundleName, err => {
+ if (err) {
+ console.error('cleanBundleCacheFiles failed.');
+ } else {
+ console.info('cleanBundleCacheFiles successfully.');
+ }
+});
+```
+
## bundle.cleanBundleCacheFiles8+ deprecated
> This API is deprecated since API version 9. You are advised to use [bundleManager.cleanBundleCacheFiles](js-apis-bundleManager.md#bundlemanagercleanbundlecachefiles) instead.
@@ -497,7 +545,7 @@ This is a system API and cannot be called by third-party applications.
| Name | Type | Mandatory| Description |
| ---------- | ------ | ---- | ------------------------------------- |
-| bundleName | string | Yes | Bundle name of an application.|
+| bundleName | string | Yes | Bundle name of the application.|
**Return value**
@@ -505,6 +553,18 @@ This is a system API and cannot be called by third-party applications.
| ------------- | ------------------------------------ |
| Promise\ | Promise that returns no value.|
+**Example**
+
+```ts
+let bundleName = "com.example.myapplication";
+
+bundle.cleanBundleCacheFiles(bundleName).then(()=> {
+ console.info('cleanBundleCacheFiles successfully.');
+}).catch(err=> {
+ console.error('cleanBundleCacheFiles failed.');
+});
+```
+
## bundle.setApplicationEnabled8+ deprecated
> This API is deprecated since API version 9. You are advised to use [bundleManager.setApplicationEnabled](js-apis-bundleManager.md#bundlemanagersetapplicationenabled) instead.
@@ -527,11 +587,25 @@ This is a system API and cannot be called by third-party applications.
**Parameters**
-| Name | Type | Mandatory| Description |
-| ---------- | ------------------- | ---- | ----------------------------------------------- |
-| bundleName | string | Yes | Bundle name of an application. |
+| Name | Type | Mandatory| Description |
+| ---------- | ------------------- | ---- |--------------------------------|
+| bundleName | string | Yes | Bundle name of the application. |
| isEnable | boolean | Yes | Whether to enable the application. The value **true** means to enable the application, and **false** means the opposite.|
-| callback | AsyncCallback\ | Yes | Callback used to return the result. |
+| callback | AsyncCallback\ | Yes | Callback used to return the result. |
+
+**Example**
+
+```ts
+let bundleName = "com.example.myapplication";
+
+bundle.setApplicationEnabled(bundleName, false, err => {
+ if (err) {
+ console.error('setApplicationEnabled failed.');
+ } else {
+ console.info('setApplicationEnabled successfully.');
+ }
+});
+```
## bundle.setApplicationEnabled8+ deprecated
@@ -555,9 +629,9 @@ This is a system API and cannot be called by third-party applications.
**Parameters**
-| Name | Type | Mandatory| Description |
-| ---------- | ------- | ---- | ----------------------------------------------- |
-| bundleName | string | Yes | Bundle name of an application. |
+| Name | Type | Mandatory| Description |
+| ---------- | ------- | ---- |------------------------------|
+| bundleName | string | Yes | Bundle name of the application. |
| isEnable | boolean | Yes | Whether to enable the application. The value **true** means to enable the application, and **false** means the opposite.|
**Return value**
@@ -566,6 +640,18 @@ This is a system API and cannot be called by third-party applications.
| ------------- | ------------------------------------ |
| Promise\ | Promise that returns no value.|
+**Example**
+
+```ts
+let bundleName = "com.example.myapplication";
+
+bundleManager.setApplicationEnabled(bundleName, false).then(()=> {
+ console.info('setApplicationEnabled successfully.');
+}).catch(err=> {
+ console.error('setApplicationEnabled failed.');
+});
+```
+
## bundle.setAbilityEnabled8+ deprecated
> This API is deprecated since API version 9. You are advised to use [bundleManager.setAbilityEnabled](js-apis-bundleManager.md#bundlemanagersetabilityenabled) instead.
@@ -627,6 +713,28 @@ This is a system API and cannot be called by third-party applications.
| ------------- | ------------------------------------ |
| Promise\ | Promise that returns no value.|
+**Example**
+
+```ts
+let flag = bundle.BundleFlag.GET_ABILITY_INFO_WITH_PERMISSION;
+let userId = 100;
+let want = {
+ bundleName : "com.example.myapplication",
+ abilityName : "com.example.myapplication.MainAbility"
+};
+
+bundle.getAbilityInfo(want, flag, userId).then((abilityInfo) => {
+ console.info('getAbilityInfo successfully. Data: ' + JSON.stringify(abilityInfo));
+
+ bundle.setAbilityEnabled(abilityInfo, false).then(data => {
+ console.info('setAbilityEnabled successfully.');
+ }).catch(err => {
+ console.error('setAbilityEnabled failed:' + JSON.stringify(err));
+ })
+}).catch(error => {
+ console.error('getAbilityInfo failed. Cause: ' + JSON.stringify(error));
+});
+```
## bundle.getPermissionDef8+ deprecated
> This API is deprecated since API version 9. You are advised to use [bundleManager.getPermissionDef](js-apis-bundleManager.md#bundlemanagergetpermissiondef) instead.
@@ -654,6 +762,19 @@ This is a system API and cannot be called by third-party applications.
| permissionName | string | Yes | Name of the permission. |
| callback | AsyncCallback<[PermissionDef](js-apis-bundle-PermissionDef)> | Yes | Callback used to return the permission details.|
+**Example**
+
+```ts
+let permission = "ohos.permission.GET_BUNDLE_INFO";
+bundleManager.getPermissionDef(permission, (err, data) => {
+ if (err) {
+ console.error('getPermissionDef failed:' + err.message);
+ } else {
+ console.info('getPermissionDef successfully:' + JSON.stringify(data));
+ }
+});
+```
+
## bundle.getPermissionDef8+ deprecated
> This API is deprecated since API version 9. You are advised to use [bundleManager.getPermissionDef](js-apis-bundleManager.md#bundlemanagergetpermissiondef) instead.
@@ -686,6 +807,16 @@ This is a system API and cannot be called by third-party applications.
| ------------------------------------------------------ | ------------------------------------------------------ |
| Promise<[PermissionDef](js-apis-bundle-PermissionDef)> | Promise used to return the permission details.|
+**Example**
+
+```ts
+let permissionName = "ohos.permission.GET_BUNDLE_INFO";
+bundle.getPermissionDef(permissionName).then((data) => {
+ console.info('getPermissionDef successfully. Data: ' + JSON.stringify(data));
+}).catch(error => {
+ console.error('getPermissionDef failed. Cause: ' + error.message);
+});
+```
## bundle.getAllApplicationInfodeprecated
@@ -707,8 +838,8 @@ SystemCapability.BundleManager.BundleFramework
| Name | Type | Mandatory| Description |
| ----------- | ------ | ---- | ------------------------------------------------------------ |
-| bundleFlags | number | Yes | Type of information that will be returned. The default value is **0**. For details on the available enumerated values, see the application information flags in [BundleFlag](#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. |
+| bundleFlags | number | Yes | Type of information that will be returned. For details about the available enumerated values, see the application information flags in [BundleFlag](#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**
@@ -718,7 +849,7 @@ SystemCapability.BundleManager.BundleFramework
**Example**
-```js
+```ts
let bundleFlags = 8;
let userId = 100;
bundle.getAllApplicationInfo(bundleFlags, userId)
@@ -735,7 +866,7 @@ bundle.getAllApplicationInfo(bundleFlags, userId)
getAllApplicationInfo(bundleFlags: number, userId: number, callback: AsyncCallback>): void
-Obtains the information about all applications of the specified user. This API uses an asynchronous callback to return the result.
+Obtains the information about all applications. This API uses an asynchronous callback to return the result.
**Required permissions**
@@ -749,14 +880,14 @@ SystemCapability.BundleManager.BundleFramework
| Name | Type | Mandatory| Description |
| ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
-| bundleFlags | number | Yes | Type of information that will be returned. The default value is **0**. For details on the available enumerated values, see the application information flags in [BundleFlag](#bundleflag).|
+| bundleFlags | number | Yes | Type of information that will be returned. For details about the available enumerated values, see the application information flags in [BundleFlag](#bundleflag).|
| userId | number | Yes | User ID. The default value is the user ID of the caller. The value must be greater than or equal to 0. |
| callback | AsyncCallback> | Yes | Callback used to return the application information. |
**Example**
-```js
-let bundleFlags = 8;
+```ts
+let bundleFlags = bundle.BundleFlag.GET_APPLICATION_INFO_WITH_PERMISSION;
let userId = 100;
bundle.getAllApplicationInfo(bundleFlags, userId, (err, data) => {
if (err) {
@@ -774,7 +905,7 @@ bundle.getAllApplicationInfo(bundleFlags, userId, (err, data) => {
getAllApplicationInfo(bundleFlags: number, callback: AsyncCallback>) : void;
-Obtains the information about all applications. This API uses an asynchronous callback to return the result.
+Obtains the information about all applications of the current user. This API uses an asynchronous callback to return the result.
**Required permissions**
@@ -788,13 +919,13 @@ SystemCapability.BundleManager.BundleFramework
| Name | Type | Mandatory| Description |
| ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
-| bundleFlags | number | Yes | Type of information that will be returned. The default value is **0**. For details on the available enumerated values, see the application information flags in [BundleFlag](#bundleflag).|
+| bundleFlags | number | Yes | Type of information that will be returned. For details about the available enumerated values, see the application information flags in [BundleFlag](#bundleflag).|
| callback | AsyncCallback> | Yes | Callback used to return the application information. |
**Example**
-```js
-let bundleFlags = 8;
+```ts
+let bundleFlags = bundle.BundleFlag.GET_APPLICATION_INFO_WITH_PERMISSION;
bundle.getAllApplicationInfo(bundleFlags, (err, data) => {
if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err));
@@ -820,8 +951,8 @@ SystemCapability.BundleManager.BundleFramework
| Name | Type | Mandatory | Description |
| ---------- | ------ | ---- | ------------ |
-| hapFilePath | string | Yes | Path where the HAP file is stored. The path should point to the relative directory of the current application's data directory.|
-| bundleFlags | number | Yes | Flags used to specify information contained in the **BundleInfo** object that will be returned. The default value is **0**. For details on the available enumerated values, see the bundle information flags in [BundleFlag](#bundleflag).|
+| 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](#bundleflag).|
**Return value**
| Type | Description |
@@ -830,8 +961,8 @@ SystemCapability.BundleManager.BundleFramework
**Example**
-```js
-let hapFilePath = "/data/xxx/test.hap";
+```ts
+let hapFilePath = "/data/storage/el2/base/test.hap";
let bundleFlags = 0;
bundle.getBundleArchiveInfo(hapFilePath, bundleFlags)
.then((data) => {
@@ -857,14 +988,14 @@ SystemCapability.BundleManager.BundleFramework
| Name | Type | Mandatory | Description |
| ---------- | ------ | ---- | ------------ |
-| hapFilePath | string | Yes | Path where the HAP file is stored. The path should point to the relative directory of the current application's data directory.|
-| bundleFlags | number | Yes | Flags used to specify information contained in the **BundleInfo** object that will be returned. The default value is **0**. For details on the available enumerated values, see the bundle information flags in [BundleFlag](#bundleflag).|
+| 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](#bundleflag).|
| callback| AsyncCallback\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | Yes | Callback used to return the information about the bundles.|
**Example**
-```js
-let hapFilePath = "/data/xxx/test.hap";
+```ts
+let hapFilePath = "/data/storage/el2/base/test.hap";
let bundleFlags = 0;
bundle.getBundleArchiveInfo(hapFilePath, bundleFlags, (err, data) => {
if (err) {
@@ -884,6 +1015,8 @@ getAbilityInfo(bundleName: string, abilityName: string): Promise\
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
@@ -894,9 +1027,9 @@ SystemCapability.BundleManager.BundleFramework
**Parameters**
-| Name | Type | Mandatory | Description |
-| ----------- | ------ | ---- | ---------------- |
-| bundleName | string | Yes | Bundle name of an application. |
+| Name | Type | Mandatory | Description |
+| ----------- | ------ | ---- |------------|
+| bundleName | string | Yes | Bundle name of the application. |
| abilityName | string | Yes | Ability name.|
**Return value**
@@ -907,7 +1040,7 @@ SystemCapability.BundleManager.BundleFramework
**Example**
-```js
+```ts
let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityInfo(bundleName, abilityName)
@@ -926,6 +1059,8 @@ getAbilityInfo(bundleName: string, abilityName: string, callback: AsyncCallback\
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
@@ -936,15 +1071,15 @@ SystemCapability.BundleManager.BundleFramework
**Parameters**
-| Name | Type | Mandatory | Description |
-| ----------- | ------------ | ---- | ---------------- |
-| bundleName | string | Yes | Bundle name of an application. |
-| abilityName | string | Yes | Ability name.|
+| Name | Type | Mandatory | Description |
+| ----------- | ------------ | ---- |----------------------------|
+| bundleName | string | Yes | Bundle name of the application. |
+| abilityName | string | Yes | Ability name. |
| callback | AsyncCallback\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)> | Yes | Callback used to return the ability information.|
**Example**
-```js
+```ts
let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityInfo(bundleName, abilityName, (err, data) => {
@@ -964,6 +1099,8 @@ getAbilityLabel(bundleName: string, abilityName: string): Promise\
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
@@ -974,10 +1111,10 @@ SystemCapability.BundleManager.BundleFramework
**Parameters**
-| Name | Type | Mandatory | Description |
-| ----------- | ------ | ---- | ---------------- |
-| bundleName | string | Yes | Bundle name of an application. |
-| abilityName | string | Yes | Ability name.|
+| Name | Type | Mandatory | Description |
+|-------------|--------|-----|------------|
+| bundleName | string | Yes | Bundle name of the application. |
+| abilityName | string | Yes | Ability name.|
**Return value**
@@ -987,7 +1124,7 @@ SystemCapability.BundleManager.BundleFramework
**Example**
-```js
+```ts
let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityLabel(bundleName, abilityName)
@@ -1006,6 +1143,8 @@ getAbilityLabel(bundleName: string, abilityName: string, callback : AsyncCallbac
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
@@ -1016,15 +1155,15 @@ SystemCapability.BundleManager.BundleFramework
**Parameters**
-| Name | Type | Mandatory | Description |
-| ----------- | ---------------------- | ---- | ---------------- |
-| bundleName | string | Yes | Bundle name of an application. |
-| abilityName | string | Yes | Ability name.|
-| callback | AsyncCallback\ | Yes | Callback used to return the application name. |
+| Name | Type | Mandatory | Description |
+|-------------|------------------------|-----|-------------------------|
+| bundleName | string | Yes | Bundle name of the application. |
+| abilityName | string | Yes | Ability name. |
+| callback | AsyncCallback\ | Yes | Callback used to return the application name.|
**Example**
-```js
+```ts
let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityLabel(bundleName, abilityName, (err, data) => {
@@ -1062,7 +1201,7 @@ SystemCapability.BundleManager.BundleFramework
**Example**
-```js
+```ts
let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityInfo(bundleName, abilityName).then((abilityInfo)=>{
@@ -1095,7 +1234,7 @@ SystemCapability.BundleManager.BundleFramework
**Example**
-```js
+```ts
let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityInfo(bundleName, abilityName).then((abilityInfo)=>{
@@ -1125,17 +1264,17 @@ SystemCapability.BundleManager.BundleFramework
| Name | Type | Mandatory| Description |
| ---------- | ------ | ---- | ------------------------ |
-| bundleName | string | Yes | Bundle name of an application.|
+| bundleName | string | Yes | Bundle name of the application.|
**Return value**
| Type | Description |
| ----------------- | ------------------------- |
-| Promise\ | Promise used to return whether the ability is enabled. If the ability is enabled, **true** will be returned; otherwise, **false** will be returned.|
+| Promise\ | Promise used to return whether the application is enabled. If the application is enabled, **true** will be returned; otherwise, **false** will be returned.|
**Example**
-```js
+```ts
let bundleName = "com.example.myapplication";
bundle.isApplicationEnabled(bundleName)
.then((data) => {
@@ -1161,12 +1300,12 @@ SystemCapability.BundleManager.BundleFramework
| Name | Type | Mandatory| Description |
| ---------- | ----------------------- | ---- | ------------------------ |
-| bundleName | string | Yes | Bundle name of an application.|
-| callback | AsyncCallback\ | Yes | Callback used to return whether the ability is enabled. If the ability is enabled, **true** will be returned; otherwise, **false** will be returned. |
+| bundleName | string | Yes | Bundle name of the application.|
+| callback | AsyncCallback\ | Yes | Callback used to return whether the application is enabled. If the application is enabled, **true** will be returned; otherwise, **false** will be returned. |
**Example**
-```js
+```ts
let bundleName = "com.example.myapplication";
bundle.isApplicationEnabled(bundleName, (err, data) => {
if (err) {
@@ -1185,6 +1324,8 @@ queryAbilityByWant(want: Want, bundleFlags: number, userId?: number): Promise> | Yes | Callback used to return the ability information. |
+| Name | Type | Mandatory | Description |
+|-------------|---------------------------------------------------------------------|-----|-------------------------------------------------------------------------|
+| want | [Want](js-apis-application-want.md) | Yes | Want that contains 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](#bundleflag).|
+| userId | number | Yes | User ID. The value must be greater than or equal to 0. |
+| callback | AsyncCallback> | Yes | Callback used to return the ability information. |
**Example**
-```js
+```ts
let bundleFlags = 0;
let userId = 100;
let want = {
@@ -1277,6 +1420,8 @@ queryAbilityByWant(want: Want, bundleFlags: number, callback: AsyncCallback> | Yes | Callback used to return the ability information. |
+| Name | Type | Mandatory | Description |
+|-------------|---------------------------------------------------------------------|-----|-------------------------------------------------------------------------|
+| want | [Want](js-apis-application-want.md) | Yes | Want that contains 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](#bundleflag).|
+| callback | AsyncCallback> | Yes | Callback used to return the ability information. |
**Example**
-```js
+```ts
let bundleFlags = 0;
let want = {
bundleName : "com.example.myapplication",
@@ -1332,16 +1477,16 @@ SystemCapability.BundleManager.BundleFramework
| Name | Type | Mandatory| Description |
| ---------- | ------ | ---- | ------------------------ |
-| bundleName | string | Yes | Bundle name of an application.|
+| bundleName | string | Yes | Bundle name of the application.|
**Return value**
| Type | Description |
| -------------- | -------------------------------------- |
-| Promise\<[Want](js-apis-application-Want.md)> | Promise used to return the **Want** object.|
+| Promise\<[Want](js-apis-application-want.md)> | Promise used to return the **Want** object.|
**Example**
-```js
+```ts
let bundleName = "com.example.myapplication";
bundle.getLaunchWantForBundle(bundleName)
.then((data) => {
@@ -1371,12 +1516,12 @@ SystemCapability.BundleManager.BundleFramework
| Name | Type | Mandatory| Description |
| ---------- | --------------------------------------------------- | ---- | -------------------------------------------------------- |
-| bundleName | string | Yes | Bundle name of an application. |
-| callback | AsyncCallback\<[Want](js-apis-application-Want.md)> | Yes | Callback used to return the **Want** object.|
+| bundleName | string | Yes | Bundle name of the application. |
+| callback | AsyncCallback\<[Want](js-apis-application-want.md)> | Yes | Callback used to return the **Want** object.|
**Example**
-```js
+```ts
let bundleName = "com.example.myapplication";
bundle.getLaunchWantForBundle(bundleName, (err, data) => {
if (err) {
@@ -1413,7 +1558,7 @@ SystemCapability.BundleManager.BundleFramework
**Example**
-```js
+```ts
let uid = 20010005;
bundle.getNameForUid(uid)
.then((data) => {
@@ -1437,14 +1582,14 @@ SystemCapability.BundleManager.BundleFramework
**Parameters**
-| Name | Type | Mandatory| Description |
-| -------- | ---------------------- | ---- | ----------------------------------------------- |
-| uid | number | Yes | UID based on which the bundle name is to obtain. |
+| Name | Type | Mandatory | Description |
+|----------|------------------------|-----|----------------------------|
+| uid | number | Yes | UID based on which the bundle name is to obtain. |
| callback | AsyncCallback\ | Yes | Callback used to return the bundle name.|
**Example**
-```js
+```ts
let uid = 20010005;
bundle.getNameForUid(uid, (err, data) => {
if (err) {
@@ -1464,6 +1609,8 @@ getAbilityIcon(bundleName: string, abilityName: string): Promise\ | Yes | Callback used to return the [pixel map](js-apis-image.md).|
**Example**
-```js
+```ts
let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityIcon(bundleName, abilityName, (err, data) => {
@@ -1536,7 +1686,7 @@ bundle.getAbilityIcon(bundleName, abilityName, (err, data) => {
```
## InstallErrorCodedeprecated
-> This API is deprecated since API version 9. You are not advised to use it anymore.
+> This API is deprecated since API version 9. You are not advised using it anymore.
**System capability**: SystemCapability.BundleManager.BundleFramework
@@ -1567,7 +1717,11 @@ bundle.getAbilityIcon(bundleName, abilityName, (err, data) => {
> This API is deprecated since API version 9. You are advised to use [bundleManager.BundleFlag](js-apis-bundleManager.md#bundleflag) instead.
-Enumerates bundle flags.
+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
@@ -1587,9 +1741,9 @@ Enumerates bundle flags.
| GET_ALL_APPLICATION_INFO | 0xFFFF0000 | Obtains all application information. |
## BundleOptionsdeprecated
-> This API is deprecated since API version 9. You are not advised to use it anymore.
+> This API is deprecated since API version 9. You are not advised using it anymore.
-Describes the bundle options.
+Options that contain the user ID.
**System capability**: SystemCapability.BundleManager.BundleFramework
@@ -1601,7 +1755,7 @@ Describes the bundle options.
> This API is deprecated since API version 9. You are advised to use [bundleManager.AbilityType](js-apis-bundleManager.md#abilitytype) instead.
-Enumerates ability types.
+Enumerates the ability types.
**System capability**: SystemCapability.BundleManager.BundleFramework
@@ -1630,7 +1784,7 @@ Enumerates display orientations.
> This API is deprecated since API version 9. You are advised to use [bundleManager.LaunchType](js-apis-bundleManager.md#launchtype) instead.
-Enumerates launch modes.
+Enumerates the ability launch modes.
**System capability**: SystemCapability.BundleManager.BundleFramework
@@ -1640,9 +1794,9 @@ Enumerates launch modes.
| STANDARD | 1 | The ability can have multiple instances. |
## AbilitySubTypedeprecated
-> This API is deprecated since API version 9. You are not advised to use it anymore.
+> This API is deprecated since API version 9. You are not advised using it anymore.
-Enumerates ability subtypes.
+Enumerates the ability subtypes.
**System capability**: SystemCapability.BundleManager.BundleFramework
@@ -1652,9 +1806,9 @@ Enumerates ability subtypes.
| CA | 1 | Ability that has a UI.|
## ColorModedeprecated
-> This API is deprecated since API version 9. You are not advised to use it anymore.
+> This API is deprecated since API version 9. You are not advised using it anymore.
-Enumerates color modes.
+Enumerates the color modes of applications and widgets.
**System capability**: SystemCapability.BundleManager.BundleFramework
@@ -1669,7 +1823,7 @@ Enumerates color modes.
> This API is deprecated since API version 9. You are advised to use [bundleManager.PermissionGrantState](js-apis-bundleManager.md#permissiongrantstate) instead.
-Enumerates permission grant states.
+Enumerates the permission grant states.
**System capability**: SystemCapability.BundleManager.BundleFramework
diff --git a/en/application-dev/reference/apis/js-apis-bundle-AbilityInfo.md b/en/application-dev/reference/apis/js-apis-bundle-AbilityInfo.md
index 7f6d5b0196b97a252564d4c29f761aefa2117db3..315e7c0f045ba3b26520ed2a69f41f242872b8e6 100644
--- a/en/application-dev/reference/apis/js-apis-bundle-AbilityInfo.md
+++ b/en/application-dev/reference/apis/js-apis-bundle-AbilityInfo.md
@@ -1,6 +1,6 @@
# AbilityInfo
-Unless otherwise specified, ability information is obtained through **GET_BUNDLE_DEFAULT**.
+The **AbilityInfo** module provides information about an ability. Unless otherwise specified, the information is obtained through [GET_BUNDLE_DEFAULT](js-apis-Bundle.md).
> **NOTE**
>
@@ -8,13 +8,13 @@ Unless otherwise specified, ability information is obtained through **GET_BUNDLE
## AbilityInfo(deprecated)
-> This API is deprecated since API version 9. You are advised to use [AbilityInfo](js-apis-bundleManager-abilityInfo.md) instead.
+> This API is deprecated since API version 9. You are advised to use [bundleManager-AbilityInfo](js-apis-bundleManager-abilityInfo.md) instead.
**System capability**: SystemCapability.BundleManager.BundleFramework
| Name | Type | Readable| Writable| Description |
| --------------------- | -------------------------------------------------------- | ---- | ---- | ----------------------------------------- |
-| bundleName | string | Yes | No | Bundle name of the application. |
+| bundleName | string | Yes | No | Bundle name. |
| name | string | Yes | No | Ability name. |
| label | string | Yes | No | Ability name visible to users. |
| description | string | Yes | No | Ability description. |
@@ -25,17 +25,17 @@ Unless otherwise specified, ability information is obtained through **GET_BUNDLE
| process | string | Yes | No | Process in which the ability runs. If this parameter is not set, the bundle name is used.|
| targetAbility | string | Yes | No | Target ability that the ability alias points to.
This attribute can be used only in the FA model.|
| backgroundModes | number | Yes | No | Background service mode of the ability.
This attribute can be used only in the FA model. |
-| isVisible | boolean | Yes | No | Whether the ability can be called by other applications. |
+| isVisible | boolean | Yes | No | Whether the ability can be called by other bundles. |
| formEnabled | boolean | Yes | No | Whether the ability provides the service widget capability.
This attribute can be used only in the FA model.|
| type | AbilityType | Yes | No | Ability type.
This attribute can be used only in the FA model. |
-| orientation | DisplayOrientation | Yes | No | Ability display orientation. |
-| launchMode | LaunchMode | Yes | No | Ability launch mode. |
+| orientation | [DisplayOrientation](js-apis-Bundle.md#displayorientationdeprecated) | Yes | No | Ability display orientation. |
+| launchMode | [LaunchMode](js-apis-Bundle.md#launchmodedeprecated) | Yes | No | Ability launch mode. |
| permissions | Array\ | Yes | No | Permissions required for other applications to call the ability.
The value is obtained by passing **GET_ABILITY_INFO_WITH_PERMISSION**.|
| deviceTypes | Array\ | Yes | No | Device types supported by the ability. |
| deviceCapabilities | Array\ | Yes | No | Device capabilities required for the ability. |
| readPermission | string | Yes | No | Permission required for reading the ability data.
This attribute can be used only in the FA model.|
| writePermission | string | Yes | No | Permission required for writing data to the ability.
This attribute can be used only in the FA model.|
-| applicationInfo | [ApplicationInfo](js-apis-bundle-ApplicationInfo.md) | Yes | No | Application configuration information.
The value is obtained by passing **GET_ABILITY_INFO_WITH_APPLICATION**.|
+| applicationInfo | [ApplicationInfo](js-apis-bundle-ApplicationInfo.md) | Yes | No | Application configuration information.
The value is obtained by passing [GET_ABILITY_INFO_WITH_APPLICATION](js-apis-Bundle.md).|
| uri | string | Yes | No | URI of the ability.
This attribute can be used only in the FA model.|
| labelId | number | Yes | No | Ability label ID. |
| subType | AbilitySubType | Yes | No | Subtype of the template that can be used by the ability.
This attribute can be used only in the FA model.|
diff --git a/en/application-dev/reference/apis/js-apis-bundle-ApplicationInfo.md b/en/application-dev/reference/apis/js-apis-bundle-ApplicationInfo.md
index fb5aa288eaaf2f8eb65940f33902906c04c654c2..c1667a66eb011d24a1b7ce79061eab0f454604a3 100644
--- a/en/application-dev/reference/apis/js-apis-bundle-ApplicationInfo.md
+++ b/en/application-dev/reference/apis/js-apis-bundle-ApplicationInfo.md
@@ -1,6 +1,6 @@
# ApplicationInfo
-The **ApplicationInfo** module provides application information. Unless otherwise specified, all attributes are obtained through **GET_BUNDLE_DEFAULT**.
+The **ApplicationInfo** module provides application information. Unless otherwise specified, the information is obtained through [GET_BUNDLE_DEFAULT](js-apis-Bundle.md).
> **NOTE**
>
@@ -8,30 +8,30 @@ The **ApplicationInfo** module provides application information. Unless otherwis
## ApplicationInfo(deprecated)
-> This API is deprecated since API version 9. You are advised to use [ApplicationInfo](js-apis-bundleManager-applicationInfo.md) instead.
+> This API is deprecated since API version 9. You are advised to use [bundleManager-ApplicationInfo](js-apis-bundleManager-applicationInfo.md) instead.
**System capability**: SystemCapability.BundleManager.BundleFramework
-| Name | Type | Readable| Writable| Description |
-| -------------------------- | ------------------------------------------------------------ | ---- | ---- | ------------------------------------------------------------ |
-| name | string | Yes | No | Application name. |
-| description | string | Yes | No | Application description. |
-| descriptionId | number | Yes | No | Application description ID. |
-| systemApp | boolean | Yes | No | Whether the application is a system application. The default value is **false**. |
-| enabled | boolean | Yes | No | Whether the application is enabled. The default value is **true**. |
-| label | string | Yes | No | Application label. |
-| labelId(deprecated) | string | Yes | No | Application label ID.
\- **NOTE**: This attribute is deprecated from API version 9. Use **labelIndex** instead.|
-| icon | string | Yes | No | Application icon. |
-| iconId(deprecated) | string | Yes | No | Application icon ID.
\- **NOTE**: This attribute is deprecated from API version 9. Use **iconIndex** instead.|
-| process | string | Yes | No | Process in which the application runs. If this parameter is not set, the bundle name is used. |
-| supportedModes | number | Yes | No | Running modes supported by the application. |
-| moduleSourceDirs | Array\ | Yes | No | Relative paths for storing application resources. |
-| permissions | Array\ | Yes | No | Permissions required for accessing the application.
The value is obtained by passing **GET_APPLICATION_INFO_WITH_PERMISSION**.|
-| moduleInfos | Array\<[ModuleInfo](js-apis-bundle-ModuleInfo.md)> | Yes | No | Application module information. |
-| entryDir | string | Yes | No | Path for storing application files. |
-| codePath8+ | string | Yes | No | Installation directory of the application. |
-| metaData8+ | Map\> | Yes | No | Custom metadata of the application.
The value is obtained by passing **GET_APPLICATION_INFO_WITH_METADATA**.|
-| removable8+ | boolean | Yes | No | Whether the application is removable. |
-| accessTokenId8+ | number | Yes | No | Access token ID of the application. |
-| uid8+ | number | Yes | No | UID of the application. |
-| entityType8+ | string | Yes | No | Entity type of the application. |
+| Name | Type | Readable | Writable | Description |
+|----------------------------|------------------------------------------------------------------------|-----|-----|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| name | string | Yes | No | Application name. |
+| description | string | Yes | No | Application description. |
+| descriptionId | number | Yes | No | Application description ID. |
+| systemApp | boolean | Yes | No | Whether the application is a system application. The default value is **false**. |
+| enabled | boolean | Yes | No | Whether the application is enabled. The default value is **true**. |
+| label | string | Yes | No | Application label. |
+| labelId | string | Yes | No | Application label ID. |
+| icon | string | Yes | No | Application icon. |
+| iconId | string | Yes | No | Application icon ID. |
+| process | string | Yes | No | Process in which the application runs. If this parameter is not set, the bundle name is used. |
+| supportedModes | number | Yes | No | Modes supported by the application. Currently, only the **drive** mode is defined. This attribute applies only to head units. |
+| moduleSourceDirs | Array\ | Yes | No | Relative paths for storing application resources. |
+| permissions | Array\ | Yes | No | Permissions required for accessing the application.
The value is obtained by passing [GET_APPLICATION_INFO_WITH_PERMISSION](js-apis-Bundle.md). |
+| moduleInfos | Array\<[ModuleInfo](js-apis-bundle-ModuleInfo.md)> | Yes | No | Application module information. |
+| entryDir | string | Yes | No | Path for storing application files. |
+| codePath8+ | string | Yes | No | Installation directory of the application. |
+| metaData8+ | Map\> | Yes | No | Custom metadata of the application.
The value is obtained by passing [GET_APPLICATION_INFO_WITH_METADATA](js-apis-Bundle.md). |
+| removable8+ | boolean | Yes | No | Whether the application is removable. |
+| accessTokenId8+ | number | Yes | No | Access token ID of the application. |
+| uid8+ | number | Yes | No | UID of the application. |
+| entityType8+ | string | Yes | No | Category of the application, which can be **game**, **media**, **communication**, **news**, **travel**, **utility**, **shopping**, **education**, **kids**, **business**, and **photography**.|
diff --git a/en/application-dev/reference/apis/js-apis-bundle-BundleInfo.md b/en/application-dev/reference/apis/js-apis-bundle-BundleInfo.md
index f1d0240513193f217b71ccfc900acc5a211d07c3..c14419e736e1c2142fb47157826c42fb0d5cff34 100644
--- a/en/application-dev/reference/apis/js-apis-bundle-BundleInfo.md
+++ b/en/application-dev/reference/apis/js-apis-bundle-BundleInfo.md
@@ -1,18 +1,16 @@
# BundleInfo
-The **BundleInfo** module provides bundle information. Unless otherwise specified, all attributes are obtained through **GET_BUNDLE_DEFAULT**.
+The **BundleInfo** module provides bundle information. Unless otherwise specified, the information is obtained through [GET_BUNDLE_DEFAULT](js-apis-Bundle.md).
> **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.
-
-
## BundleInfo(deprecated)
-> This API is deprecated since API version 9. You are advised to use [BundleInfo](js-apis-bundleManager-bundleInfo.md) instead.
+> This API is deprecated since API version 9. You are advised to use [bundleManager-BundleInfo](js-apis-bundleManager-bundleInfo.md) instead.
- **System capability**: SystemCapability.BundleManager.BundleFramework
+**System capability**: SystemCapability.BundleManager.BundleFramework
| Name | Type | Readable| Writable| Description |
| --------------------------------- | ------------------------------------------------------------ | ---- | ---- | ------------------------------------------------------------ |
@@ -25,7 +23,7 @@ The **BundleInfo** module provides bundle information. Unless otherwise specifie
| appInfo | [ApplicationInfo](js-apis-bundle-ApplicationInfo.md) | Yes | No | Application configuration information. |
| abilityInfos | Array\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)> | Yes | No | Ability configuration information.
The value is obtained by passing **GET_BUNDLE_WITH_ABILITIES**.|
| reqPermissions | Array\ | Yes | No | Permissions to request from the system for running the application.
The value is obtained by passing **GET_BUNDLE_WITH_REQUESTED_PERMISSION**.|
-| reqPermissionDetails | Array\<[ReqPermissionDetail](#reqpermissiondetail)> | Yes | No | Detailed information of the permissions to request from the system.
The value is obtained by passing **GET_BUNDLE_WITH_REQUESTED_PERMISSION**.|
+| reqPermissionDetails | Array\<[ReqPermissionDetail](#reqpermissiondetaildeprecated)> | Yes | No | Detailed information of the permissions to request from the system.
The value is obtained by passing **GET_BUNDLE_WITH_REQUESTED_PERMISSION**.|
| vendor | string | Yes | No | Vendor of the bundle. |
| versionCode | number | Yes | No | Version number of the bundle. |
| versionName | string | Yes | No | Version description of the bundle. |
@@ -38,7 +36,7 @@ The **BundleInfo** module provides bundle information. Unless otherwise specifie
| isSilentInstallation | string | Yes | No | Whether the application can be installed in silent mode. |
| minCompatibleVersionCode | number | Yes | No | Earliest version compatible with the bundle in the distributed scenario. |
| entryInstallationFree | boolean | Yes | No | Whether installation-free is supported for the entry module. |
-| reqPermissionStates8+ | Array\ | Yes | No | Permission grant state. |
+| reqPermissionStates8+ | Array\ | Yes | No | Permission grant state. The value **0** means that the request is successful, and **-1** means the opposite. |
@@ -54,7 +52,7 @@ Provides the detailed information of the permissions to request from the system.
| --------------------- | ----------------------- | ---- | ---- | ---------------------- |
| name | string | Yes | Yes | Name of the permission to request. |
| reason | string | Yes | Yes | Reason for requesting the permission. |
-| usedScene | [UsedScene](#usedscene) | Yes | Yes | Application scenario and timing for using the permission.|
+| usedScene | [UsedScene](#usedscenedeprecated) | Yes | Yes | Application scenario and timing for using the permission.|
diff --git a/en/application-dev/reference/apis/js-apis-bundle-BundleInstaller.md b/en/application-dev/reference/apis/js-apis-bundle-BundleInstaller.md
index 9ab7fb823fc00cc663c909c48fca2e6cee047545..0570453b5cb9c1bfa6a1e0f0acb9dda16562005e 100644
--- a/en/application-dev/reference/apis/js-apis-bundle-BundleInstaller.md
+++ b/en/application-dev/reference/apis/js-apis-bundle-BundleInstaller.md
@@ -12,7 +12,7 @@ The **BundleInstaller** module provides APIs for you to install, uninstall, and
install(bundleFilePaths: Array<string>, param: InstallParam, callback: AsyncCallback<InstallStatus>): void;
-Installs a bundle. This API uses an asynchronous callback to return the result.
+Installs a bundle. Multiple HAP files can be installed. This API uses an asynchronous callback to return the result.
**Required permissions**
@@ -28,9 +28,33 @@ SystemCapability.BundleManager.BundleFramework
| Name | Type | Mandatory| Description |
| --------------- | ---------------------------------------------------- | ---- | ------------------------------------------------------------ |
-| bundleFilePaths | Array<string> | Yes | Paths where the HAP files of the bundle are stored. Each path should point to a relative directory of the current bundle's data directory.|
-| param | [InstallParam](#installparam) | Yes | Parameters required for bundle installation. |
-| callback | AsyncCallback<[InstallStatus](#installstatus)> | Yes | Callback used to return the installation status. |
+| bundleFilePaths | Array<string> | Yes | Sandbox path where the HAP files of the bundle are stored. For details about how to obtain the sandbox path, see [Obtaining the Sandbox Path](#obtaining-the-sandbox-path).|
+| param | [InstallParam](#installparamdeprecated) | Yes | Parameters required for bundle installation. |
+| callback | AsyncCallback<[InstallStatus](#installstatusdeprecated)> | Yes | Callback used to return the installation status. |
+
+**Example**
+
+```ts
+import bundle from '@ohos.bundle';
+let hapFilePaths = ['/data/storage/el2/base/haps/entry/files/'];
+let installParam = {
+ userId: 100,
+ isKeepData: false,
+ installFlag: 1,
+};
+
+bundle.getBundleInstaller().then(installer=>{
+ installer.install(hapFilePaths, installParam, err => {
+ if (err) {
+ console.error('install failed:' + JSON.stringify(err));
+ } else {
+ console.info('install successfully.');
+ }
+ });
+}).catch(error => {
+ console.error('getBundleInstaller failed. Cause: ' + error.message);
+});
+```
## BundleInstaller.uninstall(deprecated)
@@ -55,16 +79,39 @@ SystemCapability.BundleManager.BundleFramework
| Name | Type | Mandatory| Description |
| ---------- | ---------------------------------------------------- | ---- | ---------------------------------------------- |
| bundleName | string | Yes | Bundle name. |
-| param | [InstallParam](#installparam) | Yes | Parameters required for bundle uninstall. |
-| callback | AsyncCallback<[InstallStatus](#installstatus)> | Yes | Callback used to return the installation status.|
-
+| param | [InstallParam](#installparamdeprecated) | Yes | Parameters required for bundle uninstall. |
+| callback | AsyncCallback<[InstallStatus](#installstatusdeprecated)> | Yes | Callback used to return the installation status.|
+
+**Example**
+
+```ts
+import bundle from '@ohos.bundle';
+let bundleName = 'com.example.myapplication';
+let installParam = {
+ userId: 100,
+ isKeepData: false,
+ installFlag: 1,
+};
+
+bundle.getBundleInstaller().then(installer=>{
+ installer.uninstall(bundleName, installParam, err => {
+ if (err) {
+ console.error('uninstall failed:' + JSON.stringify(err));
+ } else {
+ console.info('uninstall successfully.');
+ }
+ });
+}).catch(error => {
+ console.error('getBundleInstaller failed. Cause: ' + error.message);
+});
+```
## BundleInstaller.recover(deprecated)
> This API is deprecated since API version 9. You are advised to use [recover](js-apis-installer.md) instead.
recover(bundleName: string, param: InstallParam, callback: AsyncCallback<InstallStatus>): void;
-Recovers a bundle. This API uses an asynchronous callback to return the result.
+Recovers a bundle. This API uses an asynchronous callback to return the result. After a pre-installed bundle is uninstalled, you can call this API to recover it.
**Required permissions**
@@ -81,12 +128,37 @@ SystemCapability.BundleManager.BundleFramework
| Name | Type | Mandatory| Description |
| ---------- | ---------------------------------------------------- | ---- | ---------------------------------------------- |
| bundleName | string | Yes | Bundle name. |
-| param | [InstallParam](#installparam) | Yes | Parameters required for bundle recovering. |
-| callback | AsyncCallback<[InstallStatus](#installstatus)> | Yes | Callback used to return the installation status.|
+| param | [InstallParam](#installparamdeprecated) | Yes | Parameters required for bundle recovery. |
+| callback | AsyncCallback<[InstallStatus](#installstatusdeprecated)> | Yes | Callback used to return the recovery status.|
+
+**Example**
+
+```ts
+import bundle from '@ohos.bundle';
+
+let bundleName = 'com.example.myapplication';
+let installParam = {
+ userId: 100,
+ isKeepData: false,
+ installFlag: 1,
+};
+
+bundle.getBundleInstaller().then(installer=>{
+ installer.recover(bundleName, installParam, err => {
+ if (err) {
+ console.error('recover failed:' + JSON.stringify(err));
+ } else {
+ console.info('recover successfully.');
+ }
+ });
+}).catch(error => {
+ console.error('getBundleInstaller failed. Cause: ' + error.message);
+});
+```
## InstallParam(deprecated)
-Describes the parameters required for bundle installation or uninstall.
+Describes the parameters required for bundle installation, recovery, or uninstall.
**System capability**: SystemCapability.BundleManager.BundleFramework
@@ -100,7 +172,7 @@ Describes the parameters required for bundle installation or uninstall.
## InstallStatus(deprecated)
-Describes the bundle installation status.
+Describes the bundle installation or uninstall status.
**System capability**: SystemCapability.BundleManager.BundleFramework
@@ -110,3 +182,27 @@ Describes the bundle installation status.
| ------------- | ------------------------------------------------------------ | ---- | ---- | ------------------------------ |
| status | bundle.[InstallErrorCode](js-apis-Bundle.md#installerrorcode) | Yes | No | Installation or uninstall error code. |
| statusMessage | string | Yes | No | Installation or uninstall status message.|
+
+## Obtaining the Sandbox Path
+For the FA model, the sandbox path of a bundle can be obtained using the APIs in [Context](js-apis-inner-app-context.md). For the sage model, the sandbox path can be obtained using the attribute in [Context](js-apis-ability-context.md#abilitycontext). The following describes how to obtain the sandbox path.
+
+**Example**
+``` ts
+// Stage model
+import Ability from '@ohos.application.Ability';
+class MainAbility extends Ability {
+ onWindowStageCreate(windowStage) {
+ let context = this.context;
+ let pathDir = context.filesDir;
+ console.info('sandbox path is ' + pathDir);
+ }
+}
+
+// FA model
+import featureAbility from '@ohos.ability.featureAbility';
+let context = featureAbility.getContext();
+context.getFilesDir().then((data) => {
+ let pathDir = data;
+ console.info('sandbox path is ' + pathDir);
+});
+```
diff --git a/en/application-dev/reference/apis/js-apis-bundle-CustomizeData.md b/en/application-dev/reference/apis/js-apis-bundle-CustomizeData.md
index 246f1420fbb328cab877fa7e83476a558530b9f9..e54a37c697a4b44df566aa8f517a4b0befd8297b 100644
--- a/en/application-dev/reference/apis/js-apis-bundle-CustomizeData.md
+++ b/en/application-dev/reference/apis/js-apis-bundle-CustomizeData.md
@@ -14,6 +14,6 @@ The **CustomizeData** module provides custom metadata.
| Name | Type | Readable| Writable| Description |
| ------------------ | ------ | ---- | ---- | ---------------- |
-| name | string | Yes | Yes | Custom metadata name.|
-| value | string | Yes | Yes | Custom metadata value. |
-| extra8+ | string | Yes | Yes | Custom metadata resources. |
+| name | string | Yes | Yes | Key that identifies a data element.|
+| value | string | Yes | Yes | Value of the data element. |
+| extra8+ | string | Yes | Yes | Custom format of the data element. The value is an index to the resource that identifies the data. |
diff --git a/en/application-dev/reference/apis/js-apis-bundle-ElementName.md b/en/application-dev/reference/apis/js-apis-bundle-ElementName.md
index 54f43e7a56376caf4ea623d358fc27bec2d54dbc..b20de58d074a83dea5cb0992e21087ae64b990bb 100644
--- a/en/application-dev/reference/apis/js-apis-bundle-ElementName.md
+++ b/en/application-dev/reference/apis/js-apis-bundle-ElementName.md
@@ -1,6 +1,6 @@
# ElementName
-The **ElementName** module provides the element name information, which can be obtained through [Context.getElementName](js-apis-Context.md).
+The **ElementName** module provides element name information, which can be obtained through [Context.getElementName](js-apis-inner-app-context.md).
> **NOTE**
>
@@ -8,7 +8,9 @@ The **ElementName** module provides the element name information, which can be o
## ElementName(deprecated)
-> This API is deprecated since API version 9. You are advised to use [ElementName](js-apis-bundleManager-elementName.md) instead.
+> This API is deprecated since API version 9. You are advised to use [bundleManager-ElementName](js-apis-bundleManager-elementName.md) instead.
+
+Describes the element name information, which identifies the basic information about an ability and is obtained through [Context.getElementName](js-apis-inner-app-context.md).
**System capability**: SystemCapability.BundleManager.BundleFramework
diff --git a/en/application-dev/reference/apis/js-apis-bundle-HapModuleInfo.md b/en/application-dev/reference/apis/js-apis-bundle-HapModuleInfo.md
index 0e252cc3fe46c45114a2d9cb9738c6ec3e0a9ffe..5540aa2bc56b9f8e34fda11d11048b8177816b95 100644
--- a/en/application-dev/reference/apis/js-apis-bundle-HapModuleInfo.md
+++ b/en/application-dev/reference/apis/js-apis-bundle-HapModuleInfo.md
@@ -1,6 +1,6 @@
# HapModuleInfo
-The **HapModuleInfo** module provides module information. Unless otherwise specified, all attributes are obtained through **GET_BUNDLE_DEFAULT**.
+The **HapModuleInfo** module provides information about an HAP module. Unless otherwise specified, the information is obtained through [GET_BUNDLE_DEFAULT](js-apis-Bundle.md).
> **NOTE**
>
@@ -8,7 +8,7 @@ The **HapModuleInfo** module provides module information. Unless otherwise speci
## HapModuleInfo(deprecated)
-> This API is deprecated since API version 9. You are advised to use [HapModuleInfo](js-apis-bundleManager-hapModuleInfo.md) instead.
+> This API is deprecated since API version 9. You are advised to use [bundleManager-HapModuleInfo](js-apis-bundleManager-hapModuleInfo.md) instead.
**System capability**: SystemCapability.BundleManager.BundleFramework
diff --git a/en/application-dev/reference/apis/js-apis-bundle-ModuleInfo.md b/en/application-dev/reference/apis/js-apis-bundle-ModuleInfo.md
index 781b34f89b8a954c5f0be626fcbfe0d3fc5ab3f8..18707feeb05902b5740b00544b3a23a43c09acce 100644
--- a/en/application-dev/reference/apis/js-apis-bundle-ModuleInfo.md
+++ b/en/application-dev/reference/apis/js-apis-bundle-ModuleInfo.md
@@ -7,10 +7,9 @@ The **ModuleInfo** module provides module information of an application.
> 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.
## ModuleInfo(deprecated)
-> This API is deprecated since API version 9. You are advised to use [HapModuleInfo](js-apis-bundleManager-hapModuleInfo.md) instead.
+> This API is deprecated since API version 9. You are advised to use [bundleManager-HapModuleInfo](js-apis-bundleManager-hapModuleInfo.md) instead.
**System capability**: SystemCapability.BundleManager.BundleFramework
-
| Name | Type | Readable| Writable| Description |
| --------------- | ------ | ---- | ---- | -------- |
| moduleName | string | Yes | No | Module name.|
diff --git a/en/application-dev/reference/apis/js-apis-bundle-PermissionDef.md b/en/application-dev/reference/apis/js-apis-bundle-PermissionDef.md
index aa7b5da045a32bb53590a8b3a5f9ec1f3dffce0e..ded02c772794179d9e8276292ab1be939a208d8f 100644
--- a/en/application-dev/reference/apis/js-apis-bundle-PermissionDef.md
+++ b/en/application-dev/reference/apis/js-apis-bundle-PermissionDef.md
@@ -8,7 +8,7 @@ The **PermissionDef** module provides permission details defined in the configur
## **PermissionDef**(deprecated)
-> This API is deprecated since API version 9. You are advised to use [PermissionDef](js-apis-bundleManager-permissionDef.md) instead.
+> This API is deprecated since API version 9. You are advised to use [bundleManager-PermissionDef](js-apis-bundleManager-permissionDef.md) instead.
**System capability**: SystemCapability.BundleManager.BundleFramework
@@ -17,6 +17,6 @@ The **PermissionDef** module provides permission details defined in the configur
| Name | Type | Readable| Writable| Description |
| -------------- | ------ | ---- | ---- | -------------- |
| permissionName | string | Yes | No | Name of the permission. |
-| grantMode | number | Yes | No | Grant mode of the permission.|
+| grantMode | number | Yes | No | Grant mode of the permission. The value **0** means that the system automatically grants the permission after the application installation, and **1** means that the application needs to dynamically request the permission from the user.|
| labelId | number | Yes | No | Label ID of the permission. |
| descriptionId | number | Yes | No | Description ID of the permission. |
diff --git a/en/application-dev/reference/apis/js-apis-bundle-ShortcutInfo.md b/en/application-dev/reference/apis/js-apis-bundle-ShortcutInfo.md
index adf30d8b7442dd67e822f200a0114f93957bd892..1a603da33b3403dafbac79e1bfcd31c5dde9896c 100644
--- a/en/application-dev/reference/apis/js-apis-bundle-ShortcutInfo.md
+++ b/en/application-dev/reference/apis/js-apis-bundle-ShortcutInfo.md
@@ -1,16 +1,14 @@
-# ShortcutInfo(deprecated)
+# shortcutInfo
-The **ShortcutInfo** module provides shortcut information defined in the configuration file. For details about the configuration in the FA model, see [config.json](../../quick-start/package-structure.md). For details about the configuration in the stage model, see [Internal Structure of the shortcuts Attribute](../../quick-start/stage-structure.md#internal-structure-of-the-shortcuts-attribute).
+The **shortcutInfo** module defines shortcut information configured in the configuration file. For the FA model, the shortcut information is configured in the [config.json](../../quick-start/application-configuration-file-overview-fa.md) file. For the stage model, the information is configured in the configuration file under **resources/base/profile** in the development view.
> **NOTE**
>
-> This module is deprecated since API version 9. You are advised to use [ShortcutInfo](js-apis-bundleManager-shortcutInfo.md) instead.
->
> 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.
## ShortcutWant(deprecated)
-> This API is deprecated since API version 9. You are advised to use [ShortcutWant](js-apis-bundleManager-shortcutInfo.md) instead.
+> This API is deprecated since API version 9. You are advised to use [bundleManager-ShortcutWant](js-apis-bundleManager-shortcutInfo.md) instead.
**System capability**: SystemCapability.BundleManager.BundleFramework
@@ -23,7 +21,7 @@ The **ShortcutInfo** module provides shortcut information defined in the configu
## ShortcutInfo(deprecated)
-> This API is deprecated since API version 9. You are advised to use [ShortcutInfo](js-apis-bundleManager-shortcutInfo.md) instead.
+> This API is deprecated since API version 9. You are advised to use [bundleManager-ShortcutInfo](js-apis-bundleManager-shortcutInfo.md) instead.
**System capability**: SystemCapability.BundleManager.BundleFramework
@@ -35,10 +33,12 @@ The **ShortcutInfo** module provides shortcut information defined in the configu
| hostAbility | string | Yes | No | Local ability information of the shortcut. |
| icon | string | Yes | No | Icon of the shortcut. |
| iconId8+ | number | Yes | No | Icon ID of the shortcut. |
-| label | string | Yes | No | Label of the shortcut. |
-| labelId8+ | number | Yes | No | Label ID of the shortcut. |
+| label | string | Yes | No | Name of the shortcut. |
+| labelId8+ | number | Yes | No | Name ID of the shortcut. |
| disableMessage | string | Yes | No | Message displayed when the shortcut is disabled. |
-| wants | Array<[ShortcutWant](#shortcutwant)> | Yes | No | Want information required for the shortcut. |
+| wants | Array<[ShortcutWant](#shortcutwant)> | Yes | No | Want list for the shortcut. |
| isStatic | boolean | Yes | No | Whether the shortcut is static. |
| isHomeShortcut | boolean | Yes | No | Whether the shortcut is a home shortcut.|
| isEnabled | boolean | Yes | No | Whether the shortcut is enabled. |
+
+
\ No newline at end of file
diff --git a/en/application-dev/reference/apis/js-apis-bundle-remoteAbilityInfo.md b/en/application-dev/reference/apis/js-apis-bundle-remoteAbilityInfo.md
index ffde8d4356caee1dde9f47bdbb424d2dbdda57bb..f95125fb1c7228f9eade37f423b624c3289c0e34 100644
--- a/en/application-dev/reference/apis/js-apis-bundle-remoteAbilityInfo.md
+++ b/en/application-dev/reference/apis/js-apis-bundle-remoteAbilityInfo.md
@@ -8,7 +8,7 @@ The **RemoteAbilityInfo** module provides information about a remote ability.
## RemoteAbilityInfo(deprecated)
-> This API is deprecated since API version 9. You are advised to use [RemoteAbilityInfo](js-apis-bundleManager-remoteAbilityInfo.md) instead.
+> This API is deprecated since API version 9. You are advised to use [bundleManager-RemoteAbilityInfo](js-apis-bundleManager-remoteAbilityInfo.md) instead.
**System capability**: SystemCapability.BundleManager.DistributedBundleFramework
@@ -16,6 +16,6 @@ The **RemoteAbilityInfo** module provides information about a remote ability.
| Name | Type | Readable| Writable| Description |
| ----------- | -------------------------------------------- | ---- | ---- | ----------------------- |
-| elementName | [ElementName](js-apis-bundle-ElementName.md) | Yes | No | Element name of the ability. |
-| label | string | Yes | No | Label of the ability. |
+| elementName | [ElementName](js-apis-bundle-ElementName.md) | Yes | No | Element name information of the ability. |
+| label | string | Yes | No | Ability name. |
| icon | string | Yes | No | Icon of the ability.|
diff --git a/en/application-dev/reference/apis/js-apis-bundleManager-elementName.md b/en/application-dev/reference/apis/js-apis-bundleManager-elementName.md
index 6948fac50faf7146b4bc0a8aabfb1eef2d1c719f..662f0e37640287de5e10273a45d8db327a4551da 100644
--- a/en/application-dev/reference/apis/js-apis-bundleManager-elementName.md
+++ b/en/application-dev/reference/apis/js-apis-bundleManager-elementName.md
@@ -1,6 +1,6 @@
# ElementName
-The **ElementName** module provides information about an element name. The information can be obtained through [Context.getElementName](js-apis-Context.md).
+The **ElementName** module provides element name information, which can be obtained through [Context.getElementName](js-apis-inner-app-context.md).
> **NOTE**
diff --git a/en/application-dev/reference/apis/js-apis-bundleManager-shortcutInfo.md b/en/application-dev/reference/apis/js-apis-bundleManager-shortcutInfo.md
index 0f1d6b7e992484875d65479a3734b00484141d21..2c06d138b5bfda6383fabc14e28d3fb008af0bf0 100644
--- a/en/application-dev/reference/apis/js-apis-bundleManager-shortcutInfo.md
+++ b/en/application-dev/reference/apis/js-apis-bundleManager-shortcutInfo.md
@@ -1,10 +1,12 @@
# ShortcutInfo
-The **ShortcutInfo** module provides shortcut information defined in the configuration file. For details about the configuration in the FA model, see [config.json](../../quick-start/package-structure.md). For details about the configuration in the stage model, see [Internal Structure of the shortcuts Attribute](../../quick-start/stage-structure.md#internal-structure-of-the-shortcuts-attribute).
+The **ShortcutInfo** module defines shortcut information configured in the configuration file. The information can be obtained through [getShortcutInfo](js-apis-launcherBundleManager.md#launcherbundlemanagergetshortcutinfo9).
> **NOTE**
>
> The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.
+>
+> For the FA model, the shortcut information is configured in the [config.json](../../quick-start/module-structure.md) file. For details about the shortcut information in the stage model, see [shortcuts](../../quick-start/module-configuration-file.md#shortcuts).
## ShortcutWant
@@ -16,7 +18,7 @@ The **ShortcutInfo** module provides shortcut information defined in the configu
| ------------------------- | ------ | ---- | ---- | -------------------- |
| targetBundle | string | Yes | No | Target bundle name of the shortcut.|
| targetModule | string | Yes | No | Target module name of the shortcut. |
-| targetAbility | string | Yes | No | Target ability name of the shortcut.|
+| targetAbility | string | Yes | No | Target ability name of the shortcut.|
## ShortcutInfo
@@ -35,3 +37,5 @@ The **ShortcutInfo** module provides shortcut information defined in the configu
| label | string | Yes | No | Label of the shortcut. |
| labelId | number | Yes | No | Label ID of the shortcut. |
| wants | Array\<[ShortcutWant](#shortcutwant)> | Yes | No | Want information required for the shortcut. |
+
+
\ No newline at end of file
diff --git a/en/application-dev/reference/apis/js-apis-bundleManager.md b/en/application-dev/reference/apis/js-apis-bundleManager.md
index ef3ef84fab57b0ca3e10e2ea27aede219b2e4e6c..525f882052397b5d59e5d4a22c79dc013c847e6a 100644
--- a/en/application-dev/reference/apis/js-apis-bundleManager.md
+++ b/en/application-dev/reference/apis/js-apis-bundleManager.md
@@ -1,4 +1,4 @@
-# bundleManager
+# @ohos.bundle.bundleManager
The **bundleManager** module provides APIs for querying information about bundles, applications, abilities, Extension abilities, and more.
@@ -96,10 +96,10 @@ Enumerates the types of Extension abilities.
| Name| Value| Description|
|:----------------:|:---:|-----|
-| FORM | 0 | [FormExtensionAbility](../../ability/stage-formextension.md): provides APIs for widget development.|
+| FORM | 0 | [FormExtensionAbility](../../application-models/widget-development-stage.md): provides APIs for widget development.|
| WORK_SCHEDULER | 1 | [WorkSchedulerExtensionAbility](../../task-management/work-scheduler-dev-guide.md): enables applications to execute non-real-time tasks when the system is idle.|
| INPUT_METHOD | 2 | [InputMethodExtensionAbility](js-apis-inputmethod-extension-ability.md): provides APIs for developing input method applications.|
-| SERVICE | 3 | [ServiceExtensionAbility](../../ability/stage-serviceextension.md): enables applications to run in the background and provide services.|
+| SERVICE | 3 | [ServiceExtensionAbility](../../application-models/serviceextensionability.md): enables applications to run in the background and provide services.|
| ACCESSIBILITY | 4 | [AccessibilityExtensionAbility](js-apis-application-accessibilityExtensionAbility.md): provides accessibility for access to and operations on the UI.|
| DATA_SHARE | 5 | [DataShareExtensionAbility](../../database/database-datashare-guidelines.md): enables applications to read and write data.|
| FILE_SHARE | 6 | FileShareExtensionAbility: enables file sharing between applications. This ability is reserved.|
@@ -2181,8 +2181,8 @@ For details about the error codes, see [Bundle Error Codes](../errorcodes/errorc
| ID| Error Message |
| -------- | ------------------------------------------------------------ |
-| 17700002 | The specified moduleName is not existed. |
-| 17700003 | The specified abilityName is not existed. |
+| 17700002 | The specified moduleName does not exist. |
+| 17700003 | The specified abilityName does not exist. |
| 17700024 | Failed to get the profile because there is no profile in the HAP. |
| 17700026 | The specified bundle is disabled. |
| 17700029 | The specified ability is disabled. |
@@ -2236,8 +2236,8 @@ For details about the error codes, see [Bundle Error Codes](../errorcodes/errorc
| ID| Error Message |
| -------- | ------------------------------------------------------------ |
-| 17700002 | The specified moduleName is not existed. |
-| 17700003 | The specified abilityName is not existed. |
+| 17700002 | The specified moduleName does not exist. |
+| 17700003 | The specified abilityName does not exist. |
| 17700024 | Failed to get the profile because there is no profile in the HAP. |
| 17700026 | The specified bundle is disabled. |
| 17700029 | The specified ability is disabled. |
@@ -2299,7 +2299,7 @@ For details about the error codes, see [Bundle Error Codes](../errorcodes/errorc
| ID| Error Message |
| -------- | ------------------------------------------------------------ |
-| 17700002 | The specified moduleName is not existed. |
+| 17700002 | The specified moduleName does not exist. |
| 17700003 | The specified extensionAbilityName not existed. |
| 17700024 | Failed to get the profile because there is no profile in the HAP. |
| 17700026 | The specified bundle is disabled. |
@@ -2353,7 +2353,7 @@ For details about the error codes, see [Bundle Error Codes](../errorcodes/errorc
| ID| Error Message |
| -------- | ------------------------------------------------------------ |
-| 17700002 | The specified moduleName is not existed. |
+| 17700002 | The specified moduleName does not exist. |
| 17700003 | The specified extensionAbilityName not existed. |
| 17700024 | Failed to get the profile because there is no profile in the HAP. |
| 17700026 | The specified bundle is disabled. |
@@ -2903,3 +2903,5 @@ try {
console.error('getBundleInfoSync failed:' + err.message);
}
```
+
+
\ No newline at end of file
diff --git a/en/application-dev/reference/apis/js-apis-bundleMonitor.md b/en/application-dev/reference/apis/js-apis-bundleMonitor.md
index ceef9d85218006916a52300887103c838d5bcd56..cf2d7aab46c5d8ea80d49fe66b61ae68e56885a0 100644
--- a/en/application-dev/reference/apis/js-apis-bundleMonitor.md
+++ b/en/application-dev/reference/apis/js-apis-bundleMonitor.md
@@ -1,4 +1,4 @@
-# Bundle.bundleMonitor
+# @ohos.bundle.bundleMonitor
The **Bundle.bundleMonitor** module provides APIs for listens for bundle installation, uninstall, and updates.
@@ -18,7 +18,7 @@ import bundleMonitor from '@ohos.bundle.bundleMonitor';
| ------------------------------------ | ----------- | ------------------------------ |
| ohos.permission.LISTEN_BUNDLE_CHANGE | system_core | Permission to listen for bundle installation, uninstall, and updates.|
-For details, see [Permission Levels](../../security/accesstoken-overview.md#permission-levels).
+For details, see [Permission Levels](../../security/accesstoken-overview.md).
## BundleChangeInfo
@@ -50,10 +50,6 @@ Subscribes to bundle installation, uninstall, and update events.
| BundleChangedEvent | string | Yes | Type of the event to subscribe to.|
| Callback\ | callback | Yes | Callback used for the subscription.|
-**Error codes**
-
-For details about the error codes, see [Bundle Error Codes](../errorcodes/errorcode-bundle.md).
-
**Example**
```ts
@@ -87,10 +83,6 @@ Unsubscribes from bundle installation, uninstall, and update events.
| BundleChangedEvent | string | Yes | Type of the event to unsubscribe from. |
| Callback\ | callback | Yes | Callback used for the unsubscription. If this parameter is left empty, all callbacks of the current event are unsubscribed from.|
-**Error codes**
-
-For details about the error codes, see [Bundle Error Codes](../errorcodes/errorcode-bundle.md).
-
**Example**
```ts
diff --git a/en/application-dev/reference/apis/js-apis-defaultAppManager.md b/en/application-dev/reference/apis/js-apis-defaultAppManager.md
index 28830ea0737c3243e97dd2a02256b32f54616f6d..dd19bdb98680553ff3f66b3484ab95aa97b5b52d 100644
--- a/en/application-dev/reference/apis/js-apis-defaultAppManager.md
+++ b/en/application-dev/reference/apis/js-apis-defaultAppManager.md
@@ -1,4 +1,4 @@
-# DefaultAppManager
+# @ohos.bundle.defaultAppManager (Default Application Management)
The **DefaultAppManager** module provides APIs to query whether the current application is the default application of a specific type.
@@ -18,25 +18,25 @@ import defaultAppMgr from '@ohos.bundle.defaultAppManager';
| --------------------------------------- | ----------- | ---------------- |
| ohos.permission.GET_DEFAULT_APPLICATION | system_core | Permission related to the default application.|
-For details, see in [Permission Levels](../../security/accesstoken-overview.md#permission-levels).
+For details, see [Permission Levels](../../security/accesstoken-overview.md#permission-levels).
## defaultAppMgr.ApplicationType
-Enumerates the application types.
+Enumerates the default application types.
**System capability**: SystemCapability.BundleManager.BundleFramework.DefaultApp
-| Name | Type | Value | Description |
-| -------- | -------- | -------------------------------------- | -------------------------------------- |
-| BROWSER | string | Web Browser | Default browser. |
-| IMAGE | string | Image Gallery | Default image viewer. |
-| AUDIO | string | Audio Player | Default audio player. |
-| VIDEO | string | Video Player | Default video player. |
-| PDF | string | PDF Viewer | Default PDF reader. |
-| WORD | string | Word Viewer | Default Word viewer. |
-| EXCEL | string | Excel Viewer | Default Excel viewer. |
-| PPT | string | PPT Viewer | Default PowerPoint viewer. |
+| Name | Value| Description |
+| -------- | -------------------------------------- | -------------------------------------- |
+| BROWSER | "Web Browser" | Default browser. |
+| IMAGE | "Image Gallery" | Default image viewer. |
+| AUDIO | "Audio Player" | Default audio player. |
+| VIDEO | "Video Player" | Default video player. |
+| PDF | "PDF Viewer" | Default PDF reader. |
+| WORD | "Word Viewer" | Default Word viewer. |
+| EXCEL | "Excel Viewer" | Default Excel viewer. |
+| PPT | "PPT Viewer" | Default PowerPoint viewer. |
## defaultAppMgr.isDefaultApplication
@@ -58,10 +58,6 @@ Checks whether this application is the default application of a system-defined a
| ------------------------- | ------------------ |
| Promise\ | Promise used to return the result. If the application is the default application, `true` is returned; otherwise, `false` is returned.|
-**Error codes**
-
-For details about the error codes, see [Bundle Error Codes](../errorcodes/errorcode-bundle.md).
-
**Example**
@@ -90,13 +86,9 @@ Checks whether this application is the default application of a system-defined a
| type | string | Yes | Type of the target application. It must be set to a value defined by [ApplicationType](#defaultappmgrapplicationtype). |
| callback | AsyncCallback\ | Yes | Callback used to return the result. If the application is the default application, `true` is returned; otherwise, `false` is returned.|
-**Error codes**
-
-For details about the error codes, see [Bundle Error Codes](../errorcodes/errorcode-bundle.md).
-
**Example**
-```js
+```ts
import defaultAppMgr from '@ohos.bundle.defaultAppManager';
defaultAppMgr.isDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, (err, data) => {
if (err) {
@@ -144,7 +136,7 @@ For details about the error codes, see [Bundle Error Codes](../errorcodes/errorc
**Example**
-```js
+```ts
import defaultAppMgr from '@ohos.bundle.defaultAppManager';
defaultAppMgr.getDefaultApplication(defaultAppMgr.ApplicationType.BROWSER)
.then((data) => {
@@ -195,7 +187,7 @@ For details about the error codes, see [Bundle Error Codes](../errorcodes/errorc
**Example**
-```js
+```ts
import defaultAppMgr from '@ohos.bundle.defaultAppManager';
let userId = 100;
defaultAppMgr.getDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, userId, (err, data) => {
@@ -246,7 +238,7 @@ For details about the error codes, see [Bundle Error Codes](../errorcodes/errorc
**Example**
-```js
+```ts
import defaultAppMgr from '@ohos.bundle.defaultAppManager';
defaultAppMgr.getDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, (err, data) => {
if (err) {
@@ -302,7 +294,7 @@ For details about the error codes, see [Bundle Error Codes](../errorcodes/errorc
**Example**
-```js
+```ts
import defaultAppMgr from '@ohos.bundle.defaultAppManager';
defaultAppMgr.setDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, {
bundleName: "com.test.app",
@@ -369,7 +361,7 @@ For details about the error codes, see [Bundle Error Codes](../errorcodes/errorc
**Example**
-```js
+```ts
import defaultAppMgr from '@ohos.bundle.defaultAppManager';
let userId = 100;
defaultAppMgr.setDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, {
@@ -486,7 +478,7 @@ For details about the error codes, see [Bundle Error Codes](../errorcodes/errorc
**Example**
-```js
+```ts
import defaultAppMgr from '@ohos.bundle.defaultAppManager';
let userId = 100;
defaultAppMgr.resetDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, userId)
@@ -537,7 +529,7 @@ For details about the error codes, see [Bundle Error Codes](../errorcodes/errorc
**Example**
-```js
+```ts
import defaultAppMgr from '@ohos.bundle.defaultAppManager';
let userId = 100;
defaultAppMgr.resetDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, userId, (err, data) => {
diff --git a/en/application-dev/reference/apis/js-apis-distributedBundle.md b/en/application-dev/reference/apis/js-apis-distributedBundle.md
index 98a15d818444aac4bd9c57e0eb270c7a3c36fbe0..2ddd4b91388067d0b301f8d7ba26bbf748eb15cb 100644
--- a/en/application-dev/reference/apis/js-apis-distributedBundle.md
+++ b/en/application-dev/reference/apis/js-apis-distributedBundle.md
@@ -1,4 +1,4 @@
-# distributedBundle
+# @ohos.bundle.distributedBundle
The **distributedBundle** module provides APIs for managing distributed bundles.
diff --git a/en/application-dev/reference/apis/js-apis-freeInstall.md b/en/application-dev/reference/apis/js-apis-freeInstall.md
index 44ecb706ffc98b8f7937574d3ab18812b76abece..94ab3e8ac8cad4c8a41a4820741e595535f388a3 100644
--- a/en/application-dev/reference/apis/js-apis-freeInstall.md
+++ b/en/application-dev/reference/apis/js-apis-freeInstall.md
@@ -1,4 +1,4 @@
-# Bundle.freeInstall
+# @ohos.bundle.freeInstall
The **Bundle.freeInstall** module provides APIs for setting and obtaining installation-free information and APIs for obtaining **BundlePackInfo** and **DispatchInfo**.
diff --git a/en/application-dev/reference/apis/js-apis-installer.md b/en/application-dev/reference/apis/js-apis-installer.md
index 557e655b82ab9195e2217b69ed68e8d5de0ef534..0c3651fc6add2e830f9a8e3eeb5ccabddb122e2e 100644
--- a/en/application-dev/reference/apis/js-apis-installer.md
+++ b/en/application-dev/reference/apis/js-apis-installer.md
@@ -1,9 +1,8 @@
-# BundleInstaller
+# @ohos.bundle.installer
-The **BundleInstaller** module provides APIs for you to install, uninstall, and recover bundles on devices.
+The **bundle.installer** module provides APIs for you to install, uninstall, and recover bundles on devices.
> **NOTE**
->
> The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.
## Modules to Import
diff --git a/en/application-dev/reference/apis/js-apis-launcherBundleManager.md b/en/application-dev/reference/apis/js-apis-launcherBundleManager.md
index f149c30d7a93f9adaaa68c03edea7426a8882531..505c29ae0ef6cc18404767eaa4a4b4ac88296651 100644
--- a/en/application-dev/reference/apis/js-apis-launcherBundleManager.md
+++ b/en/application-dev/reference/apis/js-apis-launcherBundleManager.md
@@ -1,6 +1,6 @@
-# Bundle.launcherBundleManager
+# @ohos.bundle.launcherBundleManager
-The **Bundle.launcherBundleManager** module providers APIs for the **Home Screen** application to obtain the launcher ability information and shortcut information.
+The **bundle.launcherBundleManager** module providers APIs for the **Home Screen** application to obtain the launcher ability information and shortcut information.
> **NOTE**
>
@@ -27,7 +27,7 @@ Obtains the launcher ability information based on the given bundle name and user
**Parameters**
-| Name | Type | Mandatory| Description |
+| Name | Type | Mandatory| Description |
| ---------- | ------ | ---- | -------------- |
| bundleName | string | Yes | Bundle name of the application.|
| userId | number | Yes | User ID.|
@@ -78,7 +78,7 @@ Obtains the launcher ability information based on the given bundle name and user
**Parameters**
-| Name | Type | Mandatory| Description |
+| Name | Type | Mandatory| Description |
| ---------- | ------ | ---- | -------------- |
| bundleName | string | Yes | Bundle name of the application.|
| userId | number | Yes | User ID.|
@@ -128,7 +128,7 @@ Obtains the launcher ability information of all applications based on the given
**Parameters**
-| Name| Type | Mandatory| Description |
+| Name| Type | Mandatory| Description |
| ------ | ------ | ---- | -------------- |
| userId | number | Yes | User ID.|
@@ -176,7 +176,7 @@ Obtains the launcher ability information of all applications based on the given
**Parameters**
-| Name| Type | Mandatory| Description |
+| Name| Type | Mandatory| Description |
| ------ | ------ | ---- | -------------- |
| userId | number | Yes | User ID.|
@@ -222,7 +222,7 @@ Obtains the shortcut information of the current user based on the given bundle n
**System capability**: SystemCapability.BundleManager.BundleFramework.Launcher
-| Name | Type | Mandatory| Description |
+| Name | Type | Mandatory| Description |
| ---------- | ------ | ---- | -------------- |
| bundleName | string | Yes | Bundle name of the application.|
@@ -269,13 +269,13 @@ Obtains the shortcut information of the current user based on the given bundle n
**System capability**: SystemCapability.BundleManager.BundleFramework.Launcher
-| Name | Type | Mandatory| Description |
+| Name | Type | Mandatory| Description |
| ---------- | ------ | ---- | -------------- |
| bundleName | string | Yes | Bundle name of the application.|
**Return value**
-| Template | Description |
+| Type | Description |
| ---------------------- | ----------------------------------------------- |
| Promise\> | Promise used to return the **ShortcutInfo** object obtained.|
diff --git a/en/application-dev/reference/apis/js-apis-system-package.md b/en/application-dev/reference/apis/js-apis-system-package.md
index c6453ec28f1dca4749d8f8c91414a609af161466..3dec0fa1e2fd325479ac688443e67500d60f570b 100644
--- a/en/application-dev/reference/apis/js-apis-system-package.md
+++ b/en/application-dev/reference/apis/js-apis-system-package.md
@@ -1,9 +1,9 @@
-# Application Management
+# @system.package (Bundle Management)
-> ![icon-note.gif](public_sys-resources/icon-note.gif) **Noteļ¼**
+> **NOTE**
>
-> - The APIs of this module are no longer maintained since API version 7. It is recommended that you use [`@ohos.bundle`](js-apis-Bundle.md) instead.
+> - This module is deprecated since API version 9. You are advised to use [@ohos.bundle.bundleManager](js-apis-bundleManager.md) instead.
>
> - The initial APIs of this module are supported since API version 3. Newly added APIs will be marked with a superscript to indicate their earliest API version.
@@ -12,11 +12,12 @@
```
-import pkg from '@system.package';
+import package from '@system.package';
```
-## package.hasInstalled
+## package.hasInstalled(deprecated)
+> This API is deprecated since API version 9. You are advised to use [@ohos.bundle.bundleManager](js-apis-bundleManager.md) instead.
hasInstalled(Object): void
@@ -26,35 +27,57 @@ Checks whether an application exists, or whether a native application has been i
**System capability**: SystemCapability.BundleManager.BundleFramework
-**Parameter**
+**Parameters**
-| Name | Type | Mandatory | Description |
+| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
-| bundleName | string | Yes | Application bundle name |
-| success | Function | No | Called when the check result is obtained |
-| fail | Function | No | Called when the check result fails to be obtained |
-| complete | Function | No | Called when the execution is complete |
+|options | [CheckPackageHasInstalledOptions](#checkpackagehasinstalledoptions) | Yes| Options.|
-The following value will be returned when the check result is obtained.
+**Return value**
-| Name | Type | Description |
+| Name| Type| Description|
| -------- | -------- | -------- |
-| result | boolean | Whether the application exists, or whether the native application has been installed |
+| result | boolean | The value **true** means that the application exists or the native application has been installed, and **false** means the opposite.|
**Example**
-```
-export default {
- hasInstalled() {
- pkg.hasInstalled({
- bundleName: 'com.example.bundlename',
- success: function(data) {
- console.log('package has installed: ' + data);
- },
- fail: function(data, code) {
- console.log('query package fail, code: ' + code + ', data: ' + data);
- },
- });
+``` ts
+export default {
+ hasInstalled() {
+ package.hasInstalled({
+ bundleName: 'com.example.bundlename',
+ success: function(data) {
+ console.log('package has installed: ' + data);
+ },
+ fail: function(data, code) {
+ console.log('query package fail, code: ' + code + ', data: ' + data);
+ },
+ });
},
}
-```
\ No newline at end of file
+```
+
+## CheckPackageHasInstalledResponse
+
+> This API is deprecated since API version 9.
+
+Checks whether a bundle has been installed.
+
+**System capability**: SystemCapability.BundleManager.BundleFramework
+
+| Name| Type| Description|
+| --- | --- | ---- |
+| result | boolean | The value **true** means that the bundle has been installed, and **false** means the opposite.|
+
+## CheckPackageHasInstalledOptions
+
+> This API is deprecated since API version 9.
+
+Defines the options used for checking whether a bundle has been installed.
+
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| bundleName | string | Yes| Bundle name.|
+| success | Function | No| Called when API call is successful.|
+| fail | Function | No| Called when API call has failed.|
+| complete | Function | No| Called when API call is complete.|
diff --git a/en/application-dev/reference/apis/js-apis-zlib.md b/en/application-dev/reference/apis/js-apis-zlib.md
index bc2a9504185453888cf8ba53416f38a44519c5a2..aa7d700534b09bb582ca96d61740fdd6ff9681b9 100644
--- a/en/application-dev/reference/apis/js-apis-zlib.md
+++ b/en/application-dev/reference/apis/js-apis-zlib.md
@@ -1,4 +1,4 @@
-# zlib
+# @ohos.zlib
The **zlib** module provides APIs for file compression and decompression.
@@ -25,7 +25,7 @@ Zips a file. This API uses a promise to return the result.
| Name | Type | Mandatory| Description |
| ------- | ------------------- | ---- | ------------------------------------------------------------ |
-| inFile | string | Yes | Path of the folder or file to zip. For details about the path, see [FA Model](js-apis-Context.md) or [Stage Model](js-apis-application-context.md).|
+| inFile | string | Yes | Path of the folder or file to zip. For details about the path, see [FA Model](js-apis-inner-app-context.md) or [Stage Model](js-apis-application-context.md).|
| outFile | string | Yes | Path of the zipped file. The file name extension is .zip. |
| options | [Options](#options) | Yes | Optional parameters for the zip operation. |
@@ -89,7 +89,7 @@ Unzips a file. This API uses a promise to return the result.
| Name | Type | Mandatory| Description |
| ------- | ------------------- | ---- | ------------------------------------------------------------ |
-| inFile | string | Yes | Path of the folder or file to unzip. For details about the path, see [FA Model](js-apis-Context.md) or [Stage Model](js-apis-application-context.md).|
+| inFile | string | Yes | Path of the folder or file to unzip. For details about the path, see [FA Model](js-apis-inner-app-context.md) or [Stage Model](js-apis-application-context.md).|
| outFile | string | Yes | Path of the unzipped file. |
| options | [Options](#options) | Yes | Optional parameters for the unzip operation. |
@@ -131,7 +131,7 @@ Compresses a file. This API uses an asynchronous callback to return the result.
| Name | Type | Mandatory| Description |
| ----------------------- | ------------------- | ---- | ------------------------------------------------------------ |
-| inFile | string | Yes | Path of the folder or file to compress. For details about the path, see [FA Model](js-apis-Context.md) or [Stage Model](js-apis-application-context.md).|
+| inFile | string | Yes | Path of the folder or file to compress. For details about the path, see [FA Model](js-apis-inner-app-context.md) or [Stage Model](js-apis-application-context.md).|
| outFile | string | Yes | Path of the compressed file. |
| options | [Options](#options) | Yes | Compression parameters. |
| AsyncCallback<**void**> | callback | No | Callback used to return the result. If the operation is successful, **null** is returned; otherwise, a specific error code is returned. |
@@ -179,7 +179,7 @@ Compresses a file. This API uses a promise to return the result.
| Name | Type | Mandatory| Description |
| ------- | ------------------- | ---- | ------------------------------------------------------------ |
-| inFile | string | Yes | Path of the folder or file to compress. For details about the path, see [FA Model](js-apis-Context.md) or [Stage Model](js-apis-application-context.md).|
+| inFile | string | Yes | Path of the folder or file to compress. For details about the path, see [FA Model](js-apis-inner-app-context.md) or [Stage Model](js-apis-application-context.md).|
| outFile | string | Yes | Path of the compressed file. |
| options | [Options](#options) | Yes | Compression parameters. |
@@ -229,7 +229,7 @@ Decompresses a file. This API uses an asynchronous callback to return the result
| Name | Type | Mandatory| Description |
| ----------------------- | ------------------- | ---- | ------------------------------------------------------------ |
-| inFile | string | Yes | Path of the file to decompress. For details about the path, see [FA Model](js-apis-Context.md) or [Stage Model](js-apis-application-context.md).|
+| inFile | string | Yes | Path of the file to decompress. For details about the path, see [FA Model](js-apis-inner-app-context.md) or [Stage Model](js-apis-application-context.md).|
| outFile | string | Yes | Path of the decompressed file. |
| options | [Options](#options) | Yes | Decompression parameters. |
| AsyncCallback<**void**> | callback | No | Callback used to return the result. If the operation is successful, **null** is returned; otherwise, a specific error code is returned. |
@@ -278,7 +278,7 @@ Decompress a file. This API uses a promise to return the result.
| Name | Type | Mandatory| Description |
| ------- | ------------------- | ---- | ------------------------------------------------------------ |
-| inFile | string | Yes | Path of the file to decompress. For details about the path, see [FA Model](js-apis-Context.md) or [Stage Model](js-apis-application-context.md).|
+| inFile | string | Yes | Path of the file to decompress. For details about the path, see [FA Model](js-apis-inner-app-context.md) or [Stage Model](js-apis-application-context.md).|
| outFile | string | Yes | Path of the decompressed file. |
| options | [Options](#options) | Yes | Decompression parameters. |