鸿蒙配置开发环境 | 清风明月博客

下载&更新HarmonyOS SDK

DevEco Studio提供SDK Manager统一管理SDK及工具链，下载各种编程语言的SDK包时，SDK Manager会自动下载该SDK包依赖的工具链。

SDK Manager提供多种编程语言的SDK包和工具链，具体说明请参考下表。

类别

包名

说明

默认是否下载

参考

SDK

Native

C/C++语言SDK包。

《Native API参考》

JS语言SDK包。

√

《JS API参考》

Java

Java语言SDK包。

√

《Java API参考》

SDK Tool

Toolchains

SDK工具链，HarmonyOS应用开发必备工具集，包括编译、打包、签名、数据库管理等工具的集合。

√

Previewer

HarmonyOS应用预览器，在开发过程中可以动态预览Phone、TV、Wearable、LiteWearable等设备的应用效果，支持JS和Java应用预览。

√

使用预览器查看应用效果

下载HarmonyOS SDK

第一次使用DevEco Studio，需要下载HarmonyOS SDK及对应工具链。如果是非首次安装DevEco Stduio，SDK下载和更新方法请参考更新HarmonyOS SDK。

说明

HarmonyOS SDK与OpenHarmony SDK不兼容，下载的HarmonyOS SDK并不适用于OpenHarmony工程。加载OpenHarmony SDK和开发OpenHarmony应用，请参考OpenHarmony使用指南。

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

进入配置向导页面，设置npm registry，DevEco Studio已预置对应的仓，直接点击Start using DevEco Studio进入下一步。

说明

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

通过DevEco Studio向导指引开发者下载HarmonyOS SDK，默认情况下，SDK会下载到user目录下，也可以指定对应的存储路径，SDK存储路径不支持中文字符，然后点击Next。

默认会下载最新版本的Java SDK、JS SDK、Previewer和Toolchains。在弹出的License Agreement窗口，点击Accept开始下载SDK。

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

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

SDK默认只会下载最新版本的Java SDK、JS SDK、Previewer和Toolchains，点击上图欢迎页中的Configure（或图标） > Settings，进入HarmonyOS SDK页面，可以下载其它组件，只需要勾选对应的组件包，然后点击Apply即可。

更新HarmonyOS SDK
如果已经下载过HarmonyOS SDK，当存在新版本的SDK时，可以通过SDK Manager来更新对应的SDK。进入SDK Manager的方法：

在DevEco Studio欢迎页，点击Configure（或图标） > Settings > HarmonyOS SDK进入SDK Manager界面（macOS系统为Configure > Preferences > HarmonyOS SDK）。
在DevEco Studio打开工程的情况下，点击Tools > SDK Manager界面进入；或者点击Files > Settings > HarmonyOS SDK进入（macOS系统为DevEco Studio > Preferences > HarmonyOS SDK）。
在SDK Manager中，勾选需要更新的SDK，然后点击Apply，然后在弹出的确认更新窗口，点击OK即可开始更新。

配置HDC工具环境变量

HDC是为开发者提供HarmonyOS应用的调试工具，为方便使用HDC工具，请为HDC工具的端口号设置环境变量。

Windows环境变量设置方法：

在此电脑 > 属性 > 高级系统设置 > 高级 > 环境变量中，添加HDC端口变量。变量名为：HDC_SERVER_PORT，变量值设置为7035。

环境变量配置完成后，关闭并重启DevEco Studio。

macOS环境变量设置方法：

打开终端工具，执行以下命令，打开.bash_profile文件。
vi ./.bash_profile
点击字母“i”，进入Insert模式。
输入以下内容，添加HDC_SERVER_PORT环境变量信息。
HDC_SERVER_PORT=7035
launchctl setenv HDC_SERVER_PORT $HDC_SERVER_PORT
export HDC_SERVER_PORT
编辑完成后，点击“Esc”键，退出编辑模式，然后输入“:wq”，点击“Enter”按钮保存。
执行以下命令，使配置的环境变量生效。
source .bash_profile
环境变量配置完成后，关闭并重启DevEco Studio。
参考信息
DevEco Studio开发环境需要依赖于网络环境，需要连接上网络才能确保工具的正常使用。

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

如果是第一次打开DevEco Studio，配置向导界面出现设置Set up HTTP Proxy界面，说明网络受限，可以通过配置代理的方式来解决，需要配置DevEco Studio代理、NPM代理和Gradle代理。

配置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设置界面（Mac系统为Configure > Preferences > Appearance & Behavior > System Settings > HTTP Proxy）。
在打开了工程的情况下，可以点击File > Settings > Appearance & Behavior > System Settings > HTTP Proxy进入HTTP Proxy设置界面（Mac系统为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，输入网络地址（如：https://developer.harmonyos.com），检查网络连通性。提示“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继续下一步操作。

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

进入用户的users目录，打开.npmrc文件。
修改npm代理信息，在proxy和https-proxy中，增加user和password字段，具体取值请以实际代理信息为准。示例如下所示：
proxy=http://user:password@proxy.server.com:80
https-proxy=http://user:password@proxy.server.com:80
说明
如果password中存在特殊字符，如@、#、*等符号，可能导致配置不生效，建议将特殊字符替换为ASCII码，并在ASCII码前加百分号%。常用符号替换为ASCII码对照表如下：

!：%21
@：%40
#：%23
￥：%24
&：%26
*：%2A
代理设置完成后，打开命令行工具，执行如下命令进行验证网络是否正常。
npm info express
执行结果如下图所示，则说明代理设置成功。

点击放大

网络设置完成后，根据DevEco Studio向导下载HarmonyOS SDK。
设置Gradle代理
打开“此电脑”，在文件夹地址栏中输入%userprofile%（Mac系统请点击前往 > 个人），进入个人用户界面。
点击放大

创建一个文件夹，命名为.gradle。如果已有.gradle文件夹，请跳过此操作。
说明
macOS系统创建.gradle文件夹前，请将系统设置为“显示隐藏文件”。

进入.gradle文件夹，新建一个文本文档，命名为gradle，并修改后缀为.properties。
打开gradle.properties文件中，添加如下脚本，然后保存。
其中代理服务器、端口、用户名、密码和不使用代理的域名，请根据实际代理情况进行修改。其中不使用代理的“nonProxyHosts”的配置间隔符是 “|”。
systemProp.http.proxyHost=proxy.server.com
systemProp.http.proxyPort=8080
systemProp.http.nonProxyHosts=.company.com|10.|100.*
systemProp.http.proxyUser=userId
systemProp.http.proxyPassword=password
systemProp.https.proxyHost=proxy.server.com
systemProp.https.proxyPort=8080
systemProp.https.nonProxyHosts=.company.com|10.|100.*
systemProp.https.proxyUser=userId
systemProp.https.proxyPassword=password