OpenHarmony应用/服务开发前配置开发环境

参考信息

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

下载OpenHarmony SDK

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

组件名称	说明
JS	JS语言SDK包。
eTS	eTS（Extended TypeScript） SDK包。
Native	C++语言SDK包。
Toolchains	SDK工具链，OpenHarmony应用/服务开发必备工具集，包括编译、打包、签名、数据库管理等工具的集合。
Previewer	OpenHarmony应用预览器，可以在应用开发过程中查看界面UI布局效果。

OpenHarmony应用/服务支持API

Version 8至9，第一次使用DevEco Studio，工具的配置向导会引导您下载OpenHarmony
SDK及工具链。配置向导默认下载 API Version 8的SDK及工具链，如需API Version
9，可在工程配置完成后，进入OpenHarmony SDK界面手动下载。

OpenHarmony SDK支持API Version 8和9，

运行已安装的DevEco Studio，首次使用，请选择 Do not import settings ，点击OK。
进入DevEco Studio操作向导页面，设置 npm registry ，DevEco Studio已预置对应的仓，直接点击Start using DevEco Studio进入下一步。

说明
如果配置向导界面出现的是设置Set up HTTP Proxy界面，说明网络受限，请根据参考信息配置DevEco Studio代理和NPM代理后，再下载OpenHarmony SDK。

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

等待Node.js安装完成。安装完成后，点击Finish完成Node.js安装。

3. 在SDK Componets Setup界面，设置OpenHarmony SDK下载路径，如果需要开发HarmonyOS应用，请勾选上HarmonyOS SDK，点击Next进入下一步。

说明
OpenHarmony SDK和HarmonyOS SDK不能设置为同一个路径，且路径中不能包含中文字符。

4. 在弹出的SDK下载信息页面，点击 Next ，并在弹出的License Agreement窗口，点击Accept开始下载SDK。

说明
下载SDK过程中，如果出现下载JS SDK失败，提示“Install js dependencies failed”，请根据JS SDK安装失败处理指导进行处理。

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

默认下载API Version 8的SDK及工具链，如需下载其它版本SDK，请在OpenHarmony SDK界面手动下载，进入方法如下：

在DevEco Studio欢迎页，点击 Configure （或图标）** > Settings**** > OpenHarmony SDK**进入SDK Manager界面（macOS系统为 Configure > Preferences > OpenHarmony SDK ）。
在DevEco Studio打开工程的情况下，点击Files > Settings > OpenHarmony SDK进入（macOS系统为 DevEco Studio > Preferences > OpenHarmony SDK ）。

参考信息

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

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

如果是首次使用DevEco Studio，配置向导界面出现Set up HTTP Proxy界面，如果您通过代理服务器上网，可以通过配置代理的方式来解决，包括配置DevEco Studio代理和NPM代理。

配置DevEco Studio代理

启动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 ：勾选，记住密码。

配置完成后，点击 Check connection ，输入任意网络地址，检查网络连通性。提示**“Connection successful”**表示代理设置成功。
点击Next: Configure npm继续设置NPM代理信息，请参考配置NPM代理。

配置NPM代理

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

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

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

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

如果代理服务器需要认证（需要用户名和密码），请先根据如下指导配置代理服务器的用户名和密码信息，然后再下载OpenHarmony SDK；否则，请跳过该操作，参考下载OpenHarmony SDK进行操作即可。
1. 进入用户的users目录，打开“.npmrc”文件，如果该目录下没有**.npmrc**文件，请新建一个。

修改npm代理信息，在proxy和https-proxy中，增加user和password字段，具体取值请以实际代理信息为准。示例如下所示：
```
proxy=http://user:password@proxy.server.com:port
https-proxy=http://user:password@proxy.server.com:port
```