OpenHarmony—环境准备

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》的学习导图，从入门到进阶再到南北向开发实战的一整套完整体系，想要学习了解更多鸿蒙开发的相关知识可以借鉴：《一小时快速认识HarmonyOS》

除了上面整理的思维导图以外，这里还特别整理的一份《鸿蒙 (Harmony OS)开发学习手册》给大家进行参考学习：

一、入门必看

1.应用开发导读(ArkTS)

2.……
二、HarmonyOS 概念

1.系统定义

2.技术架构

3.技术特性

4.系统安全

5..…
三、如何快速入门？《鸿蒙HarmonyOS分布式项目实战》

1.基本概念

2.构建第一个ArkTS应用

3.构建第一个JS应用

4……
四、开发基础知识

1.应用基础知识

2.配置文件

3.应用数据管理

4.应用安全管理

5.应用隐私保护

6.三方应用调用管控机制

7.资源分类与访问

8.学习ArkTS语言

9.……
五、基于ArkTS 开发

1.Ability开发

2.UI开发

3.公共事件与通知

4.窗口管理

5.媒体

6.安全

7.网络与链接

8.电话服务

9.数据管理

10.后台任务(Background Task)管理

11.设备管理

12.设备使用信息统计

13.DFX

14.国际化开发

15.折叠屏系列

16.……
更多了解更多鸿蒙开发的相关知识可以参考：《鸿蒙4.0源码开发架构分析pdf》