鸿蒙-环境搭建手册js版

1.1 工具简介

​ HUAWEI DevEco Studio（以下简称DevEco Studio）是基于IntelliJ IDEA Community开源版本打造，面向华为终端全场景多设备的一站式集成开发环境（IDE），为开发者提供工程模板创建、开发、编译、调试、发布等E2E的HarmonyOS应用开发服务。通过使用DevEco Studio，开发者可以更高效的开发具备HarmonyOS分布式能力的应用，进而提升创新效率。

 

作为一款开发工具，除了具有基本的代码开发、编译构建及调测等功能外，DevEco Studio还具有如下特点：

 

多设备统一开发环境：支持多种HarmonyOS设备的应用开发，包括智慧屏、智能穿戴，轻量级智能穿戴设备。
支持多语言的代码开发和调试：包括Java、XML（Extensible Markup Language）、C/C++ 、 JS（JavaScript）、CSS（Cascading Style Sheets）和HML（HarmonyOS Markup Language）。

支持 FA（Feature Ability）和 PA（Particle Ability）快速开发：通过工程向导快速创建FA/PA工程模板，一键式打包成HAP（HarmonyOS Ability Package）。
支持多设备模拟器：提供多设备的模拟器资源，包括智慧屏、智能穿戴等设备的模拟器，方便开发者高效调试。

 

2.1 下载与安装软件

 

运行环境要求

 

当前DevEco Studio只支持Windows版本，为保证DevEco Studio正常运行，建议您的电脑配置满足如下要求：

 

操作系统：Windows10 64位
内存：8GB及以上
硬盘：100GB及以上
分辨率：1280*800像素及以上

 

3.1下载和安装DevEco Studio

 

DevEco Studio的编译构建依赖JDK，DevEco Studio预置了Open JDK，版本为1.8，安装过程中会自动安装JDK。

 

登录HarmonysOS应用开发门户，点击右上角注册按钮，注册开发者帐号，注册指导参考注册华为帐号。如果已有华为开发者帐号，请直接点击登录按钮。

 

说明

 

使用DevEco Studio远程模拟器需要华为帐号进行实名认证，建议在注册华为帐号后，立即提交实名认证审核，认证方式包括“个人实名认证”和“企业实名认证”，详情请参考实名认证。

进入HUAWEI DevEco Studio产品页，下载DevEco Studio安装包。

 

双击下载的“deveco-studio-xxxx.exe”，进入DevEco Studio安装向导，在如下安装选项界面勾选DevEco Studio launcher后，点击Next，直至安装完成。

 

3.1.1下载和安装Node.js

Node.js软件仅在使用到JS语言开发HarmonyOS应用时才需要安装。使用其它语言开发，不用安装Node.js，请跳过此章节。

 

说明

 

如果已安装Node.js，打开命令行工具，输入node -v命令，检查版本号信息，建议使用V12.0.0及以上版本。

登录Node.js官方网站，下载Node.js软件包。请选择LTS版本，Windows 64位对应的软件包。

 

点击下载后的软件包进行安装，全部按照默认设置点击Next，直至Finish。安装过程中，Node.js会自动在系统的path环境变量中配置node.exe的目录路径。
软件安装完成后，接下来请配置开发环境。

 

3.1.2配置开发环境

 

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

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

 

3.2.1 npm设置

 

设置npm代理

 

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

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

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

 

执行如下命令设置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

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

npm info express

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

 

设置npm仓库

 

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

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

3.1.3设置Gradle代理

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

 

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

 

创建一个文件夹，命名为**.gradle.**。如果已有.gradle文件夹，请跳过此操作。
进入.gradle文件夹，新建一个文本文档，命名为gradle，并修改后缀为**.properties**。
打开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

3.1.4 设置DevEco Studio代理

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

 

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

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

 

设置DevEco Studio的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”表示代理设置成功。

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

 

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

 

 

4.1 下载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包。

在菜单栏点击Configure > Settings或者默认快捷键Ctrl+Alt+S，打开Settings配置界面。
进入Appearance&Behavior > System Settings > HarmonyOS SDK菜单界面，点击Edit按钮，设置HarmonyOS SDK存储路径。

 

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

 

说明

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

 

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

 

 

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

 

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

 

 

作者：涂程