鸿蒙OS应用开发之——项目介绍

一 概述

• 项目工程结构
• 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逻辑文件和应用的生命周期管理