3 开发环境搭建及调 试 本章学习目标 .下载和安装DevEcoStudio,并配置开发环境。 .熟悉DevEcoStudio的常用功能。 .熟练掌握如何创建一个应用,并使用预览器查看页面效果。 .熟悉如何用本地模拟器、远程模拟器、远程设备运行一个应用。 .了解注册和登录华为开发者联盟账号。 ..3.开发环境搭建 1 3.1 Dvctdo功能简介 1.eEoSui DevEcoStudio是华为公司为HarmonyOS应用开发提供的一个集成开发工具,它是基 于InteliJIDEACommunity开源版本打造,面向全场景多设备,提供一站式的应用集成开 发环境(nertdDvlpmetEnionIDE), 分布式多端调 Itgaeeeonvrnmet,支持分布式多端开发、 测、多端模拟仿真,提供全方位的质量与安全保障。 作为一款开发工具,除了具有基本的代码开发、编译构建及调测等功能外,DevEco Studio还具有如下特点。 (1)高效智能代码编辑:支持eTS 、JavaScript、C/C++、Java等语言的代码高亮、代码智 能补齐、代码错误检查、代码自动跳转、代码格式化、代码查找等功能,提升代码编写效率。 (2)低代码可视化开发:丰富的UI界面编辑能力,支持自由拖曳组件和可视化数据绑 定,可快速预览效果,所见即所得;同时支持卡片的零代码开发,降低开发门槛,提升界面开 发效率。 (3)多端双向实时预览:支持UI界面代码的双向预览、实时预览、动态预览、组件预览 及多端设备预览,便于快速查看代码运行效果。 (4)多端设备模拟仿真:提供HarmonyOS本地模拟器、远程模拟器、超级终端模拟器, 支持手机、智慧屏、智能穿戴设备等多端设备的模拟仿真,便捷获取调试环境。 (5)支持分布式多段应用开发:HarmonyOS是分布式操作系统,DevEcoStudio支持 一个项目代码跨设备运行和调试,支持不同设备界面的实时预览和差异化开发,为分布式应 用开发提供了支持。 开发者在进行HarmonyOS应用开发之前,需要对开发软件DevEcoStudio进行下载安 第3章开发环境搭建及调试 45 装,并进行一些必要的软件准备和配置,具体的应用开发环境搭建流程如图3-1所示。 图3- 1 开发环境搭建 3.1.2 DevEcoStudio下载安装 DevEcoStudio的编译构建依赖JDK(JavaDevelopmentKit),DevEcoStudio预置了 OpenJDK,即安装过程中会自动安装JDK 。 rmoneeopehs:vlpe.anysc 进入HayOSDvlr产品页( tp//deeorhrmoo.om/),单击“开 发”按钮,选择DevEcoStudio,单击“立即下载”按钮,在“更多版本”中找到DevEcoStudio3.0 Rees下载deeotdownow-ol3.0.zp压缩包。 lae, vcsui-idsto-0.993.i (1)双击打开安装包,单击Next按钮,如图3-2所示。 图3- 2 打开安装包 (2)选择软件安装路径,读者可根据自己计算机的配置安装,建议安装到系统盘(C盘) 以外的其他盘,单击Browse按钮可以更改路径,更改完毕后单击Next按钮,如图3-3所示。 (3)选择需要的安装选项,建议初学者只选择第一项创建桌面图标,单击Next按钮,如 图3-4所示。 (4)创建开始菜单文件夹(如图3-5所示),即创建在桌面左下角开始栏里的文件夹,用 来打开DevEcoStudio,打开方式为“开始”→Huawei→DevEcoStudio。单击Instal 按钮, 46 鸿蒙应用程序开发 图3- 3 软件安装位置 图3- 4 安装选项 然后单击Next按钮,直至安装完成。 图3- 5 创建开始菜单文件夹 第3章开发环境搭建及调试 (5)完成DevEcoStudio的安装,界面如图3-6所示。先不勾选RunDevEcoStudio选 项,单击Finish按钮。 47 图3- 6 完成安装 (6)下面对DevEcoStudio进行设置,在桌面双击启动DevEcoStudio,弹出接受条款界 面,单击Agre 按钮,如图3-7所示。 图3- 7 接受条款界面 (7)导入设置,如果之前有导出的设置,可以按其进行导入。建议初学者选择不导入, 单击OK按钮,如图3-8所示。 (8)进入DevEcoStudio操作向导页面,修改npmregistry,DevEcoStudio已预置对应 的仓(默认的npm仓可能出现部分开发者无法访问或访问速度缓慢的情况),直接单击 StartusingDevEcoStudio按钮进入下一步,如图3-9所示。 (9)Nodejs安装,选择Dlaawimir,并选择安装位置,如图3-10所示。 .ownod,Huero 单击Next按钮,直至安装完成,单击Finish按钮。 48 鸿蒙应用程序开发 图3- 8 导入设置 图3- 9 npm 设置 图3-10 Node.s安装 j (10)SDK组件设置,选择安装位置,单击Next按钮,如图3-11所示 。 (11)SDK设置确认,单击Next按钮,如图3-12所示 。 (12)接受许可协议,分别单击OpenHarmony-SDK和HarmonyOS-SDK下的Acept 按钮,如图3-13所示,然后单击Next按钮,直至完成,单击Finish按钮。 第3章开发环境搭建及调试 49 图3-11 SDK 组件设置 图3-12 SDK 设置确认 50 鸿蒙应用程序开发 图3-13 接受许可协议 3.3 第一个工程的创建及配置 1. 通过3.2节的学习,读者应已成功安装了Do开发工具,下面就可以开发 第一个HarmonyOS应用,本节将演示第一个应用———HeloWorld。 1.evEcoStudi (1)打开开发工具DevEcoStudio后,出现如图3-14所示界面,单击左侧栏的Create Project按钮创建新工程。 图3-14 单击CreateProject按钮创建新工程 第3章开发环境搭建及调试 51 (2)新建工程后,下一步跳转至如图3-15 所示的界面,选择支持不同开发语言类型的 模板。界面有HarmonyOS 和OpenHarmony两个选项,OpenHarmony是开源项目,应用 开发初学者可以暂时不用考虑。本节的例子选择HarmonyOS 下的EmptyAbility模板(有 关Ability的概念将在第5章进行介绍,这里简单认为它是应用所具有的一个功能), 它支持 包括手机、平板电脑、车机、智慧屏、智能穿戴设备等多种终端设备。单击Next按钮进入下 一步。 图3-15 选择应用类型模板 (3)进入配置界面,如图3-16 所示,配置这个工程的名称、类型、包名、存储位置、SDK 版本信息、设备类型等。 ProjectName:项目名称,遵循命名规范,数字不能为首位,不能用空格符等,不支持中 文命名,由大小写字母、数字和下画线组成。 ProjectType:选择Application项,代表开发的是一个独立的应用。 BundleName:一款上市App 独一无二的标识,默认情况下,应用ID 会使用该名称,应 用发布时,应用ID 需要唯一。 Savelocation:工程存储位置,读者可以根据需要修改。 CompileSDK:应用的目标API 版本,在编译构建时,DevEcoStudio会根据指定的 CompileAPI 版本进行编译打包,因为本书的编译语言为Java,所以这里建议选择API7 (在API7 以后,没有以Java语言为编译语言的环境)。 Language:选择Java。 CompatibleSDK:兼容的最低API 版本,这里选择6,因为运行程序时使用的远程模拟 器最低API 版本为6。 DeviceType:默认选择Phone。 52 鸿蒙应用程序开发 配置完成后单击Finish按钮。 图3-16 配置项目基本信息 (4)页面跳转至SDKSetup,单击ConfigureNow 按钮,如图3-17 所示,直至完成。 图3-17 SDK 设置 (5)配置完成后单击Finish按钮,DevEcoStudio会自动生成工程代码,界面显示如 图3-18 所示。界面可分成上方菜单栏、工程目录、代码编辑区、右上角工具栏和下方控制 台。HarmonyOS 应用开发默认使用Gradle进行编译构建,首次创建工程会自动下载 Gradle相关依赖,时间较长,需要耐心等待。 工程目录区结构如图3-19 所示 。 图3-19 中各文件夹含义如下 。 .radle:Gradle配置文件,由系统自动生成,一般情况下不需要进行修改 。 gentry:默认启动模块(主模块), 开发者用来编写源码文件以及开发资源文件的目录。 第3章开发环境搭建及调试 53 图3-18 自动生成工程代码 entry/libs:用于存放entry模块的依赖 文件。 entry/src/main/java:用于存放Java源码。 enrsrcin/jv/om.xl. ty//maaaceampemyapplication/slice/MainAbilitySlice:承载单个页 面的具体逻辑实现和界面UI 。 enrsrcin/jv/om.xlmy ty//maaaceampeapplication/slice/MainAbility:应用的入口。(.) entry/src/main/resources:用于存放应 用用到的资源文件,如图形、多媒体、字符串、 布局文件等。图3-19 工程目录区结构 enrsci/cnijon:模块配置 ty/r/manofg.s 文件,主要包含HAP(HarmonyOSAbilityPackage)包的配置信息、应用在具体设备上的配置信息以及应用的全局配置信息。 ..3.调试工程 2 构建好应用之后,用户可以使用预览器查看设计界面的效果,还可以通过远程模拟器、 本地模拟器和远程设备调试程序。本节将分别介绍这几种调试方式。 3.2.1 DevEcoStudio预览器 在前面的章节中,我们已经创建了一个简单的HarmonyOS 应用,现在需要查看其页面 效果。使用设备模拟器或远程设备查看页面效果有一个缺点,那就是启动应用相对来说比 54 鸿蒙应用程序开发 较慢,且远程模拟器或远程设备有时会因为在线使用人数过多导致短暂性不可用,而等待又 会浪费大量的时间。如果只是调试一个简单的应用界面,可以通过DevEcoStudio预览器 快速地查看页面效果,这样非常节省时间。 在使用预览器查看应用界面的UI效果前,需要在设置中确保已下载Previewer资源, 在上方菜单栏中打开File→Setings→HarmonyOSSDK→Platforms,如图3-20所示。 图3-20 安装预览器 图3-20中的开发语言、工具链和预览器都要根据需求进行下载。本书所有应用的开发 语言均为Java,所以Java语言必选,推荐API7 、API6版本都选。预览器和工具链版本建 议选择API7 。 打开预览器的方式有以下两种。 (1)在上方菜单栏选择View→ToolWindows→Previewer,打开预览器。 (2)在右上角工具栏中单击Previewer按钮打开预览器 。 预览效果如图3-21所示 。 3.2 在远程模拟器中调试 2. 在应用程序开发完成之后,除了可以通过预览器查看预览界面以外,还可以选择在模拟 器或远程设备中运行程序,本节将介绍远程模拟器的使用。在使用远程模拟器之前,开发者 需要注册一个华为开发者联盟账号。使用远程模拟器调试程序并配合Hilog日志查看控制 台日志输出,观察程序运行流程,是常用的程序调试方式,本书后续章节都使用了在远程模 拟器中运行应用并调试程序的方式。 第3章开发环境搭建及调试 55 图3-21 预览器效果 1.华为开发者联盟账号注册和实名 华为开发者联盟开放诸多能力和服务,助力联盟成员打造优质应用。开发者需要注册 华为开发者联盟账号并且进行实名认证,才能享受联盟开放的各类能力和服务。华为开发 者支持企业身份证验证和个人身份验证。下面介绍成为个人开发者的注册和实名过程。 (1)打开华为开发者联盟官网(htp//dvlprhaiccnumec/),单击 “注册”按钮进入注册页面。 s:eeoe.uwe.om/osr/n (2)注册华为开发者联盟账号可以通过电子邮箱或手机号码。如果使用电子邮箱注 册,请输入正确的电子邮箱地址和验证码,设置密码后,单击“注册”按钮。电子邮箱注册页 面如图3-22所示。 图3-22 电子邮箱注册界面 56 鸿蒙应用程序开发 (3)如果使用手机号码注册,请输入正确的手机号码,并输入接收的短信验证码,在设 置密码后单击“注册”按钮。手机号码注册页面如图3-23 所示。 图3-23 手机号码注册页面 (4)华为商城账号、华为云账号和花粉论坛账号均可登录联盟。登录华为开发者联盟 官网,单击网站右上角的“登录”按钮,显示如图3-24 所示的登录界面。输入账号和密码后 单击“登录”按钮即可登录,也可以使用华为移动服务App 扫一扫登录。 图3-24 登录页面 (5)登录后,需要进行个人身份实名认证。登录账号,单击右上角“管理中心”按钮跳转 到开发者实名认证页面,如图3-25 所示。 (6)在开发者实名认证页面,单击图3-26 所示的“个人开发者”下方的“下一步”按钮, 进入应用敏感性选择页面。请根据上架应用的敏感性选择认证方式,可以按照网页所给提 示选择是否有敏感应用上架到应用市场。如需要上架的是敏感应用,请选择“是”,单击“下 第3章开发环境搭建及调试 57 图3-25 实名认证入口 一步”按钮进入实名认证方式选择页面(可通过人脸识别认证或个人银行卡认证方式进行实 名认证)。如需要上架的是非敏感应用,请选择“否”,单击“下一步”按钮进入实名认证方式 选择页面(可选择人脸识别认证或个人银行卡认证或身份证人工审核认证)。以上的认证方 式和大多数软件的认证方式都很类似,这里不再赘述。 图3-26 实名认证页面:个人开发者实名认证 2. 运行应用 (1)单击DevEcoStudio右上角工具栏中的“运行”按钮(三角形,见图3-27)运行工程, 或使用快捷键Shift+F10 运行工程。 (2)此时,DevEcoStudio右下角会弹出如图3-28 所示的错误提示,“AppLaunch: Selectadevicefirst.即启动运行前要选择相应设备的模拟器或远程设备。那么如何启动,(”) 58 鸿蒙应用程序开发 图3-27 运行工程 图3-28 弹出错误提示 第3章开发环境搭建及调试 59 远程模拟器呢? (3)我们所创建的这个应用的目标是可以在手机上运行,因此需要相应的手机设备模 拟器来运行。在DevEcoStudio上方菜单栏中选择Tools→DeviceManager,打开设备模拟 器管理界面,操作如图3-29 所示。 图3-29 打开设备模拟器管理界面 (4)进入DeviceManager界面,如图3-30 所示。此时有三种设备可以选择,分别是 LocalEmulator、RemoteEmulator、RemoteDevice,即本地模拟器、远程模拟器及远程设 备。此处选择远程模拟器,这时候界面出现Notloggedin字样,提示开发者需要使用华为 开发者账号登录,并根据提示对设备进行授权,单击Signin按钮,界面会跳转到华为账户登 录界面,如图3-31 、图3-32 所示。 图3-30 设备管理界面 (5)使用前面注册的华为账号进行登录,然后单击图3-32 所示的“允许”按钮。如果看 60 鸿蒙应用程序开发 到如图3-33 所示的界面,则代表授权已经成功。 图3-31 登录界面图3-32 对设备进行授权 图3-33 授权成功 (6)授权完成之后,再次返回DevEcoStudio开发工具,此时就可以看到如图3-34 所示 图3-34 设备模拟器列表 61 第3章开发环境搭建及调试 的各种类型的设备模拟器列表,列表中包含Phone、Car、TV 、Tablet、Wearable等模拟器,这 里单击启动Phone模拟器(以P40 为例)。单击代表“运行”的箭头,短暂等待后就可以在 DevEcoStudio主界面看到Phone模拟器已经启动了,如图3-35 所示。 图3-35 手机模拟器已经启动 (7)再次单击“运行”按钮,运行结果将显示在远程模拟器中,如图3-36 所示。到这里, 就代表我们已经成功实现了第一个HarmonyOS 应用的开发和运行了。 图3-36 成功运行效果 3.3 在本地模拟器中调试 2. 因为每次运行远程模拟器都有时长限制,且对网速也有一定的要求,对长时间调试的用 62 鸿蒙应用程序开发 户体验不太友好,所以用户还可以使用本地模拟器调试程序。在使用本地模拟器时需要注 意,本地模拟器仅支持API6的应用程序。本地模拟器调试程序不需要登录授权,在调试过 程中没有网络数据交换,具有很好的流畅性和稳定性,但是需要耗费一定的计算机磁盘资 源。具体要求如下。 Windows系统:内存推荐为16GB及以上。 macOS系统:内存推荐为8GB及以上。 不支持在虚拟机系统上运行本地模拟器,例如不支持在Ubuntu系统上通过安装 Windows虚拟机,然后使用Windows系统安装和运行模拟器。 本节以Windows系统为例介绍使用本地模拟器需要的准备工作以及运行结果,创建 LocalEmulator的操作方法如下。 (1)打开DevEcoStudio,选择Files→Setings→HarmonyOSSDK(macOS系统为 DevEcoStudio→Preferences→HarmonyOSSDK)页签,勾选并下载Platforms下API Version6中的镜像包System-image-phone和Tools下的EmulatorX86资源,如图3-37 、 图3-38所示。不同的镜像包对应不同的设备类型,System-image-phone镜像包对应手机, System-image-tv镜像包对应智慧屏,System-image-wearable镜像包对应智能手表。本书 所有案例都在手机上运行,所以这里只需要选择手机镜像包,读者可根据需求进行更多选 择,单击Apply按钮进行安装,安装过程持续时间较长,请等待安装结束。 图3-37 下载System-image-phone资源 (2)在上方菜单栏选择Tools→DeviceManager,进入图3-39所示界面,单击Edit按钮 设置本地模拟器的存储路径,推荐安装在系统盘(C盘)以外的其他盘。单击图3-39中右下 角的“+NewEmulator”按钮,创建一个本地模拟器。 第3章开发环境搭建及调试 63 图3-38 下载EmulatorX86 资源 图3-39 设置存储位置 (3)进入创建模拟器页面,在左侧选择Phone,选中默认的模拟器,单击Next按钮。也 可以单击NewHardware按钮添加一个新设备,以便自定义设备的相关参数,如尺寸、分辨 率、内存等参数,如图3-40 所示。 (4)选中被推荐的模拟器,继续单击Next按钮,如图3-41 所示。 (5)最后再确认本地模拟器配置,同时也可以在该界面修改模拟器信息,确认无误后单 击Finish按钮,完成添加本地模拟器,如图3-42 所示。 (6)以上就完成了创建一个默认的本地Phone模拟器。在设备管理页面启动模拟器,