
HarmonyOS Developer DevEco Studio常见问题
概述
环境准备
- JS SDK安装失败处理指导
- 导入Sample时,提示连接Gitee超时
- 导入Sample时,提示SSL证书校验错误
- 下载HarmonyOS SDK时,提示网络连接错误
- 安装OpenHarmony npm包失败的处理办法
- DevEco Studio无法打开
工程管理
打开工程时,提示“Module Check Failed”
代码编辑
预览器
- xml中引入三方组件后不能预览的处理办法
- HarmonyOS API 5 JS工程list卡片组件在wearable设备上显示异常
- macOS中,API 4和5版本的预览器,无法打印用户日志
- 预览器热加载时出现白屏
编译构建
- C++工程编译导致电脑卡顿的处理建议
- 工程同步或构建失败,提示“Unknown argument -v”
- 工程同步或构建失败,提示“Can not find the sdk type toolchains of API9”
- JDK版本不匹配导致的编译失败问题处理指导
- LABEL_VALUE_ERROR处理指导
- HarmonyOS library引用本地har包错误
- Maven仓不支持非安全协议的处理办法
- UNSUPPORT_GRADLE_PARAM_ERROR处理指导
- 执行npm install时出现“@types/liblibrary.so@latest' is not in the npm registry”
- 如何配置应用/服务的启动界面信息
- 编译报错“No available entry module found”
- 升级DevEco Studio或SDK后,工程模板与SDK不匹配导致报错
调试运行
- 同时连接HarmonyOS和OpenHarmony设备,但只能识别其中一种设备
- 设备连接后,无法识别设备的处理指导
- 运行应用/服务时,提示“ install no signature info”
- HarmonyOS应用自动化签名时提示“Provision number exceeds limit”
- 安装HAP时提示“error: install parse profile prop check error”错误
- 安装HAP时提示“error: install parse native so failed”错误
- INSTALL_PARSE_FAILED_USESDK_ERROR处理指导
- INSTALL_FAILED_APP_SOURCE_NOT_TRUSTED处理指导
- INSTALL_FAILED_NO_BUNDLE_SIGNATURE处理指导
- ERROR_GET_BUNDLE_INSTALLER_FAILED处理指导
- INSTALL_FAILED_PROVISIONING_BUNDLE_NAME_INVALID处理指导
- INSTALL_FAILED_VERIFY_APP_PKCS7_FAIL处理指导
- INSTALL_FAILED_INCOMPATIBLE_SIGNATURE处理指导
- INSTALL_FAILED_RESTRICTED_PERMISSIONS_NOT_GRANTED处理指导
- INSTALL_FAILED_BUNDLE_INFO_NOT_CONFIG处理指导
- SERVICE_UNAVAILABLE处理指导
- ERROR_BUNDLE_PATH_OR_FILE处理指导
- INSTALL_PARSE_FAILED_SYSCAP_NOT_SUPPORT处理指导
- INSTALL_PARSE_FAILED_REQPERMISSIONS_ERROR处理指导
- INSTALL_FAILED_DEVICE_NOT_SUPPORT_ERROR处理指导
- INSTALL_PARSE_FAILED_BAD_PROFILE处理指导
- INSTALL_PARSE_FAILED_INCONSISTENT_BUNDLE_VERSION处理指导
- INSTALL_EXTRA_FAILED_UPDATE_INCOMPATIBLE处理指导
- INSTALL_FAILED_INVALID_SIGNATURE_FILE_PATH处理指导
- INSTALL_FAILED_BAD_BUNDLE_SIGNATURE_FILE处理指导
- INSTALL_FAILED_BUNDLE_INTEGRITY_VERIFICATION_FAILURE处理指导
- INSTALL_FAILED_VERSION_DOWNGRADE处理指导
- INSTALL_FAILED_VERSION_INCONSISTENT处理指导
- INSTALL_FAILED_INVALID_BUNDLE_FILE处理指导
- INSTALL_FAILED_INVALID_BUNDLE_NAME处理指导
- INSTALL_PARSE_FAILED_DEFPERMISSIONS_ERROR处理指导
- INSTALL_PARSE_FAILED_MODULE_TYPE_ERROR处理指导
- INSTALL_PARSE_FAILED_NO_MAINENTRY处理指导
- INSTALL_PARSE_FAILED_INCONSISTENT_BUNDLE_NAME处理指导
- INSTALL_PARSE_FAILED_INCONSISTENT_COMPRESS_NATIVE_LIBS处理指导
- ERR_APPEXECFWK_INSTALL_PARSE_FAILED_USESDK_ERROR处理指导
- Release应用堆栈解析相关错误提示及解决措施
- ERR_INSTALL_PARSE_NATIVE_SO_FAILED处理指导
- JS调试中Variables页签及编辑器中无法正常查看变量值
- C++调试异常进入汇编代码中执行
登录授权
- 登录超时说明
- 登录华为开发者帐号后,提示需要实名认证
- 已实名认证,登录时还是提示用户需要进行实名认证
- 输入华为帐号后,未出现“允许”按钮,浏览器界面无跳转
- 浏览器点击“允许”按钮后,出现登录客户端失败提示
- 点击Device Manager,提示“找不到应用程序”
- 点击“允许”后,浏览器提示“无法访问此网站”
- 登录时浏览器提示不安全,“你的连接不是私密连接”
远程模拟器
本地模拟器
- 启动模拟器,提示磁盘空间不足
- 启动模拟器,提示镜像文件缺失
- 启动模拟器,提示SDK路径已更改
- macOS系统启动模拟器,提示共享内存不足
- 启动模拟器,提示无法启动模拟器
- 启动模拟器,提示无法安装HAXM
- 启动模拟器,提示VT/NX不可用
- 启动模拟器,提示无法安装GVM
- 通过命令行启动模拟器,提示非法的启动方式
- 本地模拟器支持C++工程调试
- 启动模拟器,超时无响应
- 启动模拟器,提示“多个视频控制器正在运行,请确保只启用一个”
相关资源
- 应用审核相关FAQ
- 智能助手:通过问答的形式,直接获取常见问题的解决方法。
- 开发者论坛:官方问题反馈渠道,方便开发者进行问题讨论。
环境准备
JS SDK安装失败处理指导
问题现象
下载JS SDK时,下载失败,提示“Install Js dependencies failed”。
解决措施
JS SDK下载失败,一般情况下,主要是由于npm代理配置问题,或未清理npm缓存信息导致,可按照如下方法进行处理。
- 检查网络是否受限,如果需要通过代理才能访问网络,可根据NPM代理配置指导,配置代理服务器信息。如果网络不受限,可跳过该步骤。
- 请进入到DevEco Studio安装目录下的tools\nodejs目录下打开命令行工具,执行如下命令,清理npm缓存。
- 在欢迎页点击Configure(或
图标) > Settings > SDKs,勾选JS SDK,点击Apply重新进行下载。
导入Sample时,提示连接Gitee超时
问题现象
导入Sample时,导入失败,提示“Failed to connect to gitee.com port 443: Time out”连接超时。
解决措施
该问题一般是由于网络受限导致,请检查网络连接状态。如果网络受限,需要通过代理服务器访问网络,请执行以下操作,配置git代理信息。
- 进入Git安装目录(默认为C:\Program Files\Git),双击运行“git-cmd.exe”文件。
- 在打开的命令行窗口中,执行以下命令配置代理服务器信息(将proxyUsername、ProxyPassword、proxyserver和port按照实际代理服务器进行修改)。
说明
如果password中存在特殊字符,如@、#、*等符号,可能导致配置不生效,建议将特殊字符替换为ASCII码,并在ASCII码前加百分号%。常用符号替换为ASCII码对照表如下:
- !:%21
- @:%40
- #:%23
- ¥:%24
- &:%26
- *:%2A
- 执行完成后,请重新尝试导入Sample。
导入Sample时,提示SSL证书校验错误
问题现象
导入Sample时,导入失败,提示“SSL certificate problem: unable to get local issuer certificate”证书校验错误。
解决措施
出现这个错误可能是网络遭受了攻击,或者你的网络提供方网络策略阻止了相关操作,如果你确认所处的网络环境安全,可以临时关闭证书校验以获取Sample。
- 进入Git安装目录(默认为C:\Program Files\Git),双击运行“git-cmd.exe”文件。
- 在打开的命令行窗口中,执行如下命令关闭SSL证书校验功能。
说明
关闭SSL证书校验,可能会带来安全风险,建议导入完Sample后,及时开启。开启方法:将该命令中的false修改为true即可。
- 执行完成后,请重新尝试导入Sample。
下载HarmonyOS SDK时,提示网络连接错误
问题现象
网络连接正常,下载HarmonyOS SDK时,却提示网络连接错误。
解决措施
可能因为使用的PC的系统语言是英文,区域码是US所致。按照以下方式,将区域码修改为CN,在修改前请先关闭DevEco Studio。
在 C:\Users\username\AppData\Roaming\Huawei\DevEcoStudio3.0\options 路径下(MacOS路径为/Users/username/Library/Application Support/Huawei/DevEcoStudio3.0/options),打开 country.region.xml ,修改countryregion name为“CN”。
安装OpenHarmony npm包失败的处理办法
问题现象
在执行npm install命令安装OpenHarmony npm仓时,提示安装失败。
解决措施
可能是由于未设置OpenHarmony npm仓的地址,可执行如下命令后进行重新安装。
DevEco Studio无法打开
问题现象
在Windows 10和Windows 11中,修改字符编码后,安装在中文目录下的DevEco Studio无法打开,报错“Error launching...”。
解决措施
请在英文目录下重新安装DevEco Studio。
工程管理
打开工程时,提示“Module Check Failed”
问题现象
打开工程时,DevEco Studio对Har模块进行校验,提示“Module Check Failed”,需要将hvigorfile.js升级为hvigorfile.ts,并在Har模块的package.json文件中添加"type": "module"字段。
解决措施
该问题是由于DevEco Studio升级至3. 1 Canary1版本后,会对Har模块进行校验。包括是否存在hvigorfile.ts文件,以及Har模块的package.json文件是否存在"type": "module"字段。请根据如下方式进行解决:
- 重新打开该工程,DevEco Studio会弹出“Module Check”窗口,单击OK按钮DevEco Studio会自动进行处理。
- 手动将工程中所以Har模块的hvigorfile.js文件修改为hvigorfile.ts,并在模块下的package.json中添加"type": "module"字段。
代码编辑
编辑器自动联想、跳转等功能失效的处理指导
问题现象
在DevEco Studio上进行代码编辑时,代码自动联想、代码跳转等功能失效。
解决措施
导致该问题的可能原因是工程文件所在的目录存在中文字符,请将该工程移动到全英文目录下,然后重新打开工程即可。
预览器
xml中引入三方组件后不能预览的处理办法
问题现象
在xml布局文件中,如果引入了三方的插件,在预览时会无法正常显示引入的组件。如下图所示,在引入了<com.andexert.library.RippleView>组件后,在预览界面并没有显示该组件的效果。
解决措施
该问题是由于与代码混淆工程存在冲突,您可以在xml开发过程中,先关闭代码混淆功能,然后在编译构建HAP/APP时,再重新打开代码混淆功能。
代码混淆功能关闭方法:打开工程目录中,模块下的build.gradle文件,将proguardEnabled设置为false,然后重新预览即可查阅组件效果,如下所示。
HarmonyOS API 5 JS工程list卡片组件在wearable设备上显示异常
问题现象:
HarmonyOS API5 JS工程list卡片组件在wearable设备上只显示在表盘下半部分。
解决措施:
将工程和模块下的build.gradle中的compileSdkVersion字段取值修改为6及以上,然后重新同步工程和重启预览器查看预览效果。
macOS中,API 4和5版本的预览器,无法打印用户日志
问题现象:
在macOS上,如果是API 4或5(build.gradle中compileSdkVersion字段)的工程,在预览时无法正常打印用户日志。
解决措施:
该问题的原因是系统引擎没有输出用户日志,建议您将工程的API版本升级到6或7。
- 分别打开工程根目录和模块根目录下的build.gradle文件,将compileSdkVersion修改成6或7。
- 点击Sysc Now进行同步。
- 重启预览器,然后在PreviewerLog窗口查阅用户日志。
预览器热加载时出现白屏
问题现象
升级DevEco Studio后,使用3.2.10.6版本以前的OpenHarmony SDK,在使用预览器热加载时出现白屏。
解决措施
该现象是旧版本SDK已知问题,请将OpenHarmony SDK升级至3.2.10.6及以上版本。
