-

DevEco Studio 开发环境需要依赖于网络环境,需要连接上网络才能确保工具的正常使用,可以根据如下两种情况来配置开发环境:

  • 如果可以直接访问 Internet,只需进行[设置npm仓库]和[下载HarmonyOS SDK] 操作。
  • 如果网络不能直接访问 Internet,需要通过代理服务器才可以访问,请根据本章节内容逐条设置开发环境。

npm 设置

设置 npm 代理

只有在同时满足以下两个条件时,需要配置 npm 代理,否则,请跳过本章节。

  • 需要使用 JS 语言开发 HarmonyOS 应用。
  • 网络不能直接访问 Internet,而是需要通过代理服务器才可以访问。这种情况下,配置 npm 代理,便于从 npm 服务器下载 JS 依赖。

打开命令行工具,按照如下方式进行 npm 代理设置和验证。

  1. 执行如下命令设置 npm 代理。

  • 如果使用的代理服务器需要认证,请按照如下方式进行设置(请将 user、password、proxyserver 和 port 按照实际代理服务器进行修改)。

     npm config set proxy http://user:password@proxyserver:portnpm config set https-proxy http://user:password@proxyserver:port

  • 如果使用的代理服务器不需要认证(不需要帐号和密码),请按照如下方式进行设置。

     npm config set proxy http:proxyserver:portnpm config set https-proxy http:proxyserver:port

  1. 代理设置完成后,执行如下命令进行验证。

   npm info express

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

点击放大

设置 npm 仓库

为了提升[下载 JS SDK]时,使用 npm 安装 JS 依赖的速度,建议在命令行工具中执行如下命令,重新设置 npm 仓库地址。

npm config set registry https://mirrors.huaweicloud.com/repository/npm/

设置Gradle代理

如果网络不能直接访问 Internet,而是需要通过代理服务器才可以访问,这种情况下,需要设置 Gradle 代理,来访问和下载 Gradle 所需的依赖。否则,请跳过本章节。

  1. 打开“此电脑”,在文件夹地址栏中输入 %userprofile%,进入个人数据界面。

点击放大

  1. 创建一个文件夹,命名为 .gradle.。如果已有 .gradle 文件夹,请跳过此操作。

  1. 进入.gradle文件夹,新建一个文本文档,命名为 gradle,并修改后缀为 .properties

  1. 打开gradle.properties文件中,添加如下脚本,然后保存。

其中代理服务器、端口、用户名、密码和不使用代理的域名,请根据实际代理情况进行修改。其中不使用代理的 “nonProxyHosts”的配置间隔符是 “|”。

   systemProp.http.proxyHost=proxy.server.comsystemProp.http.proxyPort=8080systemProp.http.nonProxyHosts=*.company.com|10.*|100.*systemProp.http.proxyUser=userIdsystemProp.http.proxyPassword=passwordsystemProp.https.proxyHost=proxy.server.comsystemProp.https.proxyPort=8080systemProp.https.nonProxyHosts=*.company.com|10.*|100.*systemProp.https.proxyUser=userIdsystemProp.https.proxyPassword=password

设置 DevEco Studio 代理

如果网络不能直接访问 Internet,而需要通过代理服务器才可以访问,这种情况下,需要设置 DevEco Studio 代理,来访问和下载外部资源。否则,请跳过本章节。

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

  1. 根据 DevEco Studio 欢迎界面的提示,点击 Setup Proxy,或者在欢迎页点击Configure > Settings > Appearance&Behavior > System Settings > HTTP Proxy进入 HTTP Proxy 设置界面。 点击放大

  1. 设置 DevEco Studio 的 HTTP Proxy 信息。

  • HTTP

配置项,设置代理服务器信息。

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

  • Proxy authentication

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

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

  1. 配置完成后,点击 Check connection,输入网络地址(如:https://developer.harmonyos.com),检查网络连通性。提示“Connection successful”表示代理设置成功。

  1. 点击 OK 按钮完成 DevEco Studio 代理配置。

  1. DevEco Studio 代理设置完成后,会提示安装 HarmonyOS SDK,可以点击 Next 下载到默认目录中;如果想更改 SDK 的存储目录,请点击 Cancel,并根据 [ 下载HarmonyOS SDK ] 进行操作。

img

下载 HarmonyOS SDK

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

SDK Manager 提供多种编程语言的 SDK 包,各 SDK 包的说明请参考:

  • Native:C/C++ 语言 SDK 包,默认不自动下载,需手动勾选下载。对应的接口文档请参考《Native API参考》
  • JS:JS 语言 SDK 包,默认不自动下载,需手动勾选下载。对应的接口文档请参考《JS API参考》
  • Java:Java语言SDK包,首次下载SDK时默认下载。对应的接口文档请参考《Java API参考》

同时还提供 SDK 对应的工具链(SDK Tools):

  • Toolchains:SDK 工具链,HarmonyOS 应用开发必备工具集,包括编译、打包、签名、数据库管理等工具的集合,首次下载 SDK 时默认下载。
  • Previewer:Lite Wearable 预览器,在开发过程中可以动态预览 Lite Wearable 应用的界面呈现效果,默认不自动下载,需手动勾选下载。

首次下载 HarmonyOS SDK 时,只会 默认下载 **Java SDK 和 Toolchains**。因此,如果还需要使用 JS 或 C/C++ 语言开发应用时,需手动下载对应的SDK包。

  1. 在菜单栏点击 Configure > Settings 或者默认快捷键 Ctrl+Alt+S,打开 Settings 配置界面。

  1. 进入 Appearance&Behavior > System Settings > HarmonyOS SDK菜单界面,点击 Edit 按钮,设置 HarmonyOS SDK 存储路径。

点击放大

  1. 选择 HarmonyOS SDK 存储路径(不能包含中文),然后点击 Next。在弹出的 License Agreement 窗口,点击 Accept 开始下载 SDK。

说明

如果本地已有 SDK 包,请选择本地已有 SDK 包的存储路径,DevEco Studio 会增量更新 SDK 及工具链。

  1. 等待 HarmonyOS SDK 及工具下载完成,点击 Finish,可以看到默认的 SDK Platforms > Java SDK及SDK Tools > Toolchains 已完成下载。

点击放大

  1. 如果工程还会用到 JS 或者 C/C++ 语言,请在 SDK Platform 中,勾选对应的 SDK 包,点击 Apply,SDK Manager 会自动将 SDK 包和工具链,下载到3中设置的 SDK 存储路径中。(JS SDK 下载失败或者缓慢?

点击放大

开发环境配置完成后,可以通过运行HelloWorld工程来验证环境设置是否正确。