> This API is deprecated since API version 9. You are advised to use [bundleManager.getAllBundleInfo](js-apis-bundleManager.md#bundlemanagergetallbundleinfo) instead.
> This API is deprecated since API version 9. You are advised to use [bundleManager.getAllBundleInfo](js-apis-bundleManager.md#bundlemanagergetallbundleinfo) instead.
> This API is deprecated since API version 9. You are advised to use [bundleManager.getAllBundleInfo](js-apis-bundleManager.md#bundlemanagergetallbundleinfo) instead.
> This API is deprecated since API version 9. You are advised to use [bundleManager.getAllBundleInfo](js-apis-bundleManager.md#bundlemanagergetallbundleinfo) instead.
> This API is deprecated since API version 9. You are advised to use [bundleManager.getAllBundleInfo](js-apis-bundleManager.md#bundlemanagergetallbundleinfo) instead.
> This API is deprecated since API version 9. You are advised to use [bundleManager.getAllBundleInfo](js-apis-bundleManager.md#bundlemanagergetallbundleinfo) instead.
> This API is deprecated since API version 9. You are advised to use [bundleManager.getAllApplicationInfo](js-apis-bundleManager.md#bundlemanagergetallapplicationinfo) instead.
> This API is deprecated since API version 9. You are advised to use [bundleManager.getAllApplicationInfo](js-apis-bundleManager.md#bundlemanagergetallapplicationinfo) instead.
> This API is deprecated since API version 9. You are advised to use [bundleManager.getAllApplicationInfo](js-apis-bundleManager.md#bundlemanagergetallapplicationinfo) instead.
> This API is deprecated since API version 9. You are advised to use [bundleManager.getAllApplicationInfo](js-apis-bundleManager.md#bundlemanagergetallapplicationinfo) instead.
> This API is deprecated since API version 9. You are advised to use [bundleManager.queryAbilityInfo](js-apis-bundleManager.md#bundlemanagerqueryabilityinfo) instead.
> This API is deprecated since API version 9. You are advised to use [bundleManager.queryAbilityInfo](js-apis-bundleManager.md#bundlemanagerqueryabilityinfo) instead.
> This API is deprecated since API version 9. You are advised to use [bundleManager.queryAbilityInfo](js-apis-bundleManager.md#bundlemanagerqueryabilityinfo) instead.
> This API is deprecated since API version 9. You are advised to use [bundleManager.queryAbilityInfo](js-apis-bundleManager.md#bundlemanagerqueryabilityinfo) instead.
> This API is deprecated since API version 9. You are advised to use [bundleManager.queryAbilityInfo](js-apis-bundleManager.md#bundlemanagerqueryabilityinfo) instead.
> This API is deprecated since API version 9. You are advised to use [bundleManager.queryAbilityInfo](js-apis-bundleManager.md#bundlemanagerqueryabilityinfo) instead.
Obtains the JSON strings of the configuration file based on the given module ame, ability name, and metadata name. This API uses an asynchronous callback to return the result.
Obtains the JSON strings of the configuration file based on the given module ame, ability name, and metadata name. This API uses an asynchronous callback to return the result.
Obtains the JSON strings of the configuration file based on the given module ame, ability name, and metadata name. This API uses a promise to return the result.
Obtains the JSON strings of the configuration file based on the given module ame, ability name, and metadata name. This API uses a promise to return the result.
Obtains the JSON strings of the configuration file based on the given module ame, Extension ability name, and metadata name. This API uses an asynchronous callback to return the result.
Obtains the JSON strings of the configuration file based on the given module ame, Extension ability name, and metadata name. This API uses an asynchronous callback to return the result.
Obtains the JSON strings of the configuration file based on the given module ame, Extension ability name, and metadata name. This API uses a promise to return the result.
Obtains the JSON strings of the configuration file based on the given module ame, Extension ability name, and metadata name. This API uses a promise to return the result.
| userId | number | Yes | User ID. You can use [queryOsAccountLocalIdFromProcess](js-apis-osAccount.md#queryosaccountlocalidfromprocess9) to obtain the user of the current process.|
| userId | number | Yes | User ID. You can use [queryOsAccountLocalIdFromProcess](js-apis-osAccount.md#getOsAccountLocalId) to obtain the user of the current process.|
| installFlag | number | Yes | Installation flag. The value **0** means initial installation and **1** means overwrite installation.|
| installFlag | number | Yes | Installation flag. The value **0** means initial installation and **1** means overwrite installation.|
| isKeepData | boolean | Yes | Whether to retain the data directory during bundle uninstall.|
| isKeepData | boolean | Yes | Whether to retain the data directory during bundle uninstall.|
When a query API is called, the bundle name passed in does not exist.
When a query API is called, the bundle name passed in does not exist.
**Possible Causes**
**Possible Causes**
...
@@ -14,15 +16,18 @@ When a query API is called, the bundle name passed in does not exist.
...
@@ -14,15 +16,18 @@ When a query API is called, the bundle name passed in does not exist.
2. The corresponding bundle is not installed.
2. The corresponding bundle is not installed.
**Solution**
**Solution**
1. Check whether the spelling of the bundle name is correct.
1. Check whether the spelling of the bundle name is correct.
2. Check whether the corresponding bundle is installed.
2. Check whether the corresponding bundle is installed.
## 17700002 Module Name Does Not Exist
## 17700002 Module Name Does Not Exist
**Error Message**
**Error Message**
The specified module name is not found.
The specified module name is not found.
**Description**
**Description**
When a query API or an installation-free API is called, the module name passed in does not exist.
When a query API or an installation-free API is called, the module name passed in does not exist.
**Possible Causes**
**Possible Causes**
...
@@ -36,9 +41,11 @@ When a query API or an installation-free API is called, the module name passed i
...
@@ -36,9 +41,11 @@ When a query API or an installation-free API is called, the module name passed i
## 17700003 Ability Name Does Not Exist
## 17700003 Ability Name Does Not Exist
**Error Message**
**Error Message**
The specified ability name is not found.
The specified ability name is not found.
**Description**
**Description**
When a query API is called, the ability name passed in does not exist.
When a query API is called, the ability name passed in does not exist.
**Possible Causes**
**Possible Causes**
...
@@ -52,9 +59,11 @@ When a query API is called, the ability name passed in does not exist.
...
@@ -52,9 +59,11 @@ When a query API is called, the ability name passed in does not exist.
## 17700004 User ID Does Not Exist
## 17700004 User ID Does Not Exist
**Error Message**
**Error Message**
The specified user ID is not found.
The specified user ID is not found.
**Description**
**Description**
When a user-related API is called, the user ID passed in does not exist.
When a user-related API is called, the user ID passed in does not exist.
**Possible Causes**
**Possible Causes**
...
@@ -68,23 +77,29 @@ When a user-related API is called, the user ID passed in does not exist.
...
@@ -68,23 +77,29 @@ When a user-related API is called, the user ID passed in does not exist.
## 17700005 appId Is an Empty String
## 17700005 appId Is an Empty String
**Error Message**
**Error Message**
The specified app ID is empty string.
The specified app ID is empty string.
**Description**
**Description**
When an API of the **appControl** module is called, the application ID passed in does not exist.
When an API of the **appControl** module is called, the application ID passed in does not exist.
**Possible Causes**
**Possible Causes**
**appId** is an empty string.
**appId** is an empty string.
**Solution**
**Solution**
Check whether **appId** is an empty string.
Check whether **appId** is an empty string.
## 17700006 Permission Does Not Exist
## 17700006 Permission Does Not Exist
**Error Message**
**Error Message**
The specified permission is not found.
The specified permission is not found.
**Description**
**Description**
When the **getPermissionDef** API of the **bundleManager** module is called, the permission passed in does not exist.
When the **getPermissionDef** API of the **bundleManager** module is called, the permission passed in does not exist.
**Possible Causes**
**Possible Causes**
...
@@ -98,9 +113,11 @@ When the **getPermissionDef** API of the **bundleManager** module is called, the
...
@@ -98,9 +113,11 @@ When the **getPermissionDef** API of the **bundleManager** module is called, the
## 17700007 Incorrect Device ID
## 17700007 Incorrect Device ID
**Error Message**
**Error Message**
The specified device ID is not found.
The specified device ID is not found.
**Description**
**Description**
When an API of the **distributedBundle** module is called, the device ID passed in does not exist.
When an API of the **distributedBundle** module is called, the device ID passed in does not exist.
**Possible Causes**
**Possible Causes**
...
@@ -108,23 +125,28 @@ When an API of the **distributedBundle** module is called, the device ID passed
...
@@ -108,23 +125,28 @@ When an API of the **distributedBundle** module is called, the device ID passed
2. The device ID does not exist.
2. The device ID does not exist.
**Solution**
**Solution**
1. Check whether the device ID is correct.
1. Check whether the device ID is correct.
2. Check whether the device ID exists.
2. Check whether the device ID exists.
## 17700010 Bundle Installation Failure Due to File Parsing Failure
## 17700010 Bundle Installation Failure Due to File Parsing Failure
**Error Message**
**Error Message**
Failed to install the HAP because the HAP fails to be parsed.
Failed to install the HAP because the HAP fails to be parsed.
**Description**
**Description**
When the **install** API of the **installer** module is called, the HAP passed in fails to be parsed.
When the **install** API of the **installer** module is called, the HAP passed in fails to be parsed.
**Possible Causes**
**Possible Causes**
1. The HAP is not in ZIP format.
1. The HAP is not in ZIP format.
2. The configuration file in the HAP is not in JSON format.
2. The configuration file in the HAP is not in JSON format.
3. Necessary fields are missing in the configuration file.
3. Necessary fields are missing in the configuration file.
**Solution**
**Solution**
1. Check whether the HAP is in ZIP format.
1. Check whether the HAP is in ZIP format.
2. Check whether the configuration file is in [JSON format](../../quick-start/application-configuration-file-overview-stage.md).
2. Check whether the configuration file is in [JSON format](../../quick-start/application-configuration-file-overview-stage.md).
3. Check whether an error message is displayed when DevEco Studio compiles the HAP. If necessary fields are missing, an error message will be displayed.
3. Check whether an error message is displayed when DevEco Studio compiles the HAP. If necessary fields are missing, an error message will be displayed.
...
@@ -132,9 +154,11 @@ When the **install** API of the **installer** module is called, the HAP passed i
...
@@ -132,9 +154,11 @@ When the **install** API of the **installer** module is called, the HAP passed i
## 17700011 Bundle Installation Failure Due to Signature Verification Failure
## 17700011 Bundle Installation Failure Due to Signature Verification Failure
**Error Message**
**Error Message**
Failed to install the HAP because the HAP signature fails to be verified.
Failed to install the HAP because the HAP signature fails to be verified.
**Description**
**Description**
Calling the **install** API of the **installer** module to install the bundle fails due to signature verification failure.
Calling the **install** API of the **installer** module to install the bundle fails due to signature verification failure.
**Possible Causes**
**Possible Causes**
...
@@ -153,9 +177,11 @@ Calling the **install** API of the **installer** module to install the bundle fa
...
@@ -153,9 +177,11 @@ Calling the **install** API of the **installer** module to install the bundle fa
## 17700012 Bundle Installation Failure Due to Invalid File Path or Too Large File
## 17700012 Bundle Installation Failure Due to Invalid File Path or Too Large File
**Error Message**
**Error Message**
Failed to install the HAP because the HAP path is invalid or the HAP is too large.
Failed to install the HAP because the HAP path is invalid or the HAP is too large.
**Description**
**Description**
Calling the **install** API of the **installer** module to install the bundle fails because the HAP path is invalid or the HAP is too large.
Calling the **install** API of the **installer** module to install the bundle fails because the HAP path is invalid or the HAP is too large.
**Possible Causes**
**Possible Causes**
...
@@ -171,51 +197,65 @@ Calling the **install** API of the **installer** module to install the bundle fa
...
@@ -171,51 +197,65 @@ Calling the **install** API of the **installer** module to install the bundle fa
## 17700015 Bundle Installation Failure Due to Different Configuration Information of Multiple HAPs
## 17700015 Bundle Installation Failure Due to Different Configuration Information of Multiple HAPs
**Error Message**
**Error Message**
Failed to install the HAPs because they have different configuration information.
Failed to install the HAPs because they have different configuration information.
**Description**
**Description**
Calling the **install** API of the **installer** module to install the bundle fails because the HAPs have different configuration information.
Calling the **install** API of the **installer** module to install the bundle fails because the HAPs have different configuration information.
**Possible Causes**
**Possible Causes**
The fields under **app** in the configuration files of these HAPs are inconsistent.
The fields under **app** in the configuration files of these HAPs are inconsistent.
**Solution**
**Solution**
Check whether the fields under **app** are the same.
Check whether the fields under **app** are the same.
## 17700016 Bundle Installation Failure Due to Insufficient System Disk Space
## 17700016 Bundle Installation Failure Due to Insufficient System Disk Space
**Error Message**
**Error Message**
Failed to install the HAP because of insufficient system disk space.
Failed to install the HAP because of insufficient system disk space.
**Description**
**Description**
Calling the **install** API of the **installer** module to install the bundle fails due to insufficient system disk space.
Calling the **install** API of the **installer** module to install the bundle fails due to insufficient system disk space.
**Possible Causes**
**Possible Causes**
The system disk space is insufficient.
The system disk space is insufficient.
**Solution**
**Solution**
Check whether the system has sufficient disk space.
Check whether the system has sufficient disk space.
## 17700017 Bundle Installation Failure Because the Version to Install is Too Earlier
## 17700017 Bundle Installation Failure Because the Version to Install is Too Earlier
**Error Message**
**Error Message**
Failed to install the HAP since the version of the HAP to install is too early.
Failed to install the HAP since the version of the HAP to install is too early.
**Description**
**Description**
Calling the **install** API of the **installer** module to install the bundle fails because the version to install is earlier than the version in use.
Calling the **install** API of the **installer** module to install the bundle fails because the version to install is earlier than the version in use.
**Possible Causes**
**Possible Causes**
The version number is earlier than the version in use.
The version number is earlier than the version in use.
**Solution**
**Solution**
Ensure that the version of the bundle to install is not earlier than the version in use.
Ensure that the version of the bundle to install is not earlier than the version in use.
## 17700020 Failure to Uninstall Preinstalled Applications
## 17700020 Failure to Uninstall Preinstalled Applications
**Error Message**
**Error Message**
The preinstalled app cannot be uninstalled.
The preinstalled app cannot be uninstalled.
**Description**
**Description**
Calling the **uninstall** API of the **installer** module to uninstall a preinstalled application fails.
Calling the **uninstall** API of the **installer** module to uninstall a preinstalled application fails.
**Possible Causes**
**Possible Causes**
...
@@ -229,9 +269,11 @@ Calling the **uninstall** API of the **installer** module to uninstall a preinst
...
@@ -229,9 +269,11 @@ Calling the **uninstall** API of the **installer** module to uninstall a preinst
## 17700021 Invalid UID
## 17700021 Invalid UID
**Error Message**
**Error Message**
The specified uid is invalid.
The specified uid is invalid.
**Description**
**Description**
When the **getBundleNameByUid** API of the **bundleManager** module is called, the UID passed in is invalid.
When the **getBundleNameByUid** API of the **bundleManager** module is called, the UID passed in is invalid.
**Possible Causes**
**Possible Causes**
...
@@ -245,9 +287,11 @@ When the **getBundleNameByUid** API of the **bundleManager** module is called, t
...
@@ -245,9 +287,11 @@ When the **getBundleNameByUid** API of the **bundleManager** module is called, t
## 17700022 Invalid Source File
## 17700022 Invalid Source File
**Error Message**
**Error Message**
The input source file is invalid.
The input source file is invalid.
**Description**
**Description**
When the **getBundleArchiveInfo** API of the **bundleManager** module is called, the HAP path passed in is invalid.
When the **getBundleArchiveInfo** API of the **bundleManager** module is called, the HAP path passed in is invalid.
**Possible Causes**
**Possible Causes**
...
@@ -261,23 +305,29 @@ When the **getBundleArchiveInfo** API of the **bundleManager** module is called,
...
@@ -261,23 +305,29 @@ When the **getBundleArchiveInfo** API of the **bundleManager** module is called,
## 17700023 Default Application Does Not Exist
## 17700023 Default Application Does Not Exist
**Error Message**
**Error Message**
The specified default app does not exist.
The specified default app does not exist.
**Description**
**Description**
When the **getDefaultApplication** API of the **defaultAppManager** module is called, the specified default application does not exist.
When the **getDefaultApplication** API of the **defaultAppManager** module is called, the specified default application does not exist.
**Possible Causes**
**Possible Causes**
No default application is set for the device.
No default application is set for the device.
**Solution**
**Solution**
Check whether the default application is set on the device.
Check whether the default application is set on the device.
## 17700024 Configuration File Does Not Exist
## 17700024 Configuration File Does Not Exist
**Error Message**
**Error Message**
Failed to get the profile because there is no profile in the HAP.
Failed to get the profile because there is no profile in the HAP.
**Description**
**Description**
When an API for querying the profile is called, the configuration file does not exist
When an API for querying the profile is called, the configuration file does not exist
**Possible Causes**
**Possible Causes**
...
@@ -291,9 +341,11 @@ When an API for querying the profile is called, the configuration file does not
...
@@ -291,9 +341,11 @@ When an API for querying the profile is called, the configuration file does not
## 17700025 Invalid Type
## 17700025 Invalid Type
**Error Message**
**Error Message**
The specified type is invalid.
The specified type is invalid.
**Description**
**Description**
When an API of the **defaultAppManager** module is called, the type passed in is invalid.
When an API of the **defaultAppManager** module is called, the type passed in is invalid.
**Possible Causes**
**Possible Causes**
...
@@ -307,71 +359,113 @@ When an API of the **defaultAppManager** module is called, the type passed in is
...
@@ -307,71 +359,113 @@ When an API of the **defaultAppManager** module is called, the type passed in is
## 17700026 Bundle Disabled
## 17700026 Bundle Disabled
**Error Message**
**Error Message**
The specified bundle is disabled.
The specified bundle is disabled.
**Description**
**Description**
When an API for querying bundle information is called, the specified bundle is disabled.
When an API for querying bundle information is called, the specified bundle is disabled.
**Possible Causes**
**Possible Causes**
The bundle on the device has been disabled and cannot be queried.
The bundle on the device has been disabled and cannot be queried.
**Solution**
**Solution**
Check whether the bundle on the device is disabled.
Check whether the bundle on the device is disabled.
## 17700027 Distributed Service Is Not Started
## 17700027 Distributed Service Is Not Started
**Error Message**
**Error Message**
The distributed service is not running.
The distributed service is not running.
**Description**
**Description**
When an API of the **distributedBundle** module is called, the distributed service is not started.
When an API of the **distributedBundle** module is called, the distributed service is not started.
**Possible Causes**
**Possible Causes**
The device is not networked.
The device is not networked.
**Solution**
**Solution**
Check whether the device is networked.
Check whether the device is networked.
## 17700028 Mismatch Between Ability and Type
## 17700028 Mismatch Between Ability and Type
**Error Message**
**Error Message**
The ability does not match the type.
The ability does not match the type.
**Description**
**Description**
When the **setDefaultApplication** API of the **defaultAppManager** module is called, the **ability** and **type** passed in do not match.
When the **setDefaultApplication** API of the **defaultAppManager** module is called, the **ability** and **type** passed in do not match.
**Possible Causes**
**Possible Causes**
The ability and type are misspelled.
The ability and type are misspelled.
**Solution**
**Solution**
Check whether the spellings of ability and type are correct.
Check whether the spellings of ability and type are correct.
## 17700029 Disabled Ability
## 17700029 Disabled Ability
**Error Message**
**Error Message**
The specified ability is disabled.
The specified ability is disabled.
**Description**
**Description**
When an API for querying ability information is called, the specified ability is disabled.
When an API for querying ability information is called, the specified ability is disabled.
**Possible Causes**
**Possible Causes**
The specified ability is disabled.
The specified ability is disabled.
**Solution**
**Solution**
Check whether the ability is disabled. You can run the [bm commands](../../../readme/bundle-management.md#bm-commands) to query the information.
Check whether the ability is disabled. You can run the [bm commands](../../../readme/bundle-management.md#bm-commands) to query the information.
## 17700030 Failure in Clearing Cache Files
## 17700030 Failure in Clearing Cache Files
**Error Message**
**Error Message**
The specified bundle does not support clearing of cache files.
The specified bundle does not support clearing of cache files.
**Description**
**Description**
When the **cleanBundleCacheFiles** API of the **bundleManager** module is called, the specified bundle does not support cache file clearing.
When the **cleanBundleCacheFiles** API of the **bundleManager** module is called, the specified bundle does not support cache file clearing.
**Possible Causes**
**Possible Causes**
The application is a system application and the **AllowAppDataNotCleared** field is configured in the signing certificate.
The application is a system application and the **AllowAppDataNotCleared** field is configured in the signing certificate.
**Solution**
**Solution**
1. Check whether the application is a system application. You can run the [bm commands](../../../readme/bundle-management.md#bm-commands) to query the application information and check whether the value of **isSystemApp** is **true**.
1. Check whether the application is a system application. You can run the [bm commands](../../../readme/bundle-management.md#bm-commands) to query the application information and check whether the value of **isSystemApp** is **true**.
2. Check whether the **AllowAppDataNotCleared field** is configured for the application. You can run the [bm commands](../../../readme/bundle-management.md#bm-commands) to query the application information and check whether the value of **userDataClearable** is **true**.
2. Check whether the **AllowAppDataNotCleared field** is configured for the application. You can run the [bm commands](../../../readme/bundle-management.md#bm-commands) to query the application information and check whether the value of **userDataClearable** is **true**.
<!--no_check-->
## 17700031 HAP Installation Fails Due to Overlay Feature Verification Failure
**Error Message**
Failed to install the HAP because the overlay check of the HAP is failed.
**Description**
The target application and the to-be-installed application with the overlay feature are not preset applications, or the target application or target module is one with the overlay feature.
**Possible Causes**
1. To use the overlay feature between applications, the following conditions must be met:<br>The application with the overlay feature must be a preset application.
2. The target application must be a preset application.
3. The target application cannot be an application with the overlay feature.
4. The target module cannot be a module with the overlay feature.
**Solution**
1. Ensure that the application with the overlay feature is a preset application.
2. Ensure that the target application is a preset application.
3. Ensure that the target application is not an application with the overlay feature.
4. Ensure that the target module is not a module with the overlay feature.