回复
添加资源
添加资源将有机会获得更多曝光，你也可以直接关联已上传资源
去关联
HarmonyOS Developer DevEco Studio常见问题
丶龙八夷
发布于 2023-4-6 11:59
浏览
0收藏
概述
环境准备
- 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缓存。
npm cache clean -f- 在欢迎页点击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
git config --global http.proxy http://proxyUsername:proxyPassword@proxy.server.com:port
- 执行完成后，请重新尝试导入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即可。
git config --global http.sslVerify false
- 执行完成后，请重新尝试导入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>安装OpenHarmony npm包失败的处理办法
问题现象
在执行npm install命令安装OpenHarmony npm仓时，提示安装失败。
解决措施
可能是由于未设置OpenHarmony npm仓的地址，可执行如下命令后进行重新安装。
npm config set @ohos:registry=https://repo.harmonyos.com/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及以上版本。
分类
标签
已于2023-4-6 11:59:54修改
赞
收藏
回复
相关推荐
