跳到主要内容

热重载和增量调试错误码

00402001 找不到SDK​

错误信息

Install the SDK first.

错误描述

请先安装SDK。

可能原因

找不到SDK。

处理步骤

检查DevEco Studio安装目录下sdk/default/openharmony路径下面是否有ets目录,如果不存在,在官网上重新下载DevEco Studio。

00402002 热重载只支持STAGE模型工程​

错误信息

Hot Reload Feature is only supported in STAGE and esmodule project.

错误描述

热重载仅支持Stage模型工程。

可能原因

当前工程不是Stage模型工程。

处理步骤

请使用Stage模型工程,或者选择非热重载运行配置。

00402003 热重载模式启动时,找不到node路径​

错误信息

The nodejs path configured for the project is invalid or not found.

错误描述

找不到node路径。

可能原因

node路径不存在。

处理步骤

检查DevEco Studio安装目录的tools目录下是否存在node工具,如果不存在,在官网上重新下载DevEco Studio。

00402004 当前修改不支持热重载​

错误信息

The current modification does not support hot reload. Please reinstall and restart.

错误描述

当前修改不支持热重载。

可能原因

当前的代码修改场景不支持热重载。

处理步骤

请根据当前热重载的使用约束检查当前修改是否支持,如果不支持,需要先点击运行或调试后,再重新启动热重载。

00402005 热重载仅支持文件修改,不支持文件的新增或删除​

错误信息

Hot reload is supported only for file change, but not file addition and deletion.

错误描述

热重载仅支持文件修改,不支持文件的新增或删除。

可能原因

在热重载模式运行期间,用户进行了文件的新增或删除。

处理步骤

先点击运行或调试后,再重新启动热重载。

00402006 进行文件对比时,无法获取node路径​

错误信息

The nodejs path configured in the IDE is invalid or not found.

错误描述

找不到node路径。

可能原因

进行文件对比时,无法获取node路径。

处理步骤

检查DevEco Studio安装目录的tools目录下是否存在node工具,如果不存在,在官网上重新下载DevEco Studio。

00402007 热重载运行超时​

错误信息

Execute hot-reload timeout, please reinstall and restart.

错误描述

热重载运行超时,请重启热重载。

可能原因

热重载进行quickfix时超时。

处理步骤

先点击运行或调试后,再重新启动热重载。

00402008 热重载构建失败​

错误信息

Build failed, check the error information in the console, rectify the fault, and try again.

错误描述

构建失败,请检查控制台中的错误信息,排除故障后重试。

可能原因

构建失败。

处理步骤

根据控制台中的错误信息进行处理后重试。

00402009 增量包签名失败​

错误信息

Failed to sign the patch package, please check the signingConfigs in build-profile.json5.

错误描述

增量包签名失败,请检查build-profile.json5文件中的signingConfigs签名配置是否正确。

可能原因

签名配置不正确。

处理步骤

请检查build-profile.json5文件中的signingConfigs签名配置是否正确,如果不正确,重新签名后重试。

00402010 构建未生成补丁abc文件​

错误信息

PatchAbc was not generated, please clean and restart project.

错误描述

补丁abc文件未生成,请清理缓存后重试。

可能原因

构建生成补丁abc文件失败。

处理步骤

点击菜单栏Build > Clean Project清理缓存后重试。

00402011 hqf增量包生成失败​

错误信息

Failed to create the patch package, please clean and restart project.

错误描述

hqf增量包生成失败,请清理缓存后重试。

可能原因

构建生成hqf增量包失败。

处理步骤

点击菜单栏Build > Clean Project清理缓存后重试。

00402012 重新加载文件失败​

错误信息

Reloaded XXX files failed. Please reinstall and restart.

错误描述

重新加载文件失败,请重新安装并重启。

可能原因

热重载执行bm quickfix命令失败。

处理步骤

可检查以下几方面:

  1. 检查工程签名是否正确,热重载需要使用调试证书签名,不支持使用发布证书签名,具体参考配置调试签名。
  2. 检查工程的构建模式,热重载需要使用debug模式,不支持release模式,具体参考指定构建模式。

00402013 执行Apply Changes超时​

错误信息

Execute apply-change timeout, please restart and reinstall.

错误描述

执行Apply Changes超时,请重启并重新安装。

可能原因

Apply Changes时执行hdc命令超时,可能hdc异常或者设备连接异常。

处理步骤

拔插设备,或者执行hdc kill -r重启hdc后再重试。

00402014 构建hqf增量包失败​

错误信息

Build failed, please reinstall and restart.

错误描述

构建失败,请重新安装并重启。

可能原因

构建hqf增量包失败,详细信息查看构建控制台。

处理步骤

查看构建控制台,根据提示信息修改完成后重试。

00402015 预览器不支持Apply Change​

错误信息

Apply Changes not supported when device type is Previewer.

错误描述

预览器不支持Apply Changes。

可能原因

设备为预览器时使用Apply Changes。

处理步骤

预览器不支持Apply Changes,如需使用Apply Changes功能,请切换真机或模拟器。

00402016 请先启动或调试项目​

错误信息

Start or debug the project first.

错误描述

请先启动或调试项目。

可能原因

没有先启动或调试项目,就尝试执行Apply Changes。

处理步骤

请先点击Run/Debug按钮启动或调试项目,修改代码后再执行Apply Changes。

00402017 HSP模块不支持Apply Changes​

错误信息

Apply Changes not supported for shared modules.

错误描述

HSP模块不支持Apply Changes。

可能原因

当前是HSP模块,不支持Apply Changes。

处理步骤

重新选择HAP模块再重试。

00402018 FA模型的项目不支持Apply Changes​

错误信息

Apply Changes not supported for projects in the FA model.

错误描述

FA模型的项目不支持Apply Changes。

可能原因

当前是FA模型的项目,不支持Apply Changes。

处理步骤

FA模型的项目不要使用Apply Changes。

00402019 当启动模块设置为Nothing时不支持Apply Changes​

错误信息

Apply Changes not supported when Launch module is set to Nothing.

错误描述

当启动模块设置为Nothing时不支持Apply Changes。

可能原因

运行/调试配置面板中的Launch Options配置的Launch是Nothing。

处理步骤

运行/调试配置面板中,Launch Options下的Launch选择一个ability再重试。

00402020 当前运行配置为空​

错误信息

XXX: settings is null.

错误描述

当前运行配置为空。

可能原因

没有选择运行配置。

处理步骤

重新选择运行配置。

00402021 未检测到C++文件或资源文件的更改​

错误信息

No changes detected on C++ files or resource files. If you have made changes to files in other types, click the Run/Debug icon instead.

错误描述

未检测到C++文件或资源文件的更改。如果对其他类型的文件进行了更改,请点击运行/调试按钮。

可能原因

没有修改C++文件或者资源文件,修改了ETS文件或者没有任何修改。

处理步骤

修改C++文件或者资源文件再执行Apply Change,如果修改其他类型的文件,请点击运行/调试按钮。

00402024 未能成功在设备上部署增量更改​

错误信息

Failed to deploy the incremental changes on the device. Update the device image to the latest version and try again, or click the Run/Debug icon to deploy all changes.

错误描述

未能在设备上部署增量更改。请将设备镜像更新至最新版本后重试,或点击运行/调试按钮以部署所有更改。

可能原因

  1. 执行bm quickfix命令失败,可能设备镜像版本比较低。
  2. 如果是2in1设备,可能是应用开启了应用加速服务。

处理步骤

  1. 请将设备镜像更新至最新版本后重试,或点击运行/调试按钮。
  2. 如果是2in1设备,请在设备的设置 > 应用和元服务 > 应用加速服务中,查看应用是否开启了应用加速服务,并关闭应用的加速服务。

00402025 hqf和hap的ASan/TSan/UBSan/HWASan不一致​

错误信息

Apply change fail, please confirm whether ASan/TSan/UBSan/HWASan is same as the hap and reinstall.

错误描述

执行Apply change失败,请确认ASan/TSan/UBSan/HWASan是否与hap相同,并重新安装。

可能原因

ASan、TSan、UBSan、HWASan不能同时开启,四个只能开启其中一个。

处理步骤

设置ASan/TSan/UBSan/HWASan和hap一致,或者卸载应用再重新运行。

00402026 执行Apply change失败​

错误信息

Apply change fail.

错误描述

执行Apply change失败。

可能原因

设备连接异常或者hdc异常。

处理步骤

重新拔插设备,或者执行hdc kill -r再重试。

00402027 设备处于锁屏状态​

错误信息

The screen is locked. Please unlock the screen and try again.

错误描述

设备处于锁屏状态。请解锁屏幕并重试。

可能原因

应用启动或Apply Changes时设备处于锁屏状态。

处理步骤

请解锁屏幕并重试。

00402028 应用启动时ability不可见​

错误信息

Ability is not visible.

错误描述

Ability不可见。

可能原因

当前aa start命令启动的Ability不可见。

处理步骤

  • Stage模型工程:在module.json5文件中,将abilities字段下的exported设置为true。
  • FA模型工程:在config.json文件中,将abilities字段下的visible设置为true。

00402030 无法创建changedFileList.json文件​

错误信息

Failed to create changedFileList.json, please clean and restart project.

错误描述

无法创建changedFileList.json文件,请清理并重启项目。

可能原因

创建changedFileList.json文件失败。

处理步骤

点击菜单栏Build > Clean Project清理缓存后重试。

00402031 无法获取用于文件比较的node脚本​

错误信息

Failed to obtain the node script for file comparison. Please reinstall the IDE.

错误描述

无法获取用于文件比较的node脚本。请重新安装IDE。

可能原因

无法获取用于文件比较的node脚本。

处理步骤

重新下载安装DevEco Studio。

00402032 以下更改无法进行热重载和热重启​

错误信息

Hot reload and hot restart unavailable for the following changes.

错误描述

以下更改无法进行热重载和热重启。

可能原因

控制台提示的是热重载和热重启都不支持的场景。

处理步骤

请根据当前热重载和热重启的使用约束检查当前修改是否支持,如果不支持,需要先点击运行或调试后,再重新启动热重载或热重启。

00402033 ChangedFileList.json为空或不存在​

错误信息

ChangedFileList.json is null or empty, please clean and rerun project.

错误描述

ChangedFileList.json为空或不存在,请清理并重新运行项目。

可能原因

ChangedFileList.json为空或不存在。

处理步骤

点击菜单栏Build > Clean Project清理缓存后重试。

00402034 以下更改无法进行热重载​

错误信息

Hot reload unavailable for the following changes.

错误描述

以下更改无法进行热重载。

可能原因

触发了热重载不支持、热重启支持的场景,但是没勾选Enable hot restart。

处理步骤

打开热重启开关后,点击运行或调试,再重新启动热重载。

00402035 release模式下不支持热重载​

错误信息

Cannot hot reload the project when its build mode is release. Change the build mode to debug and try again.

错误描述

当构建模式为release模式时,无法热重载项目。请将构建模式更改为debug模式后重试。

可能原因

当前项目的构建模式为release模式。

处理步骤

请将构建模式更改为debug模式后重试。

00402036 hdc版本不兼容​

错误信息

Incompatible hdc version. Use the one in sdk\default\openharmony\toolchains under the DevEco Studio installation directory.

错误描述

hdc版本不兼容。请使用DevEco Studio安装目录下sdk\default\openharmony\toolchains下的hdc。

可能原因

环境变量配置了较低版本的hdc。

处理步骤

hdc环境变量更新为DevEco Studio安装目录下sdk\default\openharmony\toolchains下的hdc,再重启DevEco Studio。