> 文档中心 > 鸿蒙开发学习|HarmonyOS工程介绍

鸿蒙开发学习|HarmonyOS工程介绍


系列文章目录

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


文章目录

  • 系列文章目录
  • 前言
  • 一、HarmonyOS工程介绍
  • 二、工程目录结构
  • 三、工程目录介绍
    • 1.entry
    • 2.Ability
    • 3.库文件
    • 4.资源文件
    • 5.配置文件
    • 6.pack.info
    • 7.HAR
  • 总结

前言

本文将会给大家梳理 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界面。
鸿蒙开发学习|HarmonyOS工程介绍

二、工程目录结构

DevEco Studio工程目录结构提供工程视图和HarmonyOS视图。工程创建或打开后,默认显示工程视图
鸿蒙开发学习|HarmonyOS工程介绍
切换到HarmonyOS视图,在左上角单击Project > Ohos进行切换
鸿蒙开发学习|HarmonyOS工程介绍

三、工程目录介绍

1.entry

entry:应用主模块。一个App中,对于统一设备类型必须有且只有一个entry类型的HAP,可独立安装运行。
鸿蒙开发学习|HarmonyOS工程介绍

  • 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界面。
鸿蒙开发学习|HarmonyOS工程介绍

3.库文件

库文件是应用依赖的第三方代码(例如so、jar、bin、har等二进制文件),存放在libs目录。
鸿蒙开发学习|HarmonyOS工程介绍

4.资源文件

应用的资源文件(字符串、图片、音频等)存放于resources目录下,便于开发者使用和维护
鸿蒙开发学习|HarmonyOS工程介绍

5.配置文件

配置文件 (config.json) 是应用的Ability信息,用于声明应用的Ability,以及应用所需权限等信息
鸿蒙开发学习|HarmonyOS工程介绍

6.pack.info

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

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

鸿蒙开发学习|HarmonyOS工程介绍

7.HAR

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


总结

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