HarmonyOS开发初体验

主要内容：

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来筛选日志信息。根据实际情况选择了设备和进程后，搜索业务领域值进行筛选，得到对应的日志信息。