HarmonyOS Developer DevEco Studio常见问题

丶龙八夷
发布于 2023-4-6 11:59
浏览
0收藏

概述

环境准备

工程管理

​打开工程时,提示“Module Check Failed”​

代码编辑

预览器

编译构建

调试运行

登录授权

远程模拟器

本地模拟器

相关资源

环境准备

JS SDK安装失败处理指导

问题现象

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

HarmonyOS Developer DevEco Studio常见问题-鸿蒙开发者社区

解决措施

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

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

npm cache clean -f
  1. 在欢迎页点击Configure(或


HarmonyOS Developer DevEco Studio常见问题-鸿蒙开发者社区

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

HarmonyOS Developer DevEco Studio常见问题-鸿蒙开发者社区

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

问题现象

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

HarmonyOS Developer DevEco Studio常见问题-鸿蒙开发者社区

解决措施

该问题一般是由于网络受限导致,请检查网络连接状态。如果网络受限,需要通过代理服务器访问网络,请执行以下操作,配置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. 执行完成后,请重新尝试导入Sample。

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

问题现象

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

HarmonyOS Developer DevEco Studio常见问题-鸿蒙开发者社区

解决措施

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

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

说明

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

git config --global http.sslVerify false

  1. 执行完成后,请重新尝试导入Sample。

下载HarmonyOS SDK时,提示网络连接错误

问题现象

网络连接正常,下载HarmonyOS SDK时,却提示网络连接错误。

HarmonyOS Developer DevEco Studio常见问题-鸿蒙开发者社区

解决措施

可能因为使用的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"字段。

HarmonyOS Developer DevEco Studio常见问题-鸿蒙开发者社区

解决措施

该问题是由于DevEco Studio升级至3. 1 Canary1版本后,会对Har模块进行校验。包括是否存在hvigorfile.ts文件,以及Har模块的package.json文件是否存在"type": "module"字段。请根据如下方式进行解决:

  • 重新打开该工程,DevEco Studio会弹出“Module Check”窗口,单击OK按钮DevEco Studio会自动进行处理。

HarmonyOS Developer DevEco Studio常见问题-鸿蒙开发者社区

  • 手动将工程中所以Har模块的hvigorfile.js文件修改为hvigorfile.ts,并在模块下的package.json中添加"type": "module"字段。

HarmonyOS Developer DevEco Studio常见问题-鸿蒙开发者社区

代码编辑

编辑器自动联想、跳转等功能失效的处理指导

问题现象

在DevEco Studio上进行代码编辑时,代码自动联想、代码跳转等功能失效。

解决措施

导致该问题的可能原因是工程文件所在的目录存在中文字符,请将该工程移动到全英文目录下,然后重新打开工程即可。

预览器

xml中引入三方组件后不能预览的处理办法

问题现象

在xml布局文件中,如果引入了三方的插件,在预览时会无法正常显示引入的组件。如下图所示,在引入了<com.andexert.library.RippleView>组件后,在预览界面并没有显示该组件的效果。

HarmonyOS Developer DevEco Studio常见问题-鸿蒙开发者社区

解决措施

该问题是由于与代码混淆工程存在冲突,您可以在xml开发过程中,先关闭代码混淆功能,然后在编译构建HAP/APP时,再重新打开代码混淆功能。

代码混淆功能关闭方法:打开工程目录中,模块下的build.gradle文件,将proguardEnabled设置为false,然后重新预览即可查阅组件效果,如下所示。

HarmonyOS Developer DevEco Studio常见问题-鸿蒙开发者社区

HarmonyOS API 5 JS工程list卡片组件在wearable设备上显示异常

问题现象

HarmonyOS API5 JS工程list卡片组件在wearable设备上只显示在表盘下半部分。

HarmonyOS Developer DevEco Studio常见问题-鸿蒙开发者社区

解决措施:

将工程和模块下的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进行同步。

HarmonyOS Developer DevEco Studio常见问题-鸿蒙开发者社区

  1. 重启预览器,然后在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​

分类
标签
已于2023-4-6 11:59:54修改
收藏
回复
举报
回复
    相关推荐