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

一 概述

• 项目工程结构
• java项目目录结构
• JS项目目录结构

二 项目工程结构

2.1 逻辑结构

HarmonyOS应用发布形态为APP Pack(Application Package&＃xff0c;简称APP)&＃xff0c;它是由一个或多个HAP(HarmonyOS Ability Package)包以及描述APP Pack属性的pack.info文件组成

2.2 工程目录构成

一个HAP在工程目录中对应于一个Module&＃xff0c;它是由代码、资源、第三方库及应用清单文件组成&＃xff0c;可以分为Entry和Feature两种类型

• Entry&＃xff1a;应用的主模块。一个APP中&＃xff0c;对于同一设备类型必须有且只有一个entry类型的HAP&＃xff0c;可独立安装运行
• Feature&＃xff1a;应用的动态特性模块。一个APP可以包含一个或多个feature类型的HAP&＃xff0c;也可以不包含

2.3 部署包

• HAP是Ability的部署包&＃xff0c;HarmonyOS应用代码围绕Ability组件展开&＃xff0c;它是由一个或多个Ability组成。
• Ability分为两种类型&＃xff1a;FA(Feature Ability&＃xff0c;中文名称&＃xff1a;元程序)和PA(Particle Ability&＃xff0c;中文名称&＃xff1a;元服务)
• FA/PA是应用程序的基本组成单元&＃xff0c;能够实现特定的业务功能。FA有UI界面&＃xff0c;而PA无UI界面

三 java项目目录结构

3.1 java项目目录结构

3.2 项目说明

• .gradle&＃xff1a;Gradle配置文件&＃xff0c;由系统自动生成&＃xff0c;一般情况下不需要进行修改

• entry&＃xff1a;默认启动模块&＃xff08;主模块&＃xff09;&＃xff0c;开发者用于编写源码文件以及开发资源文件的目录

  • entry>libs&＃xff1a;用于存放entry模块的依赖文件

  • entry>src>main>Java&＃xff1a;用于存放Java源码

  • entry>src>main>resources&＃xff1a;用于存放应用所用到的资源文件&＃xff0c;如图形、多媒体、字符串、布局文件等

    资源目录	资源文件说明
    base>element	包括字符串、整型数、颜色、样式等资源的json文件。每个资源均由json格式进行定义&＃xff0c;例如&＃xff1a; boolean.json&＃xff1a;布尔型 color.json&＃xff1a;颜色 float.json&＃xff1a;浮点型 integer.json&＃xff1a;整形 pattern.json&＃xff1a;样式 plural.json&＃xff1a;复数形式 strarray.json&＃xff1a;字符串数组 string.json&＃xff1a;字符串值
    base>graphic	xml类型的可绘制资源&＃xff0c;如SVG&＃xff08;Scalable Vector Graphics&＃xff09;可缩放矢量图形文件、基本的几何图形&＃xff08;如矩形、圆形、线等&＃xff09;shape资源等
    base>layout	xml格式的界面布局文件。
    base>media	多媒体文件&＃xff0c;如图形、视频、音频等文件&＃xff0c;支持的文件格式包括&＃xff1a;.png、.gif、.mp3、.mp4等。
    base>profile	用于存储任意格式的原始资源文件。区别在于rawfile不会根据设备的状态去匹配不同的资源&＃xff0c;需要指定文件路径和文件名进行引用
    rawfile	用于存储任意格式的原始资源文件。区别在于rawfile不会根据设备的状态去匹配不同的资源&＃xff0c;需要指定文件路径和文件名进行引用

  • **entry>src>main>config.json&＃xff1a;**HAP清单文件

  • entry>src>test&＃xff1a;编写代码单元测试代码的目录&＃xff0c;运行在本地Java虚拟机&＃xff08;JVM&＃xff09;上

  • entry>.gitignore&＃xff1a;标识git版本管理需要忽略的文件

  • entry>build.gradle&＃xff1a;entry模块的编译配置文件

四 JS项目目录结构

4.1 JS项目目录结构

4.2 项目说明

• common目录&＃xff1a;可选&＃xff0c;用于存放公共资源文件&＃xff0c;如媒体资源、自定义组件和JS文档等
• **i18n目录&＃xff1a;**可选&＃xff0c;用于存放多语言的json文件&＃xff0c;可以在该目录下定义应用在不同语言系统下显示的内容&＃xff0c;如应用文本词条、图片路径等
• **pages目录&＃xff1a;**pages文件夹下可以包含1个或多个页面&＃xff0c;每个页面都需要创建一个文件夹&＃xff08;如图中的index&＃xff09;。页面文件夹下主要包含3种文件类型&＃xff1a;css、js和hml文件
  • **pages>index>index.hml文件&＃xff1a;**hml文件定义了页面的布局结构&＃xff0c;使用到的组件&＃xff0c;以及这些组件的层级关系
  • **pages>index>index.css文件&＃xff1a;**css文件定义了页面的样式与布局&＃xff0c;包含样式选择器和各种样式属性等
  • **pages>index>index.js文件&＃xff1a;**js文件描述了页面的行为逻辑&＃xff0c;此文件里定义了页面里所用到的所有的逻辑关系&＃xff0c;比如数据、事件等
• **resources&＃xff1a;**可选&＃xff0c;用于存放资源配置文件&＃xff0c;比如&＃xff1a;全局样式、多分辨率加载等配置文件
• **app.js文件&＃xff1a;**全局的Javascript逻辑文件和应用的生命周期管理