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 of the called party does not match the expected type when an ability-related API is called.
Possible Causes
Solution
Error Message
The specified 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
Cannot start an 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 caller has the permission required by the target component.
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
Check whether a cross-user operation is being attempted by checking whether the user ID passed during the API call matches the current userID.
Error Message
Service busy. There are concurrent tasks. Try again later.
Description
This error code is reported when the system service is not responding.
Possible Causes
The application tries to access the system service before it is fully started.
Solution
Wait until the system service is started and then try again.
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
Check whether the application has expired. A crowdtesting application that has passed its validity period 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 and prepare 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 the application is under control.
Possible Causes
The application is controlled by the system control module and is not allowed to start.
Solution
The target application is prohibited from being started. Try the call again later.
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
Redirection to a third-party application is not allowed in API version greater than 11.
Description
For applications with an API version later than 11, explicit redirection to other third-party applications is not allowed.
Possible Causes
The application uses an API version later than 11 and attempts to explicitly redirect to a third-party application.
Solution
Use implicit startup or openLink for redirection.
Error Message
No matching ability is found.
Description
This error code is reported when a matching ability is not found during implicit startup.
Possible Causes
Solution
Error Message
Internal error.
Description
This error code is reported when an internal exception occurs that the developer cannot resolve, such as memory allocation failure, multithreading exceptions, or IPC failure.
Possible Causes
Solution
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, it is necessary to ensure that the ability is in the foreground, but the ability is not displayed at the top of the UI.
Solution
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
Operation not supported.
Description
This error code is reported when the operation is not supported.
Possible Causes
The operation is not supported.
Solution
Perform a supported operation.
Error Message
The number of child processes exceeds the upper limit.
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 upper limit is 512.
Error Message
The target to restart does not belong to the current application 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 belongs to the current application and the ability type is UIAbility.
Error Message
Restart too frequently. Try again at least 3s later.
Description
This error code is reported when the API used to restart the application with a specified component is called again within 3 seconds.
Possible Causes
The API is frequently called.
Solution
Wait for at least 3s and try again.
Error Message
The API can be called only when the ability is running in the 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
Before calling the API, ensure that the ability is running in the foreground and the UI is visible.
Error Message
An ability cannot switch to the 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, it is not allowed to switch the ability 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
The StartOptions 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
The ability is 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 or startupVisibility in startAbility().
Error Message
The extension cannot start the third party application.
Description
In strict mode, the ExtensionAbility is not allowed to start third-party applications.
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
In strict mode, the ExtensionAbility is not allowed to start the specified ServiceExtensionAbility.
Possible Causes
The ExtensionAbility is in strict mode, and this type of ExtensionAbility is forbidden to start the specified 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
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
App clone or multi-instance is not supported.
Description
This error code is reported when the application does not support multi-app mode.
Possible Causes
When calling Ability startup APIs such as startAbility and startAbilityForResult, this error code is returned if the target application does not support multi-app mode.
Solution
When calling Ability startup APIs such as startAbility and startAbilityForResult, ensure that the target application supports multi-app mode and configure multiAppMode tag in the app.json5 file to enable the application clone function.
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
startAbility() is called, with appCloneIndex carried in ohos.extra.param.key.appCloneIndex set to an invalid value.
isAppRunning() is called, with appCloneIndex set to an invalid value.
The ExtensionAbility to be connected does not support the application clone.
Solution
Check whether the constraints of appCloneIndex are met.
Error Message
The caller does not exist.
Description
This error code is reported when the backToCallerAbilityWithResult 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
BackToCaller is not supported.
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
The app instance key is invalid.
Description
This error code is reported when the specified APP_INSTANCE_KEY does not exist.
Possible Causes
The instance specified by APP_INSTANCE_KEY does not exist.
Solution
Ensure that the value of APP_INSTANCE_KEY is valid.
Error Message
The number of app instances reaches the limit.
Description
This error code is reported when the number of application instances reaches the upper limit and more application instances try to be created.
Possible Causes
Before creating an application instance, the application does not check whether the number of application instances reaches the upper limit.
Solution
To create a new instance when the number of application instances has reached the upper limit, prompt the user to close existing instances via a dialog box.
Error Message
The multi-instance is not supported.
Description
This error code is reported when the application does not support multi-instance mode.
Possible Causes
Solution
Error Message
The APP_INSTANCE_KEY cannot be specified.
Description
APP_INSTANCE_KEY and CREATE_APP_INSTANCE_KEY cannot be specified at the same time. This error code is reported when both of them are specified.
Possible Causes
Too many parameters are passed.
Solution
Specify either APP_INSTANCE_KEY or CREATE_APP_INSTANCE_KEY.
Error Message
Creating a new instance is not supported.
Description
Applications can use CREATE_APP_INSTANCE_KEY to create their own instances, but not for other applications. Otherwise, this error code is reported.
Possible Causes
The parameter use scenario is incorrect.
Solution
Delete the CREATE_APP_INSTANCE_KEY parameter.
Error Message
The ExtensionAbility cannot start the ability due to system control.
Description
Different types of ExtensionAbility components require different capabilities. The system does not allow this type of ExtensionAbility to start the specified ability.
Possible Causes
The current type of ExtensionAbility is under system control and is not allowed to start the specified ability.
Solution
Check the usage constraints for this type of ExtensionAbility, and ensure that the API is used as required.
Error Message
Only DelegatorAbility is allowed to call this API, and only once.
Description
The system allows the DelegatorAbility to call this API only once.
Possible Causes
Solution
Error Message
An error occurred during the interaction between the ability and window.
Description
An error occurs during the interaction between the ability and the window.
Possible Causes
The window service process is abnormal.
Solution
This is a system error. Try calling the API again.
Error Message
The context is not UIAbilityContext.
Description
This error code is reported when the passed Context object is not a UIAbilityContext.
Possible Causes
The passed Context object is not a UIAbilityContext or does not inherit from the UIAbilityContext class.
Solution
Ensure that the passed parameter is a UIAbilityContext object or its child class object.
Error Message
The caller is not an atomic service.
Description
This error code is reported when the caller is not an atomic service.
Possible Causes
The API caller is not an atomic service.
Solution
Ensure that the caller is an atomic service.
Error Message
Calling AddAbilityMonitor failed.
Calling AddAbilityMonitorSync failed.
Calling RemoveAbilityMonitor failed.
Calling RemoveAbilityMonitorSync failed.
Calling WaitAbilityMonitor failed.
Calling GetCurrentTopAbility failed.
Calling DoAbilityForeground failed.
Calling DoAbilityBackground failed.
Calling FinishTest failed.
Calling AddAbilityStageMonitor failed.
Calling AddAbilityStageMonitorSync failed.
Calling RemoveAbilityStageMonitor failed.
Calling RemoveAbilityStageMonitorSync failed.
Calling 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
The current application is not in Kiosk app list and cannot enter Kiosk mode.
Description
This error code is reported when the current application is not in the kiosk mode list and cannot enter kiosk mode.
Possible Causes
The application is not in the kiosk mode list and cannot enter kiosk mode.
Solution
Add the application to the kiosk application list on the EDM.
Error Message
The system is already in Kiosk mode and cannot enter Kiosk mode again.
Description
This error code is reported when the system is already in kiosk mode.
Possible Causes
Only one application can enter Kiosk mode at a time.
Solution
Exit the application that is in Kiosk mode.
Error Message
The current application is not in Kiosk mode and cannot exit Kiosk mode.
Description
This error code is reported when the current application is not in Kiosk mode and cannot exit Kiosk mode.
Possible Causes
The application is not in Kiosk mode and cannot exit Kiosk mode.
Solution
Check whether any application in the system is in Kiosk mode.
Error Message
Current ability is not in foreground.
Description
When the ability is not in the foreground, attempting to perform operations that require the foreground will return this error code.
Possible Causes
The current ability is not in the foreground.
Solution
Check whether the ability is in the foreground.
Error Message
The UIAbility not belong to caller.
Description
This error code is reported when target UIAbility does not belong to the caller.
Possible Causes
Attempting to launch a UIAbility that belongs to another application.
Solution
Verify that the target UIAbility belongs to the caller.
Error Message
The UIAbility is already exist, can not start again.
Description
This error code is reported when the UIAbility is already running and cannot be started again.
Possible Causes
startSelfUIAbilityInCurrentProcess is designed for cold-starting a new UIAbility instance. This error occurs when attempting to launch a UIAbility instance that has already been started.
Solution
Check whether the UIAbility has already been launched.
Error Message
The main window of this ability of this context does not exits.
Description
This error code is reported when the main window for this UIAbility does not exist.
Possible Causes
The API is called when the window has not yet been created or has already been destroyed.
Solution
Do not call this API before the window stage is created or after it is destroyed.
Error Message
The UIAbility is prohibited from launching itself via App Linking.
Description
The application is configured to disallow launching the current UIAbility using App Linking.
Possible Causes
Under abilities in the module.json5 file, the value of the allowSelfRedirect field of the current UIAbility is false.
Solution
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 caller is not in the appIdentifierAllowList of the target application.
Description
This error code is reported when the caller is not in the appIdentifierAllowList of the target application.
Possible Causes
The app-identifier of the caller of startAppServiceExtensionAbility or stopAppServiceExtensionAbility is not in the appIdentifierAllowList of the target AppServiceExtensionAbility.
Solution
Configure the app-identifier of the API caller in the appIdentifierAllowList of the target AppServiceExtensionAbility.
Error Message
The target service has not been started yet.
Description
This error code is reported when the target service is not started.
Possible Causes
When the connectAppServiceExtensionAbility API is used, the server is not started, and the current application does not have the permission to start the target service.
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
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
The method has been 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. If the method has been registered, do not register it again.
Error Message
The method has not been 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
Register the method on the callee side and then call it.
Error Message
The target application is not the current 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 observer does not exist.
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
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 multithreading 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
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.
Error Message
The current process cannot be set as a candidate master process.
Description
The current process does not meet the requirements to be configured as a candidate master process.
Possible Causes
The process fails to satisfy at least one of the following conditions:
Solution
No workaround is available. A process can only be set as a candidate master process if it is currently running a component with isolationProcess set to true, or if it has previously functioned as the master process.
Error Message
The current process is already a master process and does not support cancellation.
Description
This error code is reported when you attempt to cancel the current process, which is already the master process, as a candidate master process.
Possible Causes
The current process is already the master process.
Solution
No action can be taken. Cancellation is not supported since the current process is already the master process.
Error Message
The current process is not a candidate master process and does not support cancellation.
Description
This error code is reported when you attempt to cancel the current process, which is not a candidate master process, as a candidate master process.
Possible Causes
The current process is not a candidate master process and cannot be canceled.
Solution
No action can be taken. Cancellation is not supported since the current process is not a candidate master process.
Error Message
Not a master process.
Description
This error code is reported when you attempt to relinquish the master-process role of the current process, which is not the master process.
Possible Causes
The current process is not the master process and cannot relinquish its master-process role.
Solution
No action can be taken. The current process is not the master process and cannot relinquish its master-process role.
Error Message
Cannot exit because there is an unfinished request.
Description
The attempt to relinquish the current process's master process status has failed due to pending requests.
Possible Causes
The current process contains unfinished requests:
Solution
Wait for all current requests in the process to complete before attempting to relinquish master process status.
Error Message
The API is not called in the main thread.
Description
This error code is reported when the API is not called in the main thread.
Possible Causes
The current API is called in a Worker or TaskPool thread, which is not supported.
Solution
Move the API call logic to the main thread.
Error Message
Decorator parameters must be compile-time constants.
Description
This error code is reported when variables are used as decorator parameters in the code. Compile-time constants (such as string literals) are required.
Possible Causes
Decorator parameters use variables.
Solution
Change the decorator parameters from variables to fixed values.
Error Message
The intent decorator can only be used in .ets files.
Description
This error code is reported when the intent decorator is used in a non-.ets file.
Possible Causes
The intent decorator is used in a non-.ets file.
Solution
Use the intent decorator in an .ets file.
Error Message
Decorators must be called as functions.
Description
This error code is reported when the decorator is not invoked in function call form.
Possible Causes
The decorator is not invoked in function call form.
Solution
Add parentheses to ensure that the decorator is invoked as a function.
Error Message
Required parameters are missing for the decorator.
Description
This error code is reported when required parameters are not provided for the decorator.
Possible Causes
Required parameters are not provided for the decorator.
Solution
Add the required parameters based on the error message.
Error Message
The parameter type does not match the decorator's requirement.
Description
This error code is reported when the parameter type does not match the decorator's requirements.
Possible Causes
The parameter type does not match the decorator's requirements.
Solution
Adjust the parameter type based on the error message.
Error Message
Unsupported parameters found in the decorator.
Description
This error code is reported when unsupported parameters are found in the decorator.
Possible Causes
Unsupported parameters are written in the decorator.
Solution
Remove unsupported parameters based on the error message. (Only the string, number, boolean, object, and array types are supported.)
Error Message
Circular dependencies detected in decorator parameters.
Description
This error code is reported when circular dependencies are detected in decorator parameters.
Possible Causes
Circular dependencies are written in the decorator parameters.
Solution
Refactor the data structure by extracting common variables or using ID references to avoid nesting.
Error Message
The root type of the JSON Schema for Parameters must be object.
Description
This error code is reported when the root type of the JSON schema for Parameters is not object.
Possible Causes
The root type of the JSON schema for Parameters is not object.
Solution
Ensure that the top-level definition of the JSON schema for Parameters is {"type":"object"}.
Error Message
A required field in the class property is missing.
Description
This error code is reported when a required field in the class property is missing.
Possible Causes
A required field in the class property is missing.
Solution
Add the required field as specified by the JSON Schema.
Error Message
The field type of the class property does not match the JSON Schema.
Description
This error code is reported when the field type of the class property does not match the JSON schema.
Possible Causes
The field type of the class property does not match the JSON schema.
Solution
Correct the type to match the requirement.
Error Message
The class property parameter violates the oneOf/anyOf validation rules in the JSON Schema.
Description
This error code is reported when the class property parameter violates the oneOf/anyOf validation rules in the JSON schema.
Possible Causes
The class property parameter violates the oneOf/anyOf validation rules in the JSON Schema.
Solution
Modify the parameter to meet the validation rules.
Error Message
The class property includes parameters not defined in the JSON Schema.
Description
This error code is reported when the class property includes parameters not defined in the JSON schema.
Possible Causes
The class property includes parameters not defined in the JSON schema.
Solution
Remove any extra parameters.
Error Message
Duplicate intentName definitions found.
Description
This error code is reported when duplicate intentName definitions are found.
Possible Causes
The same intentName is declared in the module.
Solution
Find the duplicate intentName in the module and rename it.
Error Message
Methods decorated with @InsightIntentFunctionMethod must be in a class decorated with @InsightIntentFunction.
Description
This error code is reported when the method decorated with @InsightIntentFunctionMethod is not in the class decorated with @InsightIntentFunction.
Possible Causes
The method decorated with @InsightIntentFunctionMethod is not in the class decorated with @InsightIntentFunction.
Solution
Move the method to the class decorated with @InsightIntentFunction, or add the @InsightIntentFunction decorator to the class.
Error Message
The class decorated with @InsightIntentFunction must be exported.
Description
This error code is reported when the class decorated with @InsightIntentFunction is not exported using export.
Possible Causes
The class decorated with @InsightIntentFunction is not exported using export.
Solution
Add an export statement to the class.
Error Message
Methods decorated with @InsightIntentFunctionMethod must be static.
Description
This error code is reported when the method decorated with @InsightIntentFunctionMethod is not a static method.
Possible Causes
The method decorated with @InsightIntentFunctionMethod is not modified with static.
Solution
Modify the method decorated with @InsightIntentFunctionMethod with static.
Error Message
@InsightIntentPage must be applied to a struct page.
Description
This error code is reported when the @InsightIntentPage decorator is not applied to a struct page.
Possible Causes
The @InsightIntentPage decorator is applied to a regular class.
Solution
Move the @InsightIntentPage decorator to a struct page.
Error Message
pagePath in @InsightIntentPage does not match the actual page path.
Description
This error code is reported when pagePath in @InsightIntentPage does not match the actual page path.
Possible Causes
The value of pagePath in @InsightIntentPage is incorrect.
Solution
Ensure that the file paths in the directory are consistent.
Error Message
Classes decorated with @InsightIntentEntry must inherit from InsightIntentEntryExecutor.
Description
This error code is reported when the class decorated with @InsightIntentEntry does not inherit from the base class InsightIntentEntryExecutor.
Possible Causes
The class decorated with @InsightIntentEntry does not inherit from the base class InsightIntentEntryExecutor.
Solution
Add base class the InsightIntentEntryExecutor to the class.
Error Message
The class decorated with @InsightIntentEntry must be exported as default.
Description
This error code is reported when the class decorated with @InsightIntentEntry is not exported using export default.
Possible Causes
The class decorated with @InsightIntentEntry is not exported using export default.
Solution
Add an export default statement to the class.
Error Message
Multiple @InsightIntentEntity decorators applied to the same class.
Description
This error code is reported when the same class is decorated with multiple @InsightIntentEntity decorators.
Possible Causes
Multiple @InsightIntentEntity decorators are applied to the same class.
Solution
Remove the extra @InsightIntentEntity decorators.
Error Message
Classes decorated with @InsightIntentEntity must implement InsightIntent.IntentEntity.
Description
This error code is reported when the class decorated with @InsightIntentEntity does not implement InsightIntent.IntentEntity.
Possible Causes
The class decorated with @InsightIntentEntity does not implement InsightIntent.IntentEntity.
Solution
Ensure that the class implements InsightIntent.IntentEntity or inherits from another intent entity.
Error Message
@InsightIntentForm must be applied to formExtensionAbility.
Description
This error code is reported when the @InsightIntentForm decorator is not applied to formExtensionAbility.
Possible Causes
The @InsightIntentForm decorator is not applied to formExtensionAbility.
Solution
Move the @InsightIntentForm decorator to the formExtensionAbility class.
Error Message
formName in @InsightIntentForm must match the widget name registered in formExtensionAbility.
Description
This error code is reported when the formName parameter in @InsightIntentForm does not match the widget name registered in formExtensionAbility.
Possible Causes
The formName parameter in @InsightIntentForm is declared incorrectly.
Solution
Update formName to match the registered widget name.
Error Message
The module.json5 file is missing.
Description
This error code is reported when the module.json5 file is not found in the project.
Possible Causes
The module.json5 file has been deleted or moved.
Solution
Check the file path (usually in entry/src/main/config.json or module.json5) and confirm whether the file has been accidentally deleted or moved.
Error Message
Failed to write to the intent configuration file.
Description
This error code is reported when the intent configuration file cannot be written.
Possible Causes
The permission is insufficient or the disk space is full.
Solution
Check file permissions, free disk space, or restart DevEco Studio.
Error Message
Generating standard OHMUrl failed with useNormalizedOHMUrl configuration not set to true.
Description
This error code is reported when the standard OHM URL fails to be generated because useNormalizedOHMUrl is not set to true.
Possible Causes
useNormalizedOHMUrl is not set or is set to false.
Solution
Set useNormalizedOHMUrl to true in the application-level file build-profile.json5.
Error Message
The specified agentId does not exist.
Description
The specified agentId does not exist.
Possible Causes
The AgentCard corresponding to the specified agentId does not exist in the target application.
Solution
Check the static configuration information of the target application and transfer the correct agentId.
Error Message
Failed to send the IPC message.
Description
IPC messages fail to be sent.
Possible Causes
Solution
Error Message
Maximum connections from the same caller have been reached.
Description
The number of connections of the caller has reached the maximum.
Possible Causes
The number of concurrent AgentExtension connections of the caller has reached 5. No more connection requests can be initiated.
Solution
Disconnect some connections and re-initiates connections.