This topic describes only module-specific error codes. For details about universal error codes, see Universal Error Codes.
Error Message
The specified ability does not exist.
Description
This error code is reported when the specified ability name does not exist.
Possible Causes
The ability to query does not exist.
Solution
hdc shell bm dump -a
hdc shell bm dump -n bundleName
Error Message
Incorrect Ability type.
Description
This error code is reported when the ability type invoked by the API is incorrect.
Possible Causes
The ability with the specified type does not support the API call.
Solution
Error Message
Id does not exist.
Description
This error code is reported when the specified ID does not exist.
Possible Causes
The target with the specified ID does not exist.
Solution
Use the correct ID.
Error Message
Can not start invisible component.
Description
This error code is reported when the application fails visibility verification.
Possible Causes
Visibility verification fails.
Solution
Error Message
The specified process does not have the permission.
Description
This error code is reported when the specified process fails permission verification.
Possible Causes
Permission verification for the specified process fails.
Solution
Check whether the permission of the specified process is correct.
Error Message
Cross-user operations are not allowed.
Description
This error code is reported when an application tries to perform a cross-user operation.
Possible Causes
The application initiates a cross-user operation.
Solution
Do not perform a cross-user operation.
Error Message
Service busy, there are concurrent tasks, waiting for retry.
Description
This error code is reported when the service requested is busy.
Possible Causes
The service is busy.
Solution
Try again later.
Error Message
The crowdtesting application expires.
Description
This error code is reported when users try to open a crowdtesting application that has expired.
Possible Causes
The crowdtesting application has expired.
Solution
Expired crowdtesting applications cannot be started.
Error Message
An ability cannot be started or stopped in Wukong mode.
Description
This error code is returned when the application tries to start or stop an ability in Wukong mode.
Possible Causes
An ability cannot be started or stopped in Wukong mode.
Solution
Exit Wukong mode, and then start or stop the ability.
Error Message
The call with the continuation flag is forbidden.
Description
This error code is reported when the API call carries the continuation flag.
Possible Causes
The continuation flag is not allowed for the API call.
Solution
Remove the continuation flag.
Error Message
The context does not exist.
Description
This error code is reported when the specified context does not exist.
Possible Causes
The context passed in the API does not exist.
Solution
Use the correct context.
Error Message
The application is controlled.
Description
This error code is reported when an application is controlled by the application market.
Possible Causes
The application is suspected to have malicious behavior and is not allowed to start due to application market control.
Solution
It is recommended that end users uninstall the application.
Error Message
The application is controlled by EDM.
Description
This error code is reported when an application is controlled by Enterprise Device Manager (EDM).
Possible Causes
The application is controlled by EDM.
Solution
Contact the enterprise device management personnel.
Error Message
Service timeout.
Description
This error code is reported when the service requested times out.
Possible Causes
The service times out.
Solution
Try again later.
Error Message
The previous ability is starting, wait start later.
Description
Too many abilities need to be started. Due to the limited processing capability of the system, the requests are cached in the queue and processed in sequence.
Possible Causes
The system has a large number of concurrent requests.
Solution
No action is required. Wait for the previous abilities to finish startup.
Error Message
The application is not allow jumping to other applications when api version is above 11.
Description
When the API version of an application is later than 11, the application cannot be explicitly redirected to a third-party application.
Solution
Use implicit startup or openLink for redirection.
Error Message
Can not match any component.
Description
A matching ability is not found during implicit startup.
Possible Causes
Solution
Error Message
Internal error.
Description
This error code is reported when an error occurs during internal processing, such as memory application or multi-thread processing.
Possible Causes
Common kernel errors such as memory application and multi-thread processing errors occur. The possible causes are as follows: empty internal object, processing timeout, failure in obtaining application information, failing in obtaining the system service, and too many started ability instances.
Solution
Error Message
Network error.
Description
This error code is reported when the network is abnormal.
Possible Causes
The network is unavailable.
Solution
Try again later or reconnect to the network.
Error Message
Installation-free is not supported.
Description
This error code is reported when the application does not support installation-free.
Possible Causes
The application package does not meet the installation-free requirements. For example, the package is too large.
Solution
Check whether the application supports installation-free.
Error Message
The ability is not on the top of the UI.
Description
This error code is reported when the ability is not displayed on the top of the UI.
Possible Causes
During the installation-free startup process, the ability is not displayed on the top of the UI.
Solution
Ensure that the ability is displayed on the top of the UI.
Error Message
Installation-free service is busy, please wait and try again later.
Description
This error code is reported when the installation-free service is busy.
Possible Causes
A download and installation task is being executed for the atomic service.
Solution
Try again later.
Error Message
Installation-free timed out.
Description
This error code is reported when the installation-free task times out.
Possible Causes
Installation-free times out.
Solution
Try again later.
Error Message
Installation-free is not allowed for other applications.
Description
This error code is reported when users try to apply installation-free for other applications.
Possible Causes
Installation-free is allowed only for the current application.
Solution
Apply installation-free only for the current application.
Error Message
Cross-device installation-free is not supported.
Description
This error code is reported when users try to apply installation-free across devices.
Possible Causes
Cross-device installation-free is not supported.
Solution
Use installation-free on the same device.
Error Message
Invalid URI flag.
Description
This error code is reported when the specified URI flag is invalid.
Possible Causes
An incorrect parameter is passed in.
Solution
Pass in a valid URI flag.
Error Message
Invalid URI type.
Description
This error code is reported when the specified URI type is invalid.
Possible Causes
An incorrect parameter is passed in. Currently, URI authorization management supports only URIs of the file type.
Solution
Ensure that the input parameter is of the supported URI type.
Error Message
Sandbox application can not grant URI permission.
Description
This error code is reported when a sandbox application authorizes a URI.
Possible Causes
Sandbox applications cannot authorize URIs.
Solution
Use a non-sandbox application.
Error Message
Operation not supported.
Description
This error code is reported when an operation is not supported.
Possible Causes
The operation is not supported.
Solution
Perform a supported operation.
Error Message
The number of child process exceeds upper bound.
Description
This error code is reported when the number of created child processes reaches the upper limit.
Possible Causes
The number of created child processes has reached the upper limit.
Solution
Limit the number of created child processes. The maximum number is 512.
Error Message
The target to restart does not belong to the current app or is not a UIAbility.
Description
This error code is reported when the specified ability name or type is invalid during application restart.
Possible Causes
The specified ability name or type is invalid.
Solution
Ensure that the specified ability name exists in the current application and the ability type is UIAbility.
Error Message
Restart too frequently. Try again at least 10s later.
Description
An API is called to restart the application and start a specified ability. This error code is reported when the API is called again within 10 seconds.
Possible Causes
The API is frequently called.
Solution
Call the API again after 10 seconds.
Error Message
The interface can be called only when ability is foreground.
Description
This error code is reported when the API is called while the ability is not running in the foreground.
Possible Causes
The ability is not in the foreground when the API is called.
Solution
Switch the ability to the foreground before calling the API.
Error Message
An ability cannot move to foreground or background in Wukong mode.
Description
This error code is reported when the API used to switch the ability to the foreground or background is called in Wukong mode.
Possible Causes
In Wukong mode, the ability cannot be switched to the foreground or background.
Solution
Exit wukong mode, and then call the API to switch the ability to the foreground or background.
Error Message
Start options check failed.
Description
This error code is reported when verification on StartOptions fails.
Possible Causes
Solution
Check whether the constraints for StartOptions are met.
Error Message
Ability already running.
Description
This error code is reported when the target ability is already running.
Possible Causes
startAbility() is called, with processMode and startupVisibility specified. launchType of the target ability is singleton or specified, and the target ability is running.
Solution
When launchType of the target ability is singleton or specified, do not specify processMode and startupVisibility in startAbility().
Error Message
The extension cannot start the third party application.
Description
This type of ExtensionAbility cannot start a third-party application in strict mode.
Possible Causes
The ExtensionAbility is in strict mode, and this type of ExtensionAbility is forbidden to start third-party applications in strict mode.
Solution
Error Message
The extension cannot start the service.
Description
This type of ExtensionAbility cannot start a ServiceExtensionAbility in strict mode.
Possible Causes
The ExtensionAbility is in strict mode, and this type of ExtensionAbility is forbidden to start a ServiceExtensionAbility in strict mode.
Solution
Error Message
App clone is not supported.
Description
This error code is reported when the application does not support clones.
Possible Causes
This error code is reported when the getCurrentAppCloneIndex API is called while the multiAppMode field in the app.json5 file is not set to appClone (meaning that the application does not support app clone mode).
Solution
Configure the multiAppMode field in the app.json5 file by referring to Creating an Application Multi-Instance. After app clone mode is enabled, call the getCurrentAppCloneIndex API.
Error Message
The app clone index is invalid.
Description
This error code is reported when an invalid value of appCloneIndex is passed in.
Possible Causes
Solution
Check whether the constraints of appCloneIndex are met.
Error Message
The caller does not exist.
Description
This error code is reported when the backTocallerAbilityResult API attempts to return the result to the caller but fails to find the caller based on requestCode.
Possible Causes
requestCode is not obtained from the CALLER_REQUEST_CODE field in want.
The caller corresponding to requestCode has been destroyed or the result has been returned.
Solution
Check whether requestCode is obtained from CALLER_REQUEST_CODE in want.
Check whether the caller has been destroyed or the result has been returned.
Error Message
Not support back to caller.
Description
This error code is reported when the backToCallerAbilityWithResult API fails to return the result to the caller.
Possible Causes
The link feature is not configured for the application or the configuration is not approved by the system.
Solution
Error Message
AddAbilityMonitor failed.
AddAbilityMonitorSync failed.
RemoveAbilityMonitor failed.
RemoveAbilityMonitorSync failed.
WaitAbilityMonitor failed.
GetCurrentTopAbility failed.
DoAbilityForeground failed.
DoAbilityBackground failed.
FinishTest failed.
AddAbilityStageMonitor failed.
AddAbilityStageMonitorSync failed.
RemoveAbilityStageMonitor failed.
RemoveAbilityStageMonitorSync failed.
WaitAbilityStageMonitor failed.
Description
This error code is reported when an AbilityMonitor API for monitoring the lifecycle change of a specified ability fails to be executed.
Possible Causes
Creating an AbilityDelegatorRegistry instance fails.
Solution
Check whether an AbilityDelegatorRegistry instance is created.
Error Message
Failed to run the shell command.
Description
This error code is reported when the command is not a valid shell command.
Possible Causes
The command is not a valid shell command.
Solution
Use a valid shell command.
Error Message
Invalid wantAgent object.
Description
This error code is reported when the wantAgent object passed in the API is invalid.
Possible Causes
Solution
Error Message
the wantAgent object does not exist.
Description
This error code is reported when the wantAgent object passed in the API does not exist.
Possible Causes
The wantAgent object does not exist.
Solution
Pass a valid wantAgent object in the API.
Error Message
wangAgent object has been canceled.
Description
This error code is reported when the wangAgent object passed in the API has been canceled.
Possible Causes
The wantAgent object has been canceled.
Solution
Pass a valid wantAgent object in the API.
Error Message
The ability with the specified URI does not exist.
Description
This error code is reported when the ability with the specified URI does not exist.
Possible Causes
The ability to query does not exist.
Solution
Check the ability with the specified URI.
Error Message
Incorrect ability type.
Description
This error code is reported when the ability type invoked by the API is incorrect.
Possible Causes
The ability with the specified type does not support the API call.
Solution
Error Message
The caller has been released.
Description
This error code is reported when the caller has been released.
Possible Causes
The caller has been released.
Solution
Error Message
Callee invalid. The callee does not exist.
Description
This error code is reported when the callee is invalid.
Possible Causes
The callee does not exist.
Solution
Use a valid callee.
Error Message
Release error. The caller does not call any callee.
Description
This error code is reported when the release fails.
Possible Causes
The caller is not registered with a callee.
Solution
Check whether the caller has registered.
Error Message
Method registered. The method has registered.
Description
This error code is reported when the method has been registered.
Possible Causes
The method has been registered by the callee.
Solution
Check whether the method has been registered.
Error Message
Method not registered. The method has not registered.
Description
This error code is reported when the method has not been registered.
Possible Causes
The method has not been registered by the callee.
Solution
Check whether the method has been registered.
Error Message
The caller application can only set the resident status of the configured process.
Description
This error code is reported when the caller does not have the permission to enable or disable the resident process.
Possible Causes
The caller does not have the permission to enable or disable the resident process.
Solution
Ensure that the caller has the required permission before calling this API.
Error Message
Mission not found.
Description
This error code is reported when the specified mission does not exist.
Possible Causes
The mission does not exist.
Solution
Check the mission ID.
Error Message
Input error. The specified mission listener does not exist.
Description
This error code is reported when the specified mission listener does not exist.
Possible Causes
The mission listener does not exist.
Solution
Check the mission listener ID.
Error Message
The target application is not self application.
Description
This error code is reported when the application to start is not the application that calls the API.
Possible Causes
The application to start and the invoker application are not the same application.
Solution
Ensure that the application to start is the invoker application.
Error Message
The bundle is not exist or no patch has applied.
Description
This error code is reported when the specified bundle name is invalid.
Possible Causes
The bundle does not exist or is not installed.
Solution
Check whether the bundle has been installed.
Error Message
Invalid patch package.
Description
This error code is returned when the specified patch package is invalid.
Possible Causes
The patch package does not exist or is inaccessible.
Solution
Error Message
Failed to deploy the patch.
Description
This error code is reported when the patch package fails to be deployed.
Possible Causes
Solution
Check whether the patch package complies with the deployment rules.
Error Message
Failed to enable the patch package.
Description
This error code is reported when the patch package fails to be enabled.
Possible Causes
The patch package is in an incorrect state.
Solution
Check the state of the patch package.
Error Message
Failed to enable the patch package.
Description
This error code is reported when the patch package fails to be deleted.
Possible Causes
The patch package is in an incorrect state.
Solution
Check the state of the patch package.
Error Message
Failed to load the patch.
Description
This error code is reported when the patch fails to be installed.
Possible Causes
The Ark engine fails to install the patch.
Solution
Check whether the patch package is correct.
Error Message
Failed to unload the patch.
Description
This error code is reported when the Ark engine fails to uninstall the patch.
Possible Causes
The Ark engine fails to uninstall the patch.
Solution
Check whether the patch package is correct.
Error Message
Internal error.
Description
This error code is reported when an error occurs during internal processing, such as memory application or multi-thread processing.
Possible Causes
Common kernel errors such as memory application and multi-thread processing errors occur.
Solution
Ensure sufficient system memory.
Error Message
The application has a apply quick fix task that is being processed.
Description
This error code is reported when the application has a quick fix task that is under processing.
Possible Causes
When you try to cancel a quick fix task for an application, the application has a quick repair task that is under processing.
Solution
Wait until the quick fix task is complete.
Error Message
observer not found.
Description
This error code is reported when the specified observer does not exist.
Possible Causes
The observer does not exist or has been unregistered.
Solution
Check whether the observer exists.
Error Message
The target bundle does not exist.
Description
This error code is reported when the bundle information of the preinstalled application does not exist.
Possible Causes
The value of bundleName, userId, or appIndex is incorrect, leading to the query failure.
Solution
Pass in correct values for bundleName, userId, and appIndex.
Error Message
Internal error.
Description
This error code is reported when an internal error such as memory allocation or multithreaded processing exception occurs during image saving.
Possible Causes
Common kernel errors such as memory application and multi-thread processing errors occur. The possible causes are as follows: The internal object is empty, and the processing times out.
Solution
Error Message
Image input error.
Description
This error code is reported when the image URI does not exist or the image cannot be parsed.
Possible Causes
The URI does not exist or the URI does not point to an image file.
Solution
Check whether the file exists and whether the file type is image.
Error Message
Image too big.
Description
The image is too large.
Possible Causes
This error code is reported when the size of the image exceeds 50 MB.
Solution
Error Message
The target free install task does not exist.
Description
This error code is reported when the download and installation task of the specified atomic service does not exist while the atomic service window is opened.
Possible Causes
The value of bundleName, moduleName, abilityName, or startTime is incorrect, leading to the query failure.
Solution
Pass in correct values for bundleName, moduleName, abilityName, and startTime.
Error Message
Startup task or its dependency not found.
Description
This error code is reported if the startup task or its dependency is not found during task startup.
Possible Causes
The startup task or dependency is not correctly configured.
Solution
Check whether the AppStartup configuration file is correctly compiled, and ensure that all configured startup tasks are implemented.
Error Message
The startup tasks have circular dependencies.
Description
This error code is reported if circular dependencies are detected between startup tasks during startup task loading.
Possible Causes
There are circular dependencies between startup tasks.
Solution
Check the AppStartup configuration file, and ensure that no circular dependency exists between startup tasks.
Error Message
An error occurred while running the startup tasks.
Description
This error code is reported when an error occurs during task startup.
Possible Causes
The code logic for starting the task is incorrect, or no exception handling is available.
Solution
Check whether the startup task has logic errors, and ensure that each startup task contains the exception handling logic.
Error Message
Running startup tasks timeout.
Description
This error code is reported if the execution time of a task exceeds the timeout interval (10000 ms by default).
Possible Causes
The startup task contains a large number of time-consuming operations, or the configured timeout interval is too short.
Solution
Adjust the timeout interval as required. For details about how to set the timeout interval, see Setting Startup Parameters.