主要内容:
1.搭建HarmonyOS应用开发环境
2.项目创建
3.项目运行与调试
4.HiLog日志打印
1.搭建HarmonyOS应用开发环境
1)DevEco Studio 介绍
华为公司基于IntelliJ IDEA为HarmonyOS应用开发提供了一个集成开发环境(IDE),名字叫HUAWEI DevEco Studio,简称DevEco Studio。
2)搭建开发环境的流程
3)下载和安装DevEco Studio(Windows系统为例)
首先,注册华为开发者联盟帐号,并实名认证(因为下载使用DevEco Studio及远程模拟器需要华为开发者联盟帐号)。
注册网站:https://developer.harmonyos.com
下载链接:https://developer.harmonyos.com/cn/develop/deveco-studio
安装: 下载完成Windows(64-bit)版本后,解压,然后双击运行deveco-studio-xxxxx.exe, 按照安装向导安装。
下载和安装DevEco Studio过程如下。
运行安装程序。
选择IDE安装位置。
创建桌面快捷方式,添加快捷菜单项。
解压安装。
安装完毕选择是否重启计算机。要求重启开发机。
同意许可协议。
选择是否导入已有的DevEco Studio配置信息,新安装一般选择不导入配置。
配置Node.js和Ohpm安装源与本地安装路径。安装源一般选择线上镜像安装,安装过程保持网络畅通。本地安装路径中不能有大写字母。
配置SDK安装路径,需要较大空间,选择空闲空间较大的磁盘安装。
选择要安装的SDK并同意许可协议。
同意协议后进行下一步安装,过程中需要联网下载相关文件。
依次下载完各个文件包,完成安装。
全部文件包下载完成,提示安装成功。
4)安装及配置模拟器
远程模拟器,通过登录华为开发者账号使用线上模拟器。点击Sign In按钮,华为开发者网站打开,登录成功后,可以在远程模拟器视图(Remote Emulator)中查看远程模拟器列表。
本地模拟器,Harmony提供了本地创建模拟器功能。创建本地模拟器前,需要下载Harmony系统镜像文件。已经安装镜像文件(例如:System-image-phone)的版本,可以创建对应版本设备的本地模拟器。
在SDK Manager视图中可以查看系统镜像文件安装情况,选中未安装镜像文件选择Apply可以进行下载安装。
Device Manager视图中的Local Emulator页面可以查看本地模拟器列表。窗口右下角New Emulator可以创建新的本地模拟器。
在模拟器列表中选中模拟器,并点击启动按钮,可以开启模拟器。
2.项目创建
1)打开DevEco,新建一个HarmonyOS项目。
①点击“Create Project”,开始创建项目。
②选择“Empty Ability”空白模板
③项目配置界面
Project name,项目名称。
Bundle name,应用的包名,项目上线的唯一标识。
Save location,项目的位置。
Compile SDK,项目编译的 SDK 版本,默认为当前最新版,也就是 Harmony OS API 9。也只可以选择9,因为在 DevEco Studio 在 API 9 版本中引入了 Stage 模型,也是以后主推的模型方式。3.1.1 新建的项目默认就是使用的 Stage 模型。
Enable Super Visual,是否允许可视化布局,也就是低代码开发模式。该功能属于新功能,还不是很完善,想要使用的话可以体验一下。
Language,开发的语言,从API 9开始,只支持ArkTS语言。
Compatible SDK,适配的 SDK 版本,默认为 API 9。
Device Type,设备类型,默认选择 Phone、Tablet。
2)工程目录结构说明
创建完成后的项目结构如图所示:
entry:HarmonyOS工程模块,编译构建生成一个HAP包。
src > main > ets:用于存放ets源码。
src > main > ets > entryability:应用/服务的入口。
src > main > ets > pages:应用/服务包含的页面。
src > main > resources:用于存放应用/服务所用到的资源文件,如图形、多媒体、字符串、布局文件等。关于资源文件,详见资源分类与访问。
src > main > module.json5:模块配置文件。主要包含HAP包的配置信息、应用/服务在具体设备上的配置信息以及应用/服务的全局配置信息。
build-profile.json5:当前的模块信息 、编译信息配置项,包括buildOption、targets配置等。
hvigorfile.ts:模块级编译构建任务脚本,开发者可以自定义相关任务和代码实现。
build-profile.json5:应用级配置信息,包括签名、产品配置等。
hvigorfile.ts:应用级编译构建任务脚本。
3)工程目录结构视图
包括:工程视图,包视图,HarmonyOS视图。
Project视图,以Project为根目录列出,是常用的视图模式,可以看到工程内所有文件。
Packages视图,以包为单位列出所有源代码及资源。
HarmonyOS视图,以HAP包为单位列出,HAP 的全称为“HarmonyOS Ability Package”,它是 Ability 的部署包。
3.项目运行与调试
1)调试与开发辅助工具
预览器:Preview,用于查看UI效果。
本地模拟器:Local Emulator 在本地计算机运行。
远程模拟器:Remote Emulator 依赖网络,可调试运行应用,包括:phone、Tablet、Car、TV、Wearable。
本地真机:用USB或者IP方式连接实体设备。
2)本地模拟器VS远程模拟器
本地模拟器,在本地计算机上创建并运行,无需登录授权,无网络数据交换,可保持很好的流畅性和稳定性,耗费本地计算机磁盘资源。
远程模拟器,在远程服务器上创建并运行,需授权登录,需网络数据交换,不耗费本地计算机磁盘资源。
3)运行和调试
应用程序开发完成后,可以使用真机设备或者远程模拟器进行运行和调试。DevEco Studio开发环境提供了丰富的HarmonyOS应用程序调试能力。
远程模拟器既支持Java单语言调试、Js单语言调试及Js+Java跨语言调试,也支持分布式应用的跨设备调试,同时可以支持运行已签名或未签名的应用程序。
真机设备分为本地物理真机和远程真机,真机设备既支持Java、Js、C/C++单语言调试及Js+Java、Java+C/C++跨语言调试,也支持分布式应用的跨设备调试,但是在使用真机设备进行调试前,需要对HAP(HarmonyOS Ability Package,鸿蒙Ability 包)进行签名后才能进行调试。
4.HiLog日志打印
HarmonyOS提供了HiLog日志系统,让应用可以按照指定类型、指定级别、指定格式字符串输出日志内容,帮助开发者了解应用的运行状态,更好地调试程序。 HiLog中定义了DEBUG、INFO、WARN、ERROR、FATAL五种日志级别,并提供了对应的方法用于输出不同级别的日志。
DevEco Studio提供了“Log > HiLog”窗口查看日志信息,开发者可通过设置设备、进程、日志级别和搜索关键词来筛选日志信息。搜索功能支持使用正则表达式,开发者可通过搜索自定义的业务领域值和TAG来筛选日志信息。根据实际情况选择了设备和进程后,搜索业务领域值进行筛选,得到对应的日志信息。