近期 华为 的 鸿蒙 系统（ HarmonyOS ）在各大平台疯狂刷屏，可谓是出尽了风头，很多小伙伴都问有没有鸿蒙相关的开发教程，那么它来了！从今天起小编要更新一套千锋长沙Java培训讲师主讲的有关鸿蒙系统开发的系列教程。本篇文章讲解一下HarmonyOS 项目结构：

一、用户应用程序包结构

HarmonyOS的用户应用程序包以APP Pack（Application Package）形式发布，它是由一个或多个HAP（HarmonyOS Ability Package）以及描述每个HAP属性的组成。HAP是Ability的部署包，HarmonyOS应用代码围绕Ability组件展开。一个HAP是由代码、资源、第三方库及应用配置文件组成的模块包，可分为entry和feature两种模块类型，如图所示。

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

feature：应用的动态特性模块。一个APP可以包含一个或多个feature类型的HAP，也可以不含。只有包含Ability的HAP才能够独立运行。

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

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

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

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

二、程序目录结构

首先有一个entry目录，结合上篇的内容，我们知道一个应用是由一个或多个Hap包所组成的，Hap包又可以分为entry类型和feature类型，每个Hap包由：代码、资源、第三方库及应用配置文件组成。所以我们代码中的entry目录其实就一个应用的Hap包，它的类型的entry类型的Hap包。一个Hap包由代码、资源、第三方库及应用配置文件组成，接着我们来看这些资源，代码等都分布在entry包的哪里。

在src/main/ java 下以包名命名的文件夹内分布着Java代码。这里的代码可以用来创建布局，动态调整布局以及为交互提供支撑服务。和java文件夹同级的resources目录下分布应用资源，该目录的base目录下，按资源用途又分为多个文件夹资源：

element：表示元素资源，该文件夹下主要存放json格式的文件，主要用来表示 字符串、颜色值、布尔值等，可以在其他地方被引用。

graphic：表示可绘制资源。用xml文件来表示，比如我们项目中设置的 圆角按钮、按钮颜色等都是通过引用这里的资源来统一管理的。

layout：表示布局资源，用xml文件来表示，比如页面的布局资源，都放在这里。

media：表示媒体资源，包括图片、音频、视频等非文本格式的文件。

config.json项目配置文件：每一个hap包下都包含了该hap包的配置信息，这个配置文件位于：entry/src/main/目录下，由工具帮我们生成，命名为config.json，harmonyOS应用配置采用json格式的形式。下面我们来看一下这个配置文件中的内容，并简要介绍一下配置的作用。该配置文件中，主要有三个模块，如下所示：

app：表示应用的全局配置信息。同一个应用的不同HAP包的“app”配置必须保持一致。

deviceConfig：表示应用在具体设备上的配置信息。

module：表示HAP包的配置信息。该标签下的配置只对当前HAP包生效。

bundleName：表示应用的包名，用于标识应用的唯一性。通常采用反转的域名。

vendor：表示开发应用的厂商。

version：code表示内部版本号，用于系统管理版本使用，对用户不可见，name表示应用的版本号，用于向用户呈现。

apiVersion：包含三个选项。1、compatible：表示应用运行需要的API最小版本。2、target：表示应用运行需要的API目标版本。3、releaseType：表示应用运行需要的API目标版本的类型，取值为“CanaryN”、“BetaN”或者“Release”，其中，N代表大于零的整数。

Canary：受限发布的版本。

Beta：公开发布的Beta版本。

Release：公开发布的正式版本。