【HarmonyOS开发】鸿蒙开发入门篇

前言

最初接触鸿蒙是在2021年，当时鸿蒙2.0刚刚推出，当时公司所在团队受邀做OTA升级预装，于是主动接了这个任务。2.0/3.0时代，鸿蒙还是使用的Java语言，布局文件也跟 Android layout 的类似，只不过是前缀不再是 android 而是ohos，当时的系统模型称作 FA，跟现在的 stage 模型相差还是挺大的。既然有区别，那我们就来看看现在 Stage 模型是个什么样子吧

1 应用程序包概述

1.1 应用程序包结构

在开始学习 Stage 模型之前，我们先看看应用程序包的结构是什么样子的

从上图可以看到一个应用包含一个或者多个Module，那什么是 Module 呢？其实 Module 是应用或者服务的基本功能单元，包含了源代码、资源文件、第三方库及应用或者服务的配置文件，每一个 Module 都可以独立进行编译和运行。

Module 分为Ability和Library两种类型，Ability类型的 Modul e对应于编译后的HAP（Harmony Ability Package）；Library类型的 Module 对应于HAR（Harmony Archive）

1.2 应用程序包多 HAP 机制

前面说到，Module 分为Ability和Library两种类型，而Ability类型才会被编译成HAP，因此多 HAP 机制也是针对Ability这种 Module 来说的。聪明的你一定猜到了，既然时多 HAP 机制，那么Ability这种类型的 Module 一定也是有多种类型的，不错，Ability类型的 Module 又可以分为两类，它们是：

1.Entry类型的 Module：是应用的主模块，在module.json5配置文件中的 type 标签配置为 “entry” 类型。在同一个应用中，同一设备类型只支持一个Entry类型的 Module，通常用于实现应用的入口界面、入口图标、主特性功能等。

2.Feature类型的 Module：是应用的动态特性模块，在module.json5配置文件中的 type 标签配置为"feature" 类型。一个应用程序包可以包含一个或多个Feature类型的 Module，也可以不包含Feature类型的 Module。

因此，实际上多 HAP 机制，就是将一个项目拆分成多个 Module，这其中包含一个 EntryModuel，0~N个FeatureModule，这样经过编译打包后，就会生成1个或多个 HAP 包，从而实现了应用程序的多 HAP 机制（见下图）

2 Stage模型应用程序包结构

2.1 开发态包结构

下图是通过 DevEco-Studio 所创建的项目的工程结构

其主要包含的文件类型及用途如下：

说明

AppScope目录由DevEco Studio自动生成，不可更改。 Module目录名称可以由DevEco
Studio自动生成（比如entry、library等），也可以自定义。为了便于说明，下表中统一采用Module_name表示。

2.2 编译态包结构

不同类型的Module编译后会生成对应的HAP、HAR、HSP等文件，开发态视图与编译态视图的对照关系如下：

从开发态到编译态，Module中的文件会发生如下变更：

●ets目录：ArkTS源码编译生成.abc文件。
●resources目录：AppScope目录下的资源文件会合入到Module下面资源目录中，如果两个目录下的存在重名文件，编译打包后只会保留AppScope目录下的资源文件。
●module配置文件：AppScope目录下的app.json5文件字段会合入到Module下面的module.json5文件之中，编译后生成HAP或HSP最终的module.json文件。

需要注意的是
在编译 HAP 和 HSP 时，会把他们所依赖的HAR直接编译到 HAP 和 HSP 中。

2.3 选择合适的包类型

HAP、HSP、HAR支持的规格对比如下：

说明

●HAR虽然不支持在配置文件中声明pages页面，但是可以包含pages页面，并通过命名路由的方式进行跳转。
●由于HSP仅支持应用内共享，如果HAR依赖了HSP，则该HAR文件仅支持应用内共享，不支持发布到二方仓或三方仓供其他应用使用，否则会导致编译失败。
●HAR和HSP均不支持循环依赖，也不支持依赖传递。

2.4 发布态包结构

每个应用中至少包含一个.hap文件，可能包含若干个.hsp文件、也可能不含，一个应用中的所有.hap与.hsp文件合在一起称为Bundle，其对应的bundleName是应用的唯一标识（详见app.json5配置文件中的bundleName标签）。

当应用发布上架到应用市场时，需要将Bundle打包为一个.app后缀的文件用于上架，这个.app文件称为App Pack（Application Package），与此同时，DevEco Studio工具自动会生成一个pack.info文件。pack.info文件描述了App Pack中每个HAP和HSP的属性，包含APP中的bundleName和versionCode信息、以及Module中的name、type和abilities等信息。

上图是编译发布与上架部署流程图，需要特别说明的是：

●App Pack是发布上架到应用市场的基本单元，但是不能在设备上直接安装和运行。
●用户在鸿蒙应用市场下载安装APP时，会先将APP Pack下载下来，然后再拆分成若干个 .hap / .hsp文件，并对它们逐个进行签名，然后再逐个安装到手机上。

总结

在 HarmonyOS 2.0 / 3.0 时代，编译好的 release 包，即上文提到的 APP Pack 是无法直接通过 DevEco-Studio 安装测试机上，需要对这个 APP Pack 进行拆包，拆成若干个 .hap / .hsp 文件后，再通过命令行[1]将这些文件按照先后顺序安装到测试机上，不知道在 Next 版本上这一点是否有所改进，如果有知道的小伙伴，可以留言告诉笔者，在这里也留个坑，等后续项目准备上线了，我也自己试验下，看看能不能直接在测试机上安装 .app 文件

写在最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（HarmonyOS NEXT）5.0最新学习路线

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V3.0白皮书》

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

《鸿蒙开发基础》

●ArkTS语言
●安装DevEco Studio
●运用你的第一个ArkTS应用
●ArkUI声明式UI开发
.……

《鸿蒙开发进阶》

●Stage模型入门
●网络管理
●数据管理
●电话服务
●分布式应用开发
●通知与窗口管理
●多媒体技术
●安全技能
●任务管理
●WebGL
●国际化开发
●应用测试
●DFX面向未来设计
●鸿蒙系统移植和裁剪定制
……

《鸿蒙进阶实战》

●ArkTS实践
●UIAbility应用
●网络案例
……

获取以上完整鸿蒙HarmonyOS学习资料，请点击→纯血版全套鸿蒙HarmonyOS学习资料