【HarmonyOS NEXT】FAQ之DevEco Studio(环境准备)

1、Node.js版本与API配套关系

A:匹配关系见下表:

API LevelNode.js支持范围
API Level≥1014.x(≥14.19.1)、16.x、18.x

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

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

img

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

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

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

img

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

  1. 进入Git安装目录(默认为C:\Program Files\Git),双击运行“git-cmd.exe”文件。

  2. 在打开的命令行窗口中,执行如下命令关闭SSL证书校验功能。

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

    git config --global http.sslVerify false
  3. 执行完成后,请重新尝试导入Sample。

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

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

img

A:可能因为使用的PC的系统语言是英文,区域码是US所致。按照以下方式,将区域码修改为CN,在修改前请先关闭DevEco Studio。

在 C:\Users*username\AppData\Roaming\Huawei\DevEcoStudio4.1\options 路径下(MacOS路径为/Users/username*/Library/Application Support/Huawei/DevEcoStudio4.1/options),打开 country.region.xml ,修改countryregion name为“CN”。

<application>    <component name="CountryRegionSetting">        <countryregion name="CN"/>    </component></application>

5、在Mac(M2)上出现弹窗提示“'ld'命令需要使用命令行开发者工具”

在Mac(M2)上,创建C++工程或添加C++模块时,出现弹框“'ld'命令需要使用命令行开发者工具”

img

A:请点击“安装”,继续完成创建工程或添加模块即可。

6、DevEco Studio无法打开

在Windows 10和Windows 11中,修改字符编码后,安装在中文目录下的DevEco Studio无法打开,报错“Error launching...”。

A:请在英文目录下重新安装DevEco Studio。

7、安装npm包失败的处理办法

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

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

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

8、如何在命令行使用ohpm

安装ohpm之后,不能直接在命令行中使用ohpm。

A:

解决措施

  1. 将ohpm安装bin目录,添加至环境变量中。

    点击放大

  2. 添加完变量后重开命令行窗口,执行ohpm -v查看ohpm版本号,终端输出版本号信息(如1.0.0)即为成功。

    img

9、环境检查时显示ohpm registry access不通过

A:

问题现象1

registry地址校验连接不通过,详细信息提示“check whether the ohpm repository is correctly set”。

img

解决措施

  • 场景一:可能是配置的registry错误,请点击提示中"Click here",检查registry配置是否正确或配置新的registry地址。

  • 场景二

    :可能是网络不通,需要配置代理。可采用以下两种操作进行配置:

    方法1:点击提示中"Click here",进入代理配置界面,进行HTTP proxy配置;

    方法2:修改“C:\users\用户名.ohpm”目录下的.ohpmrc文件(如果该目录下没有.ohpmrc文件,请新建一个),修改http_proxy或https_proxy配置项。

    如果代理服务器需要认证(需要用户名和密码),请根据如下指导配置代理服务器的用户名和密码信息。

    1. 进入C:\Users\用户名目录.ohpm,打开.ohpmrc文件。如果该目录下没有.ohpmrc文件,请新建一个。

    2. 修改ohpm代理信息,在http_proxy和https_proxy中,增加user和password字段,具体取值请以实际代理信息为准。示例如下所示:

      http_proxy=http://user:password@proxy.server.com:80https_proxy=http://user:password@proxy.server.com:80

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

      • !:%21

      • @:%40

      • #:%23

      • $:%24

      • &:%26

      • *:%2A

    3. 代理配置完成后,打开命令行工具,执行如下命令验证网络是否正常。

      ohpm info @ohos/lottie

      执行结果如下图所示,则说明代理设置成功。

      img

问题现象2

registry证书地址校验不通过,详细信息提示“UNABLE_TO_VERIFY_LEAF_SIGNATURE”。

img

解决措施

该问题可能是校验registry证书时出现问题。

进入C:\Users\用户名目录.ohpm,打开.ohpmrc文件。如果该目录下没有.ohpmrc文件,请新建一个。

  • 将registry对应的证书地址,配置在ca_files字段中(多个证书路径采用英文逗号分隔)

    ca_files=your_ca_files_path
  • 或者配置strict_ssl=false,暂时屏蔽证书校验

    strict_ssl=false

    屏蔽证书校验,可能会带来安全风险,请确认屏蔽证书校验风险后再修改配置,建议使用完成后及时开启。开启方法:将该配置中的false修改为true即可。

10、流水线场景使用命令行工具sdkmgr下载Linux SDK失败

使用命令行工具sdkmgr在linux上使用时提示“Failed to request url https://devecostudio-dre.op.hicloud.com/sdkmanager/v5/hos/getSdkList

img

A:该问题一般是由于Linux的国家码不是中国区。

  1. 进入sdkmgr所在的文件夹。

    cd ${命令行工具根目录}/sdkmanager/bin

    img

  2. 打开sdkmgr文件。

    vim sdkmgr

    img

  3. 在sdkmgr文件的最后一行“-Dfile.encoding=UTF-8”后添加国家码“-Duser.country=CN”。

    img

  4. 保存修改,再次执行sdkmgr相关的命令即可正常下载Linux SD

11、ohpm-repo是否支持对HSP包的管理

A:目前ohpm-repo支持的包管理有.har和.tgz两种。对于HSP只支持应用内HSP,应用间HSP暂不支持。

在使用ohpm-repo中可以参考:三方中心仓

12、自动签名时提示“The signature does not take effect or has expired. It may be the current system time is inaccurate, please calibrate the system time and sign again”错误

A:本地PC和服务器时间不一致,把本地PC和北京时间对比一下,精确到秒。

IDE签名提示系统时间不对:以管理员身份运行cmd,执行该命令:net time /Domain:china.huawei.com /set /y

也可以可以在设置-日期与时间-开启自动设置时间,尽量精确到1-2秒

13、DevEco Studio中如何设置超长日志自动换行

A:打开Soft-Wrap功能即可控制日志消息自动换行。

点击放大

日志单条打印最大长度为4096个字符。建议在应用的日志框架中,对于打印的日志长度进行判断,若超过一定长度分段打印,避免日志丢失。

更多详情查看:文档中心

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值