1.5　HarmonyOS项目分析

1.5.1　项目逻辑视图

首先整体了解一下一个HarmonyOS应用软件的整体项目逻辑视图及模块组成，如图1.38所示。

HarmonyOS的应用软件，以App（App Pack）的形式发布，每个App由一个或多个HAP（HarmonyOS Ability Package）及pack.info组成。其中，pack.info用于描述每个HAP的属性，主要包括该HAP是否随应用安装（delivery-with-install）、HAP文件名（name）、HAP模块包类型（module-type）、支持该HAP运行的设备类型（device-type）等。

其中，每个HAP模块包由Ability（Ability是应用具备的能力，HarmonyOS应用代码围绕Ability组件展开，第3章会详细讲解）、第三方库（libs）、资源文件（Resources）及应用配置文件（config.json）组成。HAP模块包分为entry和feature两种类型。

（1）entry：应用的主模块。在一个App中，同一设备类型必须有且仅能有一个entry类型的HAP包，可独立安装运行。

（2）feature：应用的动态类型模块。在一个App中，可以包含一个或多个feature类型的HAP包，也可以不包含，但只有包含Ability的HAP包才能独立运行。

1.5.2　项目结构与文件

现在来看一下之前创建的Hello World项目，项目结构如图1.39所示。这里逐一介绍每个文件的内容。

1）.gradle和idea

这两个文件是由DevEco Studio自动生成的配置文件，一般情况下不需要进行修改。

2）build

build文件夹中包含了一些在编译时自动生成的文件，一般也不需要进行修改。

3）entry

entry是默认启动模块，是项目中的主模块，随后开发中的源码文件和资源文件均在entry中。

4）gradle

目录下包含了gradle wrapper的配置文件。

5）.gitignore

该文件用来将指定的目录或文件排除在版本控制之外。

6）build.gradle

项目全局的gradle构建脚本。

7）gradle.properties

项目全局的gradle配置文件，其中配置的属性会影响项目中所有的gradle编译脚本。

8）gradlew和gradlew.bat

这两个文件用来在命令行界面中执行gradle命令，其中，gradlew用于Linux或Mac系统，gradlew.bat用于Windows系统。

9）local.properties

文件用于指定本机中的SDK路径，通常自动生成而无须修改。若更改了本机中的SDK路径，则应对该文件中的路径进行修改。

10）MyApplication.iml

.iml文件是由DevEco Studio自动生成的文件，用来标识这是一个DevEco Studio项目，无须进行修改。

11）settings.gradle

该文件用来表示项目中所有引入的模块。通常在项目中新建一个模块之后，settings.gradle会自动引入该模块。

以上是整个项目的外层目录结构，其中绝大多数为自动生成的文件。entry目录为整个项目的重点，在这里进行主要的应用开发。下面展开entry进行进一步分析。

这里先介绍Java工程下的entry目录结构，如图1.40所示。

1）build

与外层的build文件相似，包含一些在编译时自动生成的文件，一般不需要修改。

2）libs

存放entry模块下的第三方依赖文件。

3）src→main→java

开发者用于编写Java源码文件的存放目录。

4）src→main→resources

开发者用于存放开发资源文件的目录，包括图片、音视频等资源文件。

5）src→main→config.json

应用配置文件。用于声明应用的Ability信息，以及应用所需的权限等信息。

6）src→test

开发者用于编写测试文件的目录。

7）.gitignore

用于将entry模块内的指定目录或文件排除在版本控制之外，其作用和外层的.gitignore文件基本一致。

8）build.gradle

entry模块的gradle构建脚本，指定与项目构建相关的配置信息。

9）entry.iml

DevEco Studio自动生成的文件，无须进行修改。

这是Java项目的目录结构，这里也可以创建JS项目，以此来学习JS项目的目录结构。如选择TV设备下的Empty Feature Ability（JS），创建完成后，在项目的目录结构中，除了包括Java项目文件外，还多了JS文件夹及相应文件，如图1.41所示。

1）js→default→i18n

i18n是英文单词internationalization的缩写，是“国际化”的简称。i18n文件夹用于存放配置不同语言场景的资源，例如应用文本词条、图片路径等资源。

2）js→default→pages

pages文件夹用于存放多个页面的开发文件，例如图中一个index表示一个页面，每个页面由HML、CSS和JS文件组成。

（1）index.hml: HML模板文件，用来描述当前页面的布局结构，类似于网页中的HTML文件。

（2）index.css: CSS样式文件，用于描述页面样式。

（3）index.js: JS文件，用于处理页面和用户的交互。 YyhfXiYRent1quoJE5Gw+EzC9J1ySad4HRz+xCUjN9I3WUqiMgFW79MQsxeI55xx