鸿蒙：Harmony开发基础知识详解

一.概述

工欲善其事，必先利其器。

上一篇博文实现了一个**"Hello Harmony"** 的Demo，今天这篇博文就以**"Hello Harmony"**为例，以官网开发文档为依据，从鸿蒙开发主要的几个方面入手，详细了解一下鸿蒙开发所需的基础知识。

二.UI框架

HarmonyOS提供了一套UI开发框架，即方舟开发框架 （ArkUI框架）

1.UI开发要素

方舟开发框架 提供了多个应用UI开发要素：

● UI组件：(列表、网格、按钮、单选框、进度条、文本等)

● 布局计算

● 动画能力

● UI交互

● 绘制

● ......

2.两种开发范式

(1).两种开发范式介绍：

基于ArkTS的声明式开发范式（简称"声明式开发范式"）
兼容JS的类Web开发范式（简称"类Web开发范式"）

声明式开发范式 ：基于TypeScript 扩展而来的ArkTs语言进行声明式UI开发

类Web开发范式 ：采用经典的HML、CSS、JavaScript三段式开发方式

HML搭建布局、CSS描述样式、JavaScript处理逻辑。

类Web开发范式很像Web前端开发，便于快速将Web应用改造成鸿蒙应用

但是华为鸿蒙官方首推的是声明式开发范式

(2).方舟开发框架示意图

(3).方舟开发框架结构图

(3).两种开发范式比较

基于如下下几个优点，鸿蒙官方更推荐使用声明式开发范式来构建UI：

**开发效率：**更接近自然语义的编程方式，直观地描述UI，无需关心UI绘制和渲染，高效简洁。
**应用性能：**相比类Web开发范式，声明式开发范式无需JS框架进行页面DOM管理，渲染更新更精简，占用内存更少，性能更佳。
发展趋势：后续会作为主推的开发范式持续演进，提供更丰富、更强大的能力

三.应用模型

1.两种应用模型

HarmonyOS的应用模型提供了应用程序必备的组件和运行机制，可以基于一套统一的模型进行应用开发。

HarmonyOS发展过程中，先后提供了两种应用模型：

FA（Feature Ability）模型： HarmonyOS API 7开始支持的模型，已经不再主推
Stage模型： HarmonyOS API 9开始新增的模型，是Harmony目前主推且会长期演进的模型

Stage模型 提供了AbilityStage、WindowStage等类作为应用组件 和Window窗口 的**"舞台"** ，所以被称为Stage模型。

2.构成要素

HarmonyOS应用模型的构成要素包括：

**应用组件：**应用的基本组成单位，也是运行入口，提供生命周期回调
**应用进程模型：**定义应用进程的创建和销毁方式，以及进程间的通信方式
**应用线程模型：**定义应用进程内线程的创建和销毁方式、主线程和UI线程的创建方式、线程间的通信方式
**应用任务管理模型：**定义任务（Mission）的创建和销毁方式，以及任务与组件间的关系。HarmonyOS应用任务管理由系统应用负责，三方应用无需关注
**应用配置文件：**包含应用配置信息、应用组件信息、权限信息、开发者自定义信息等，这些信息在编译构建、分发和运行阶段分别提供给编译工具、应用市场和操作系统使用

四.HarmonyOS APP包结构

HarmonyOS应用/服务发布形态为APP Pack （Application Package，简称APP）

它由一个或多个HAP（HarmonyOS Ability Package）包以及描述APP Pack属性的pack.info文件组成。

终端设备安装和云端(服务器)分发时，都是以HAP为单位进行安装和分发的。

一个HAP在工程目录中对应一个Module

它是由代码、资源、第三方库及应用/服务配置文件组成，

可以分为 Entry 和 Feature两种类型:

Entry： 应用/服务的主模块，可独立安装运行。
(1). 通常用于实现应用的入口界面、入口图标、主特性功能等。
**(2).**一个APP中，对于同一类型的设备，可以包含一个或多个Entry类型的HAP，如果同一类型的设备包含多个Entry模块，需要配置distroFilter分发规则，使得应用市场在做应用的云端分发时，对该设备类型下不同规格的设备进行精确分发。
Feature： 应用/服务的动态特性模块。
(1). 一个APP可以包含0个或多个Feature类型的HAP**（像Android的".jar"和".aar"）
(2).** 可以配置成按需下载安装，也可以配置成随Entry类型HAP一起下载安装
(3). 只有包含Ability的HAP才能够独立运行。

module.json5 配置文件中通过 type标签 配置**"entry"** 或**"feature"**类型

Ability 是应用所具备的能力的抽象
(1). 一个应用可以包含一个或多个Ability。
(2). Ability分为两种类型：FA （Feature Ability）和PA （Particle Ability）。
(3). FA/PA是应用/服务的基本组成单元，能够实现特定的业务功能。
**(4).**FA有UI界面，而PA无UI界面。

**Bundle：**每个Harmony应用可以包含多个.hap文件，一个应用中的.hap文件合在一起称为一个Bundle，bundleName是应用的唯一标识（bundleName标签在app.json5配置文件中）。

需要特别说明的是： 在应用上架到应用市场时，需要把应用包含的所有**.hap** 文件（即Bundle ）打包为一个**.app** 后缀的文件用于上架，这个.app文件就是App Pack（Application Package），其中也包含了描述App Pack属性的pack.info文件。

五.Stage模型应用程序包结构

1.Moudle

Module 是HarmonyOS应用/服务的基本功能单元，包含了源代码、资源文件、第三方库及应用/服务配置文件。

每一个Module都可以独立进行编译和运行。(和Android中的Moudle一样)

Module分为"Ability "和"Library"两种类型:

**Ability类型：**编译后生成HAP（Harmony Ability Package）文件
**Library类型：**编译后生成HAR（Harmony Archive）文件，或者HSP（Harmony Shared Package）

DevEco Studio可以创建一个或者多个Module

2.Module与UIAbility组件关系示意图

**注：**下文中再提到的Module默认指的是"Ability"类型的Module。

3.应用程序包结构(Stage模型)

注：下文中提到的HAP包默认指的是Stage模型的HAP包

HAP包结构包括：

ets、libs、resources等文件夹
resources.index、module.json、pack.info等文件。

应用程序包结构图示：

**ets目录：**存放应用代码编译后的字节码文件。
**libs目录：**存放库文件（.so二进制文件）。
**resources目录：**存放应用的资源文件（字符串、图片等）
**resources.index：**资源索引表，由IDE编译工程时生成。
**module.json：**HAP配置文件，内容由工程配置中的module.json5和app.json5组成
pack.info： Bundle中用于描述每个HAP属性的文件
例如：app中的bundleName和versionCode信息、module中的name、type和 abilities等信息，编译生成Bundle包时自动生成。

六.Stage模型ArkTS工程目录结构

以上一篇博客的**"Hello Harmony"**Demo为例，一个Stage模型ArkTS工程目录详细结构如下：

七.resources目录

鸿蒙应用的resources目录根据所包含的资源文件的类型不同，放置在不同的子目录下

resources目录包括三大类目录：

资源文件查找顺序：

优先从匹配的限定词目录中寻找
没有匹配的限定词目录，或者在限定词目录中找不到，就会去base目录中找。

rawfile是原始文件目录，不会根据设备状态去匹配不同的资源

stage模型多工程情况下共有的资源文件放到AppScope下的resources目录。

资源目录示例 ：

八.ArkTS代码组成拆解

点击按钮，文本内容从**"Hello World"** 变为**"Hello ArkUI"**功能代码拆解

ArkTS 代码段的基本组成：

九.DevEco Studio实用

DevEco Studio和Android Studio很像，他们都是基于IntelliJ IDEA开发工具演变而来。

但是DevEco Studio有一些和Android Studio有区别有很实用的地方。

1.Previewer

DevEco Studio有一个Previewer 功能，在开发过程中能实时看到ts 文件实现的UI效果。AndroidStudio针对XML布局文件也有个类似的Design 功能，但是只能看到布局控件的区域排布，DevEco Studio的Previewer能直接实现最终UI效果和逻辑呈现，并且跟随代码实时更新

2.低代码UI开发

DevEco Studio有一个低代码开发UI的功能，实现了在开发过程中实时拖动控件进行UI开发。

这项功能的开关需要在工程创建时选择

打开Enable Super Visual，表示使用低代码开发功能开发应用/服务。

同步完成后，工程目录中自动生成低代码目录结构。

index.js：低代码页面的逻辑描述文件，定义了页面里所用到的所有的逻辑关系，比如数据、事件等。如果创建了多个低代码页面，则pages目录下会生成多个页面文件夹及对应的js文件。

index.visual：visual文件存储低代码页面的数据模型，双击该文件即可打开低代码页面，进行可视化开发设计。如果创建了多个低代码页面，则pages目录下会生成多个页面文件夹及对应的visual文件。

打开"index.visual"文件，即可进行页面的可视化布局设计与开发

十.结束语

鸿蒙应用开发的基础知识就先讲解到这里

后续随着HarmonyOS学习的深入，本博文会持续更新鸿蒙开发需要掌握的基础知识点。