1、Node.js版本与API配套关系
A:匹配关系见下表:
API Level | Node.js支持范围 |
---|---|
API Level≥10 | 14.x(≥14.19.1)、16.x、18.x |
2、导入Sample时,提示连接Gitee超时
导入Sample时,导入失败,提示“Failed to connect to gitee.com port 443: Time out”连接超时。
A:该问题一般是由于网络受限导致,请检查网络连接状态。如果网络受限,需要通过代理服务器访问网络,请执行以下操作,配置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。
3、导入Sample时,提示SSL证书校验错误
导入Sample时,导入失败,提示“SSL certificate problem: unable to get local issuer certificate”证书校验错误。
A:出现这个错误可能是网络遭受了攻击,或者你的网络提供方网络策略阻止了相关操作,如果你确认所处的网络环境安全,可以临时关闭证书校验以获取Sample。
-
进入Git安装目录(默认为C:\Program Files\Git),双击运行“git-cmd.exe”文件。
-
在打开的命令行窗口中,执行如下命令关闭SSL证书校验功能。
关闭SSL证书校验,可能会带来安全风险,建议导入完Sample后,及时开启。开启方法:将该命令中的false修改为true即可。
git config --global http.sslVerify false
-
执行完成后,请重新尝试导入Sample。
4、下载HarmonyOS SDK时提示网络连接错误
网络连接正常,下载HarmonyOS SDK时,却提示网络连接错误。
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'命令需要使用命令行开发者工具”
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:
解决措施
-
将ohpm安装bin目录,添加至环境变量中。
-
添加完变量后重开命令行窗口,执行ohpm -v查看ohpm版本号,终端输出版本号信息(如1.0.0)即为成功。
9、环境检查时显示ohpm registry access不通过
A:
问题现象1
registry地址校验连接不通过,详细信息提示“check whether the ohpm repository is correctly set”。
解决措施
-
场景一:可能是配置的registry错误,请点击提示中"Click here",检查registry配置是否正确或配置新的registry地址。
-
场景二
:可能是网络不通,需要配置代理。可采用以下两种操作进行配置:
方法1:点击提示中"Click here",进入代理配置界面,进行HTTP proxy配置;
方法2:修改“C:\users\用户名.ohpm”目录下的.ohpmrc文件(如果该目录下没有.ohpmrc文件,请新建一个),修改http_proxy或https_proxy配置项。
如果代理服务器需要认证(需要用户名和密码),请根据如下指导配置代理服务器的用户名和密码信息。
-
进入C:\Users\用户名目录.ohpm,打开.ohpmrc文件。如果该目录下没有.ohpmrc文件,请新建一个。
-
修改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
-
-
代理配置完成后,打开命令行工具,执行如下命令验证网络是否正常。
ohpm info @ohos/lottie
执行结果如下图所示,则说明代理设置成功。
-
问题现象2
registry证书地址校验不通过,详细信息提示“UNABLE_TO_VERIFY_LEAF_SIGNATURE”。
解决措施
该问题可能是校验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”
A:该问题一般是由于Linux的国家码不是中国区。
-
进入sdkmgr所在的文件夹。
cd ${命令行工具根目录}/sdkmanager/bin
-
打开sdkmgr文件。
vim sdkmgr
-
在sdkmgr文件的最后一行“-Dfile.encoding=UTF-8”后添加国家码“-Duser.country=CN”。
-
保存修改,再次执行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个字符。建议在应用的日志框架中,对于打印的日志长度进行判断,若超过一定长度分段打印,避免日志丢失。
更多详情查看:文档中心