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，提示“找不到应用程序”​​
• ​​点击“允许”后，浏览器提示“无法访问此网站”​​
• ​​登录时浏览器提示不安全，“你的连接不是私密连接”​​

远程模拟器

• ​​申请模拟器提示HDC工具未安装​​
• ​​HDC通道的端口被占用的处理指导​​

本地模拟器

• ​​启动模拟器，提示磁盘空间不足​​
• ​​启动模拟器，提示镜像文件缺失​​
• ​​启动模拟器，提示SDK路径已更改​​
• ​​macOS系统启动模拟器，提示共享内存不足​​
• ​​启动模拟器，提示无法启动模拟器​​
• ​​启动模拟器，提示无法安装HAXM​​
• ​​启动模拟器，提示VT/NX不可用​​
• ​​启动模拟器，提示无法安装GVM​​
• ​​通过命令行启动模拟器，提示非法的启动方式​​
• ​​本地模拟器支持C++工程调试​​
• ​​启动模拟器，超时无响应​​
• ​​启动模拟器，提示“多个视频控制器正在运行，请确保只启用一个”​​

相关资源

• ​​应用审核相关FAQ​​
• ​​智能助手​​：通过问答的形式，直接获取常见问题的解决方法。
• ​​开发者论坛​​：官方问题反馈渠道，方便开发者进行问题讨论。

环境准备

JS SDK安装失败处理指导

问题现象

下载JS SDK时，下载失败，提示“Install Js dependencies failed”。

解决措施

JS SDK下载失败，一般情况下，主要是由于npm代理配置问题，或未清理npm缓存信息导致，可按照如下方法进行处理。

1. 检查网络是否受限，如果需要通过代理才能访问网络，可根据​​NPM代理配置​​指导，配置代理服务器信息。如果网络不受限，可跳过该步骤。
2. 请进入到DevEco Studio安装目录下的tools\nodejs目录下打开命令行工具，执行如下命令，清理npm缓存。

npm cache clean -f
1.

3. 在欢迎页点击Configure（或

图标） > Settings > SDKs，勾选JS SDK，点击Apply重新进行下载。

导入Sample时，提示连接Gitee超时

问题现象

导入Sample时，导入失败，提示“Failed to connect to gitee.com port 443: Time out”连接超时。

解决措施

该问题一般是由于网络受限导致，请检查网络连接状态。如果网络受限，需要通过代理服务器访问网络，请执行以下操作，配置git代理信息。

1. 进入Git安装目录（默认为C:\Program Files\Git），双击运行“git-cmd.exe”文件。
2. 在打开的命令行窗口中，执行以下命令配置代理服务器信息（将proxyUsername、ProxyPassword、proxyserver和port按照实际代理服务器进行修改）。

说明

如果password中存在特殊字符，如@、#、*等符号，可能导致配置不生效，建议将特殊字符替换为ASCII码，并在ASCII码前加百分号%。常用符号替换为ASCII码对照表如下：

• !：%21
• @：%40
• #：%23
• ￥：%24
• &：%26
• *：%2A

git config --global http.proxy http://proxyUsername:proxyPassword@proxy.server.com:port
1.

3. 执行完成后，请重新尝试导入Sample。

导入Sample时，提示SSL证书校验错误

问题现象

导入Sample时，导入失败，提示“SSL certificate problem: unable to get local issuer certificate”证书校验错误。

解决措施

出现这个错误可能是网络遭受了攻击，或者你的网络提供方网络策略阻止了相关操作，如果你确认所处的网络环境安全，可以临时关闭证书校验以获取Sample。

1. 进入Git安装目录（默认为C:\Program Files\Git），双击运行“git-cmd.exe”文件。
2. 在打开的命令行窗口中，执行如下命令关闭SSL证书校验功能。

说明

关闭SSL证书校验，可能会带来安全风险，建议导入完Sample后，及时开启。开启方法：将该命令中的false修改为true即可。

git config --global http.sslVerify false
1.

3. 执行完成后，请重新尝试导入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”。

<application>
    <component name="CountryRegionSetting">
        <countryregion name="CN"/>
    </component>
</application>
1.
2.
3.
4.
5.

安装OpenHarmony npm包失败的处理办法

问题现象

在执行npm install命令安装OpenHarmony npm仓时，提示安装失败。

解决措施

可能是由于未设置OpenHarmony npm仓的地址，可执行如下命令后进行重新安装。

npm config set @ohos:registry=https://repo.harmonyos.com/npm/
1.

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。

1. 分别打开工程根目录和模块根目录下的build.gradle文件，将compileSdkVersion修改成6或7。
2. 点击Sysc Now进行同步。

3. 重启预览器，然后在PreviewerLog窗口查阅用户日志。

预览器热加载时出现白屏

问题现象

升级DevEco Studio后，使用3.2.10.6版本以前的OpenHarmony SDK，在使用预览器热加载时出现白屏。

解决措施

该现象是旧版本SDK已知问题，请将OpenHarmony SDK升级至3.2.10.6及以上版本。

文章转载自:​​https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/faq-previewer-operating-0000001295796698-V3​​