鸿蒙操作系统应用开发实践
上QQ阅读APP看书，第一时间看更新
上一章目录下一章

1.2　搭建HarmonyOS开发环境

随着华为HarmonyOS的快速发展，为适配基于HarmonyOS应用的快速和高效开发，华为提供了DevEco Studio开发工具。本书将基于DevEco Studio IDE，手把手教你搭建Harmony开发环境。

1.2.1　安装环境要求

当前DevEco Studio已经支持Windows系统和macOS系统，这里以Windows系统为例，为了保证DevEco Studio正常运行，建议你的计算机配置满足以下要求：

·　操作系统：Windows 10 64位。

·　内存：8GB及以上。

·　硬盘：100GB及以上。

·　分辨率：1280×800像素及以上。

1.2.2　下载安装工具

步骤一：安装开发工具DevEco Studio

首先，需要去华为官网下载最新的开发工具DevEco Studio，下载网址为https://developer.harmonyos.com/cn/develop/deveco-studio。（DevEco Studio的编译构建依赖JDK, DevEco Studio预置了Open JDK，版本为1.8，安装过程中会自动安装JDK。）

下载的安装包解压完成后，双击deveco-studio-xxxx.exe文件，进入DevEco Studio安装向导，默认系统选择的路径，或选择自己的安装路径，单击Next按钮，直至安装完成。注意在如下安装选项页面勾选DevEco Studio launcher，如图1.7所示。

图1.7　安装DevEco Studio

步骤二：安装Node.js

如果需要使用JavaScript（以下简称JS）语言开发HarmonyOS应用，则还需要下载和安装Node.js。如果使用其他语言开发，则不用安装Node.js，可跳过步骤二。

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

接下来安装Node.js。登录Node.js官方网站（网址https://node.js.org/en/download/），下载Node.js软件包。选择LTS版本，64位Windows系统对应的软件包，如图1.8所示。

图1.8　Node.js安装版本

单击下载后的软件包node-vxxx-x64.msi进行安装，根据默认设置单击Next按钮，直至单击Finish按钮完成安装，如图1.9所示。

图1.9　Node.js安装完成

Node.js会自动在系统的path环境变量中配置node.exe的目录路径。如果安装Node.js时没有选择默认的安装目录，则需要在系统变量path中手工添加环境变量信息（笔者的计算机→属性→高级系统设置→高级→环境变量），增加Node.js的安装路径。

1.2.3　搭建开发环境

DevEco Studio的开发环境，需要保证连接Internet网络。若可以直接访问Internet，则直接执行步骤二和步骤五即可。若不能直接访问Internet，则需要逐步完成以下步骤，包括配置代理服务器。

步骤一：配置npm代理

DevEco Studio在使用过程中，需要下载JS SDK第三方依赖。只有在同时满足以下两个条件时，才需要配置npm代理，否则，可以跳过本步骤。

（1）需要使用JS语言开发HarmonyOS应用。

（2）网络不能直接访问Internet，而是需要通过代理服务器才可以访问。

打开命令行工具，然后根据如下方式进行npm代理配置。

（1）如果使用的代理服务器需要认证，按照如下方式进行设置（将其中的user、password、proxyserver和port按照实际代理服务器进行修改）。

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

（2）如果使用的代理服务器不需要认证（不需要账号和密码），则应按照如下方式进行设置。

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

代理设置完成后，可在命令行工具中执行如下命令进行验证。若执行结果如图1.10所示，则说明代理设置成功。

图1.10　npm代理配置成功

    npm info express

步骤二：设置npm仓库

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

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

步骤三：配置Gradle代理

若网络不能直接访问Internet，而是需要通过代理服务器才可以访问，在这种情况下，需要设置Gradle代理，以便访问和下载Gradle所需的依赖。否则，可以跳过本步骤。

首先，打开“此计算机”，在文件夹网址栏中输入%userprofile%，进入个人数据界面，如图1.11所示。

图1.11　进入个人数据界面

创建一个文件夹，并命名为.gradle。如果已存在.gradle文件夹，则跳过此操作。

进入.gradle文件夹，新建一个文本文档，命名为gradle，并修改后缀为.properties。打开gradle.properties文件，添加如下脚本，然后保存，如图1.12所示。其中代理服务器、端口、用户名、密码和不使用代理的域名，需要根据实际代理情况进行修改。其中不使用代理的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

图1.12　配置Gradle代理

步骤四：配置DevEco Studio代理

若网络不能直接访问Internet，而需要通过代理服务器才可以访问，在这种情况下，需要设置DevEco Studio代理，以便访问和下载外部资源，如图1.13所示。否则，可以跳过本步骤。

图1.13　配置DevEco Studio代理

首先，运行已安装的DevEco Studio，首次打开，选择Do not import settings，单击OK按钮。

进入DevEco Studio欢迎界面后，单击Configure→Settings→Appearance & Behavior→System Settings→HTTP Proxy，进入HTTP Proxy的设置界面，设置代理信息。其中包括HTTP配置项和Proxy authentication配置项。

（1）HTTP配置项：设置代理服务器信息。

·　Host name：代理服务器主机名或IP地址。

·　Port number：代理服务器对应的端口号。

·　No proxy for：不需要通过代理服务器访问的URL或者IP地址（地址之间用英文逗号分隔）。

（2）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下载操作，如图1.14所示。

图1.14　HarmonyOS SDK默认安装

步骤五：下载HarmonyOS SDK

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

SDK Manager提供多种编程语言的SDK包，包括Native（C/C++语言SDK包）、JS（JS语言SDK包）和Java（Java语言SDK包）。其中，Java SDK在首次下载Harmony SDK时会默认下载，Native SDK和JS SDK默认不自动下载，需要进行手动勾选下载，因此，如果需要使用JS或C/C++语言开发应用，则需手动下载对应的SDK包。

下载Harmony SDK的步骤如下。

（1）在菜单栏选择Configure→Settings或者按快捷键Ctrl+Alt+S，打开Settings配置界面，如图1.15所示。

图1.15　进入HarmonyOS SDK存储设置

（2）进入Appearance & Behavior→System Settings→HarmonyOS SDK菜单界面，单击Edit按钮，设置HarmonyOS SDK的存储路径，如图1.16所示。

图1.16　设置HarmonyOS SDK存储路径

（3）选择HarmonyOS SDK的存储路径（不能含有中文）后，单击Next按钮，在弹出的License Agreement窗口中，单击Accept按钮开始下载SDK。如果本地已有SDK包，则选择本地已有SDK包的存储路径，DevEco Studio会更新SDK及工具链，如图1.17所示。

图1.17　下载HarmonyOS SDK

（4）待HarmonyOS SDK及工具下载完成后，单击Finish按钮，可以看到默认的SDK Platforms→Java SDK及SDK Tools→Toolchains已完成下载，如图1.18所示。

图1.18　完成HarmonyOS SDK下载

（5）如果需要使用C/C++或者JS语言，则应在SDK Platform中勾选对应的SDK包，单击Apply按钮，SDK Manager会自动将SDK包和工具链下载到所设置的SDK存储路径中，如图1.19所示。

图1.19　下载C/C++/JS SDK

至此，开发环境已配置完成，随后我们会带领大家熟悉DevEco Studio IDE开发环境，并创建一个HarmonyOS项目，通过运行Hello World工程来验证环境配置。

上一章目录下一章