系列文章目录

第一章 HarmonyOS是什么
第二章 基础环境和开发工具

---

---

前言

本文将会给大家梳理 HarmonyOS 源码目录结构，介绍重要目录包含的内容与作用，便于大家在学习开发过程中有全局观，有针对性的研读开发。HarmonyOS 源码文件之多，想要短时间内研读完成是比较困难的。对于我们刚刚学习此操作系统的开发来说，如果一个个目录去研读代码，需要花费大量的时间。

---

一、HarmonyOS工程介绍

HarmonyOS应用/服务发布形态为APP Pack（Application Package，简称APP），它是由一个或多个HAP（HarmonyOS Ability Package）包以及描述APP Pack属性的pack.info文件组成。
一个HAP在工程目录中对应一个Module，它是由代码、资源、第三方库及应用/服务配置文件组成，可以分为Entry和Feature两种类型。

• Entry：应用/服务的主模块，可独立安装运行。一个APP中，对于同一类型的设备，可以包含一个或多个Entry类型的HAP，如果同一类型的设备包含多个Entry模块，需要配置distroFilter分发规则，使得应用市场在做应用的云端分发时，对该设备类型下不同规格的设备进行精确分发。
• Feature：应用/服务的动态特性模块。一个APP可以包含零到多个Feature类型的HAP。只有包含Ability的HAP才能够独立运行。

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

二、工程目录结构

DevEco Studio工程目录结构提供工程视图和HarmonyOS视图。工程创建或打开后，默认显示工程视图

切换到HarmonyOS视图，在左上角单击Project > Ohos进行切换

三、工程目录介绍

1.entry

entry：应用主模块。一个App中，对于统一设备类型必须有且只有一个entry类型的HAP，可独立安装运行。

• src > main > ets：用于存放ets源码。
• src > main > ets > MainAbility：应用/服务的入口。
• src > main > ets > MainAbility > pages：MainAbility包含的页面。
• src > main > ets > MainAbility > app.ets：承载Ability生命周期。
• src > main > resources：用于存放应用/服务所用到的资源文件，如图形、多媒体、字符串、布局文件等。
• src > main > config.json：模块配置文件，主要包含HAP包的配置信息、应用在具体设备上的配置信息以及应用的全局配置信息。
• entry >build-profile.json5：当前的模块信息、编译信息配置项，包括buildOption、targets配置等。
• entry >hvigorfile.js：模块级编译构建任务脚本。

build-profile.json5：应用级配置信息，包括签名、产品配置等。
hvigorfile.js：应用级编译构建任务脚本。

2.Ability

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

3.库文件

库文件是应用依赖的第三方代码（例如so、jar、bin、har等二进制文件），存放在libs目录。

4.资源文件

应用的资源文件（字符串、图片、音频等）存放于resources目录下，便于开发者使用和维护

5.配置文件

配置文件 (config.json) 是应用的Ability信息，用于声明应用的Ability，以及应用所需权限等信息

6.pack.info

描述应用软件包中每个HAP的属性，由IDE编译生成，应用市场根据该文件进行拆包和HAP的分类存储。HAP的具体属性包括：

• delivery-with-install:表示该HAP是否支持随应用安装。“true”表示支持随应用安装；“false”表示不支持随应用安装。
• name：HAP文件名。
• module-type：模块类型，entry或feature。
• device-type：表示支持该HAP运行的设备类型。

7.HAR

HAR（HarmonyOS Ability Resources）可以提供构建应用所需的所有内容，包括源代码、资源文件和config.json文件。HAR不同于HAP，HAR不能独立安装运行在设备上，只能作为应用模块的依赖项被引用。

---

总结

以上就是今天要讲的内容，本文仅仅简单介绍了HarmonyOS的工程介绍。