一 概述
- 项目工程结构
- java项目目录结构
- JS项目目录结构
二 项目工程结构
2.1 逻辑结构
HarmonyOS应用发布形态为APP Pack(Application Package,简称APP),它是由一个或多个HAP(HarmonyOS Ability Package)包以及描述APP Pack属性的pack.info文件组成
2.2 工程目录构成
一个HAP在工程目录中对应于一个Module,它是由代码、资源、第三方库及应用清单文件组成,可以分为Entry和Feature两种类型
- Entry:应用的主模块。一个APP中,对于同一设备类型必须有且只有一个entry类型的HAP,可独立安装运行
- Feature:应用的动态特性模块。一个APP可以包含一个或多个feature类型的HAP,也可以不包含
2.3 部署包
- HAP是Ability的部署包,HarmonyOS应用代码围绕Ability组件展开,它是由一个或多个Ability组成。
- Ability分为两种类型:FA(Feature Ability,中文名称:元程序)和PA(Particle Ability,中文名称:元服务)
- FA/PA是应用程序的基本组成单元,能够实现特定的业务功能。FA有UI界面,而PA无UI界面
三 java项目目录结构
3.1 java项目目录结构
3.2 项目说明
-
.gradle:Gradle配置文件,由系统自动生成,一般情况下不需要进行修改
-
entry:默认启动模块(主模块),开发者用于编写源码文件以及开发资源文件的目录
-
entry>libs:用于存放entry模块的依赖文件
-
entry>src>main>Java:用于存放Java源码
-
entry>src>main>resources:用于存放应用所用到的资源文件,如图形、多媒体、字符串、布局文件等
资源目录 资源文件说明 base>element 包括字符串、整型数、颜色、样式等资源的json文件。每个资源均由json格式进行定义,例如:
boolean.json:布尔型
color.json:颜色
float.json:浮点型
integer.json:整形
pattern.json:样式
plural.json:复数形式
strarray.json:字符串数组
string.json:字符串值base>graphic xml类型的可绘制资源,如SVG(Scalable Vector Graphics)可缩放矢量图形文件、基本的几何图形(如矩形、圆形、线等)shape资源等 base>layout xml格式的界面布局文件。 base>media 多媒体文件,如图形、视频、音频等文件,支持的文件格式包括:.png、.gif、.mp3、.mp4等。 base>profile 用于存储任意格式的原始资源文件。区别在于rawfile不会根据设备的状态去匹配不同的资源,需要指定文件路径和文件名进行引用 rawfile 用于存储任意格式的原始资源文件。区别在于rawfile不会根据设备的状态去匹配不同的资源,需要指定文件路径和文件名进行引用 -
**entry>src>main>config.json:**HAP清单文件
-
entry>src>test:编写代码单元测试代码的目录,运行在本地Java虚拟机(JVM)上
-
entry>.gitignore:标识git版本管理需要忽略的文件
-
entry>build.gradle:entry模块的编译配置文件
-
四 JS项目目录结构
4.1 JS项目目录结构
4.2 项目说明
- common目录:可选,用于存放公共资源文件,如媒体资源、自定义组件和JS文档等
- **i18n目录:**可选,用于存放多语言的json文件,可以在该目录下定义应用在不同语言系统下显示的内容,如应用文本词条、图片路径等
- **pages目录:**pages文件夹下可以包含1个或多个页面,每个页面都需要创建一个文件夹(如图中的index)。页面文件夹下主要包含3种文件类型:css、js和hml文件
- **pages>index>index.hml文件:**hml文件定义了页面的布局结构,使用到的组件,以及这些组件的层级关系
- **pages>index>index.css文件:**css文件定义了页面的样式与布局,包含样式选择器和各种样式属性等
- **pages>index>index.js文件:**js文件描述了页面的行为逻辑,此文件里定义了页面里所用到的所有的逻辑关系,比如数据、事件等
- **resources:**可选,用于存放资源配置文件,比如:全局样式、多分辨率加载等配置文件
- **app.js文件:**全局的JavaScript逻辑文件和应用的生命周期管理