OpenHarmony—环境准备

news2024/9/21 19:05:01

JS SDK安装失败处理指导

问题现象

下载JS SDK时，下载失败，提示“Install Js dependencies failed”。在这里插入图片描述
解决措施

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

1.检查网络是否受限，如果需要通过代理才能访问网络，可根据NPM代理配置指导，配置代理服务器信息。如果网络不受限，可跳过该步骤。

2.请进入到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代理信息。

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

2.在打开的命令行窗口中，执行以下命令配置代理服务器信息（将proxyUsername、ProxyPassword、proxyserver和port按照实际代理服务器进行修改）。

DOC.NOTE
如果password中存在特殊字符，如@、#、*等符号，可能导致配置不生效，建议将特殊字符替换为ASCII码，并在ASCII码前加百分号%。常用符号替换为ASCII码对照表如下：
!：%21
@：%40
#：%23
￥：%24
&：%26
*：%2A

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

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证书校验功能。

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

git config --global http.sslVerify false

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>

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

问题现象

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

解决措施

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

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

那么要想成为一名鸿蒙高级开发，以上知识点是必须要掌握的，除此之外，还需要掌握一些鸿蒙应用开发相关的一些技术，需要我们共同去探索。

为了节省大家一些查找的时间，这边联合几位行业大佬，为大家准备了一份《OpenHarmony4.0&Next》的学习导图，从入门到进阶再到南北向开发实战的一整套完整体系，想要学习了解更多鸿蒙开发的相关知识可以借鉴：《鸿蒙4.0源码开发架构分析pdf》
在这里插入图片描述
除了上面整理的思维导图以外，这里还特别整理的一份《鸿蒙 (Harmony OS)开发学习手册》给大家进行参考学习：