鸿蒙OpenHarmony Studio配置开发环境

在进行OpenHarmony应用/服务开发前，需要提前在DevEco Studio中下载对应版本的SDK。下载OpenHarmony SDK需要连接网络，一般情况下，可以直接下载；但部分用户的网络可能受限，此时需要先根据​​参考信息​​配置相应的代理信息，确保网络可正常访问后，再下载SDK。

下载OpenHarmony SDK及工具链

DevEco Studio通过SDK Manager统一管理SDK及工具链，OpenHarmony包含如下SDK包：

OpenHarmony应用/服务支持API Version 7至9，首次使用DevEco Studio，工具的配置向导会引导您下载OpenHarmony SDK及工具链。配置向导默认下载 API Version 9的SDK及工具链，如需API Version 7和8，可在工程配置完成后，进入OpenHarmony SDK界面手动下载，方法如下：

在DevEco Studio欢迎页，单击Configure> Settings > SDKs > OpenHarmony界面（macOS系统为Configure > Preferences > SDKs > OpenHarmony）。

在DevEco Studio打开工程的情况下，单击Files > Settings > SDKs > OpenHarmony进入（macOS系统为DevEco Studio > Preferences > SDKs > OpenHarmony）。

接下来介绍首次启动DevEco Studio的配置向导：

1、运行已安装的DevEco Studio，首次使用，请选择Do not import settings，单击OK。

2、进入DevEco Studio操作向导页面，修改npm registry和ohos registry，DevEco Studio已预置对应的仓（默认的npm仓，可能出现部分开发者无法访问或访问速度缓慢的情况），直接单击Start using DevEco Studio进入下一步。

3、设置Node.js信息，可以指定本地已安装的Node.js（Node.js版本要求为v14.19.1及以上，且低于v15.0.0；对应的npm版本要求为6.14.16及以上，且低于7.0.0版本）；如果本地没有合适的版本，可以选择Download按钮，在线下载Node.js。本示例以下载Node.js为例，选择下载源和存储路径后，单击Next进入下一步。

等待Node.js安装完成，然后单击Finish进入下一步。

4、在SDK Componets Setup界面，如果您只开发OpenHarmony应用/服务，可无须下载HarmonyOS SDK，点击Cancel取消，进入DevEco Studio欢迎页。如需下载HarmonyOS SDK，可参考​​下载HarmonyOS SDK​​章节。

5、点击Configure > Settings >SDKs > OpenHarmony，进入OpenHarmony SDK管理界面。

6、单击上图中的Edit按钮，设置OpenHarmony SDK的存储路径，然后单击Next进入下一步。

7、在弹出的SDK下载信息页面，单击Next，并在弹出的License Agreement窗口，阅读License协议，需同意License协议后，单击Next开始下载SDK。

8、等待OpenHarmony SDK及工具下载完成，单击Finish，界面会进入到DevEco Studio欢迎页。

诊断开发环境

为了您开发应用/服务的良好体验，DevEco Studio提供了开发环境诊断的功能，帮助您识别开发环境是否完备。您可以在欢迎界面单击Help > Diagnose Development Environment进行诊断。如果您已经打开了工程开发界面，也可以在菜单栏单击Help > Diagnostic Tools > Diagnose Development Environment进行诊断。

DevEco Studio开发环境诊断项包括电脑的配置、网络的连通情况、依赖的工具或SDK等。如果检测结果为未通过，请根据检查项的描述和修复建议进行处理。

参考信息

DevEco Studio开发环境依赖于网络环境，需要连接上网络才能确保工具的正常使用。

一般来说，如果使用的是个人或家庭网络，是不需要配置代理信息的；只有部分企业网络受限的情况下，才需要配置代理信息。

首次使用DevEco Studio，如果配置向导界面出现Set up HTTP Proxy界面，可能需要通过配置代理服务器才能访问，请配置DevEco Studio代理和NPM代理。

配置DevEco Studio代理

1、启动DevEco Studio，配置向导进入Set up HTTP Proxy界面，勾选Manual proxy configuration，设置DevEco Studio的HTTP Proxy。

如果非首次设置向导进入HTTP Proxy，可以通过如下方式进入HTTP Proxy配置界面：

在欢迎页单击Configure > Settings > Appearance & Behavior > System Settings > HTTP Proxy进入HTTP Proxy设置界面（macOS为Configure > Preferences > Appearance & Behavior > System Settings > HTTP Proxy）。

在打开了工程的情况下，可以单击File > Settings > Appearance & Behavior > System Settings > HTTP Proxy进入HTTP Proxy设置界面（macOS为DevEco Studio > Preferences > Appearance & Behavior > System Settings > HTTP Proxy）。

HTTP配置项，配置代理服务器信息。如果不清楚代理服务器信息，请咨询您的网络管理人员。

• Host name：代理服务器主机名或IP地址。
• Port number：代理服务器对应的端口号。
• No proxy for：不需要通过代理服务器访问的URL或者IP地址（地址之间用英文逗号分隔）。

Proxy authentication配置项，如果代理服务器需要通过认证鉴权才能访问，则需要配置。否则，请跳过该配置项。

• Login：访问代理服务器的用户名。
• Password：访问代理服务器的密码。
• Remember：勾选，记住密码。

2、配置完成后，单击Check connection，输入任意网络地址，检查网络连通性。提示“Connection successful”表示代理设置成功。

3、单击Next: Configure npm继续设置NPM代理信息，请参考​​配置NPM代理​​。

配置NPM代理

通过DevEco Studio的配置向导配置NPM代理信息，代理信息将写入用户“users/用户名/”目录下的.npmrc文件。

该向导只有在安装DevEco Studio后首次打开才会出现。如果未出现该向导，可以直接在“users/用户名/”目录下的.npmrc文件中，添加代理配置信息。

• npm registry：配置npm仓的地址信息，建议勾选。
• ohos registry：HarmonyOS npm三方包共享仓。
• HTTP proxy：代理服务器信息，默认会与DevEco Studio的HTTP proxy设置项保持一致。
• Enable Https Proxy：同步配置HTTPS Proxy信息，建议勾选。

然后单击Start using DevEco Studio继续下一步操作。

如果代理服务器需要认证（需要用户名和密码），请先根据如下指导配置代理服务器的用户名和密码信息，然后再下载OpenHarmony SDK；否则，请跳过该操作，参考​​下载OpenHarmony SDK​​进行操作即可。

1. 进入用户的users目录，打开“.npmrc”文件，如果该目录下没有.npmrc文件，请新建一个。

2. 修改npm代理信息，在proxy和https-proxy中，增加user和password字段，具体取值请以实际代理信息为准。示例如下所示：

proxy=http://user:password@proxy.server.com:port
https-proxy=http://user:password@proxy.server.com:port

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

• !：%21
• @：%40
• #：%23
• ￥：%24
• &：%26
• *：%2A

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

npm info express

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

4. 网络设置完成后，再​​下载OpenHarmony SDK​​。