HarmonyOS Next(鸿蒙 Next)项目结构介绍及JSON5配置说明

一、HelloWorld 项目结构截图描述说明

二、详细介绍说明 鸿蒙NEXT项目中的目录结构和JSON5配置文件扮演着至关重要的角色，它们定义了项目的结构和行为。以下是对这些目录和配置文件的详细介绍：

目录结构

1. AppScope：应用的根目录。

2. app.json5：应用的全局配置信息文件。

3. entry：应用/服务模块，编译构建生成一个HAP。

4. src：源代码目录。

   • main：主模块。

     • ets：存放ArkTS源码。

       • entryability：应用/服务的入口。

       • pages：应用/服务包含的页面。

       • resources：存放应用/服务模块所用到的资源文件。

         • base：图形、多媒体、字符串、布局文件等资源文件。
         • en_US、zh_CN：国际化资源目录，根据不同语言设置匹配资源。
         • module.json5：Stage模型模块配置文件。

5. build-profile.json5：当前的模块信息、编译信息配置项。

6. hvigor：配置和管理项目的构建过程。

   • hvigor-config.json5：指定hvigor的版本、构建依赖以及构建行为的配置参数。

7. oh_modules：存放三方库依赖信息，包含应用/服务所依赖的第三方库文件。

8. oh-package.json5：描述全局配置。

JSON5配置文件作用说明

1. app.json5：应用的全局配置文件，包含了应用的包名、版本号、图标等信息。这个文件类似于应用的“身份证”，让系统能够识别和区分不同的应用。

   • bundleName：应用的唯一标识，通常采用反域名形式。
   • versionCode 和 versionName：应用的版本信息，用于更新和兼容性管理。
   • icon 和 label：应用的图标和名称，用于用户界面显示。

2. module.json5：模块级别的配置文件，定义了模块的名称、类型、设备类型等信息。这个文件就像是模块的“说明书”，告诉系统这个模块是干什么的，能在哪些设备上运行。

   • name 和 type：模块的名称和类型，决定了模块的角色和行为。
   • deviceTypes：模块支持的设备类型，让模块能够在正确的设备上运行。

这些配置文件和目录结构共同定义了鸿蒙NEXT项目的基本框架和行为，是开发过程中不可或缺的一部分。通过合理配置这些文件，开发者可以精确控制应用的行为和特性。