随着华为HarmonyOS的快速发展,为适配基于HarmonyOS应用的快速和高效开发,华为提供了DevEco Studio开发工具。本书将基于DevEco Studio IDE,手把手教你搭建Harmony开发环境。
当前DevEco Studio已经支持Windows系统和macOS系统,这里以Windows系统为例,为了保证DevEco Studio正常运行,建议你的计算机配置满足以下要求:
· 操作系统:Windows 10 64位。
· 内存:8GB及以上。
· 硬盘:100GB及以上。
· 分辨率:1280×800像素及以上。
首先,需要去华为官网下载最新的开发工具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
如果需要使用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的安装路径。
DevEco Studio的开发环境,需要保证连接Internet网络。若可以直接访问Internet,则直接执行步骤二和步骤五即可。若不能直接访问Internet,则需要逐步完成以下步骤,包括配置代理服务器。
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
下载JS SDK时,为提升使用npm安装JS依赖的速度,建议在命令行工具中执行如下命令,重新设置npm仓库地址。
npm config set registry https://mirrors.huaweicloud.com/repository/npm/
若网络不能直接访问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代理
若网络不能直接访问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默认安装
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工程来验证环境配置。