This topic describes only module-specific error codes. For details about universal error codes, see Universal Error Codes.
Error Message
The specified bundle name is not found.
Description
When a query API is called, the bundle name passed in does not exist.
Possible Causes
Solution
Error Message
The specified module name is not found.
Description
When a query API or an installation-free API is called, the module name passed in does not exist.
Possible Causes
Solution
Error Message
The specified ability name is not found.
Description
When a query API is called, the ability name passed in does not exist.
Possible Causes
Solution
Error Message
The specified user ID is not found.
Description
When a user-related API is called, the user ID passed in does not exist.
Possible Causes
Solution
Error Message
The specified app ID is an empty string.
Description
When an API of the appControl module is called, the application ID passed in does not exist.
Possible Causes
appId is an empty string.
Solution
Check whether appId is an empty string.
Error Message
The specified permission is not found.
Description
When the getPermissionDef API of the bundleManager module is called, the permission passed in does not exist.
Possible Causes
Solution
Error Message
The specified device ID is not found.
Description
When an API of the distributedBundle module is called, the device ID passed in does not exist.
Possible Causes
Solution
Error Message
Failed to install the HAP because the HAP fails to be parsed.
Description
When the install API of the installer module is called, the HAP passed in fails to be parsed.
Possible Causes
Solution
Error Message
Failed to install the HAP because the HAP signature fails to be verified.
Description
Calling the install API of the installer module to install the bundle fails due to signature verification failure.
Possible Causes
Solution
Error Message
Failed to install the HAP because the HAP path is invalid or the HAP is too large.
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.
Possible Causes
Solution
Error Message
Failed to install the HAPs because they have different configuration information.
Description
Calling the install API of the installer module to install the bundle fails because the HAPs have different configuration information.
Possible Causes
The fields under app in the profiles of these HAPs are inconsistent.
Solution
Check whether the fields under app are the same.
Error Message
Failed to install the HAP because of insufficient system disk space.
Description
Calling the install API of the installer module to install the bundle fails due to insufficient system disk space.
Possible Causes
The system disk space is insufficient.
Solution
Check whether the system has sufficient disk space.
Error Message
Failed to install the HAP since the version of the HAP to install is too early.
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.
Possible Causes
The version number is earlier than the version in use.
Solution
Ensure that the version of the bundle to install is not earlier than the version in use.
Error Message
Failed to install the HAP or HSP because the dependent module does not exist.
Description
The dependent module does not exist during the HAP or HPS installation.
Possible Causes
The dependent module is not installed.
Solution
Install the dependent modules first.
Error Message
The preinstalled app cannot be uninstalled.
Description
Calling the uninstall API of the installer module to uninstall a preinstalled application fails.
Possible Causes
Solution
Error Message
The specified uid is invalid.
Description
When the getBundleNameByUid API of the bundleManager module is called, the UID passed in is invalid.
Possible Causes
Solution
Error Message
The input source file is invalid.
Description
When the getBundleArchiveInfo API of the bundleManager module is called, the HAP path passed in is invalid.
Possible Causes
Solution
Error Message
The specified default app does not exist.
Description
When the getDefaultApplication API of the defaultAppManager module is called, the specified default application does not exist.
Possible Causes
No default application is set for the device.
Solution
Check whether the default application is set on the device.
Error Message
Failed to get the profile because the specified profile is not found in the HAP.
Description
When an API for querying the profile is called, the profile does not exist.
Possible Causes
Solution
Error Message
The specified type is invalid.
Description
When an API of the defaultAppManager module is called, the type passed in is invalid.
Possible Causes
Solution
Error Message
The specified bundle is disabled.
Description
When an API for querying bundle information is called, the specified bundle is disabled.
Possible Causes
The bundle on the device has been disabled and cannot be queried.
Solution
Check whether the bundle on the device is disabled.
Error Message
The distributed service is not running.
Description
When an API of the distributedBundle module is called, the distributed service is not started.
Possible Causes
The device is not networked.
Solution
Check whether the device is networked.
Error Message
The ability does not match the type.
Description
When the setDefaultApplication API of the defaultAppManager module is called, the ability and type passed in do not match.
Possible Causes
The ability and type are misspelled.
Solution
Check whether the spellings of ability and type are correct.
Error Message
The specified ability is disabled.
Description
When an API for querying ability information is called, the specified ability is disabled.
Possible Causes
The specified ability is disabled.
Solution
Check whether the ability is disabled. You can use Bundle Manager to query the information.
Error Message
The specified bundle does not support clearing of cache files.
Description
When the cleanBundleCacheFiles API of the bundleManager module is called, the specified bundle does not support cache file clearing.
Possible Causes
The application is a system application and the AllowAppDataNotCleared field is configured in the signing certificate.
Solution
Error Message
Failed to install the HAP because the overlay check of the HAP 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
To use the overlay feature between applications, the following conditions must be met:
The application with the overlay feature must be a preset application.
Solution
Error Message
The specified bundle does not contain any overlay module.
Description
An API is called to obtain the overlayModuleInfo object of another application, but that application does not contain a module with the overlay feature.
Possible Causes
The specified application does not contain a module with the overlay feature.
Solution
Check whether the application contains a module with the overlay feature.
Error Message
The specified module is not an overlay module.
Description
An API is called to obtain the overlayModuleInfo object of a module, but the module is not configured with the overlay feature.
Possible Causes
The specified module is not a module with the overlay feature.
Solution
Check whether the module is configured with the overlay feature.
Error Message
The specified module is an overlay module.
Description
An API is called to obtain the overlayModuleInfo object based on the target module name, but that module is configured with the overlay feature.
Possible Causes
The specified module is configured with the overlay feature.
Solution
Check whether the specified module is configured with the overlay feature.
Error Message
The specified bundle is an overlay bundle.
Description
An API is called to obtain the overlayModuleInfo object based on the target module name of another application, but that application contains only modules with the overlay feature.
Possible Causes
The specified application contains only modules with the overlay feature.
Solution
Check whether the application contains only modules with the overlay feature.
Error Message
Failed to install the HAP because the installation is forbidden by enterprise device management.
Description
The installation of this application is prohibited by enterprise device management.
Possible Causes
The enterprise device management does not allow the installation of this application.
Solution
Check whether the application installation is prohibited by the enterprise device management.
Error Message
Failed to install the HAP because of incorrect URI in the data proxy.
Description
During application installation, the URI of the data proxy is incorrectly configured.
Possible Causes
Solution
Error Message
Failed to install the HAP because of low APL in the non-system data proxy (required APL: system_basic or system_core).
Description
During application installation, the permission level of the data proxy of a non-system application is too low. The permission level should be system_basic or system_core.
Possible Causes
Solution
Error Message
Failed to install the HAP because the isolationMode configured is not supported.
Description
During application installation, the value of isolationMode in the HAP conflicts with the isolation mode of the device.
Possible Causes
Solution
Set the isolationMode field in the HAP based on the isolation mode of the device.
Error Message
Failed to uninstall the HAP because the uninstall is forbidden by enterprise device management.
Description
The uninstall of this application is prohibited by enterprise device management.
Possible Causes
The enterprise device management does not allow the installation of this application.
Solution
Check whether the application uninstall is prohibited by the enterprise device management.
Error Message
Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode.
Description
The version of the application to be updated is not later than the current version.
Possible Causes
Solution
Error Message
Failed to install the HAP because the code signature verification failed.
Description
During application installation, the code signature file of the installation package fails to be verified.
Possible Causes
Solution
Error Message
Failed to install the HAP because the bundleName is different from the bundleName of the caller application.
Description
During the update of an enterprise MDM application, the bundleName passed in is different from that of the caller.
Possible Causes
The HAP or HSP to be installed does not belong to the current application.
Solution
Ensure that the HAP or HSP to be installed belongs to the current application.
Error Message
Failed to install the HAP because an enterprise normal/MDM bundle cannot be installed on non-enterprise devices.
Description
Users try to install an enterprise Normal or MDM application on a non-enterprise device.
Possible Causes
The device is not an enterprise device.
Solution
Use an enterprise device.
Ensure that const.bms.allowenterprisebundle is set to true.
Error Message
Failed to install the HAP because the distribution type of the caller application is not enterprise_mdm.
Description
During the update of an enterprise MDM application, the distribution type of the caller is not enterprise MDM.
Possible Causes
The distribution type of the caller is not enterprise MDM.
Solution
Ensure that the signature file of the application is correctly configured.
Error Message
Failed to install the HAP because a debug bundle can be installed only in developer mode.
Description
A debugging application can be installed only in the developer mode.
Possible Causes
The application is a debugging application, but the device is not in developer mode.
Solution
Run the hdc shell param get const.security.developermode.state command. If false is returned, a debugging application cannot be installed on the device.
Error Message
The caller is not AppGallery.
Description
This API is called by AppGallery.
Possible Causes
The caller is not AppGallery.
Solution
Use AppGallery to call the API.
Error Message
Failed to install the HAP because the HAP requests wrong permissions.
Description
The application has applied for an incorrect permission, causing the installation to fail.
Possible Causes
Solution
Error Message
The specified link is invalid.
Description
When the canOpenLink API of the bundleManager module is called, the link passed in is invalid.
Possible Causes
The format of the link is incorrect.
Solution
Check whether the link format is correct.
Error Message
The scheme of the specified link is not in the querySchemes.
Description
When the canOpenLink API of the bundleManager module is called, the scheme of the link is not configured in the querySchemes field.
Possible Causes
The scheme of the link is not configured in the querySchemes field.
Solution
Check whether the URL scheme is configured in the querySchemes field.
Error Message
Failed to uninstall updates because the HAP is not pre-installed.
Description
When the uninstallUpdates API of the installer module is called, the specified application is not a preset application.
Possible Causes
The uninstallUpdates API can only be used to uninstall the updates of a preset application.
Solution
Check whether the specified application is a preset application.
Error Message
The specified developerId is invalid.
Description
When the getAllBundleInfoByDeveloperId API of the bundleManager module is called, the developer ID passed in is invalid.
Possible Causes
Applications with the specified developer ID are not installed on the device.
Solution
Check the validity of the developer ID.
Error Message
The specified application cannot be uninstalled.
Description
When the uninstall API of the BundleInstaller module or the switchUninstallState API of the bundleManager module is called, the specified application cannot be uninstalled.
Possible Causes
Solution
Error Message
The appIndex is invalid.
Description
When an API related to the app clone feature is called, the specified appIndex is invalid.
Possible Causes
Solution
Error Message
The ability specified by want in the ShortcutInfo struct cannot be started.
Description
When the startShortcut API of the launcherBundleManager module is called, the ability specified by want in the ShortcutInfo struct fails to start.
Possible Causes
The ability specified by want in the ShortcutInfo struct does not exist, or the ability specified by want in the ShortcutInfo struct cannot be started.
Solution
Check the validity of want in the ShortcutInfo struct.
Error Message
The app does not support the creation of an appClone instance.
Description
An AppClone instance cannot be created for an application that is not in appClone mode.
Possible Causes
The multi-app mode is set to another mode other than appClone.
Solution
Check whether the application to update supports clones.
Error Message
The specified shortcut id is illegal.
Description
The specified shortcut ID is invalid.
Possible Causes
When the API for adding a shortcut is called, a shortcut with the same bundle name, clone index, user ID, and shortcut ID already exists, or the passed-in shortcut ID is empty.
Solution
Check whether the bundle name and shortcut ID are correct.
Error Message
It is not allowed to install the enterprise bundle.
Description
It is not allowed to install enterprise applications through a specific installation API.
Possible Causes
Due to policy control, enterprise applications cannot be installed through the specific API.
Error Message
Bundle manager service is excepted.
Description
The Bundle Manager service is abnormal.
Possible Causes
An unknown system exception occurs.
Solution
Restart the phone and try again.
If the request still fails after the preceding steps are performed for three to five times, check whether a crash file containing foundation exists in the /data/log/faultlog/faultlogger/ directory of the device.
hdc shell cd /data/log/faultlog/faultlogger/ ls -ls
hdc file recv /data/log/faultlog/faultlogger/ hdc file recv /data/log/hilog/
Error Message
Failed to verify the abc file.
Description
Failed to verify the .abc file.
Possible Causes
The .abc file is untrusted.
Solution
Pass in the path of a trusted .abc file.
Error Message
Failed to delete the abc file.
Description
Failed to delete the .abc file.
Possible Causes
The .abc file does not exist.
Solution
Pass in a valid path of the .abc file.
Error Message
Failed to add extended resources.
Description
Failed to add the extended resources.
Possible Causes
The .hsp file does not exist or is untrusted.
Solution
Pass in a correct and trusted .hsp file path.
Error Message
Failed to remove extended resources.
Description
Failed to delete the extended resources.
Possible Causes
The HSP corresponding to the module name does not exist.
Solution
Pass in a valid module name.
Error Message
Failed to obtain extended resources.
Description
Failed to obtain the extended resources.
Possible Causes
The HSP corresponding to the bundle name does not exist.
Solution
Pass in a valid bundle name.
Error Message
Failed to enable the dynamic icon.
Description
Failed to enable the dynamic icon.
Possible Causes
The HSP does not contain the correct icon resource.
Solution
Before enabling the dynamic icon, ensure that the HSP corresponding to the module name is valid and contains the icon resource.
Error Message
Failed to disable the dynamic icon.
Description
Failed to disable the dynamic icon.
Possible Causes
The HSP does not contain the correct icon resource.
Solution
Before disabling the dynamic icon, ensure that the HSP corresponding to the bundle name contains the icon resource.
Error Message
Failed to obtain the dynamic icon.
Description
Failed to obtain the dynamic icon.
Possible Causes
The HSP does not contain the correct icon resource.
Solution
Before querying the dynamic icon, ensure that the HSP corresponding to the bundle name contains the icon resource.