1.4.2 项目目录
在运行项目前,先来介绍HarmonyOS的项目目录,也就是开发工具左侧有层级的目录结构,如图 1-48 所示。项目目录包含了程序的代码、资源等应用开发必要的内容,这些内容按照一定的规则来组织,每个文件夹都有其特定含义,下面按照从上到下的顺序介绍各个目录的含义。
1..gradle
这个目录是Gradle的配置文件,由开发工具自动生成,一般情况下不需要进行修改。Gradle是一个自动化构建项目的工具,HarmonyOS项目使用Gradle来完成构建。Gradle帮助开发者轻松地完成项目的依赖管理、打包部署、应用签名等操作。
2..idea
这个目录用于存储项目的配置信息,包括历史记录、版本控制信息等,由开发工具自动生成,一般情况下不需要进行修改。
图1-48 项目目录
3.entry
这个目录是程序中最重要的目录,是应用的主模块,一个应用程序只有一个Entry模块。应用程序的代码和资源文件都保存在这个目录下。entry 目录还包括若干子目录,我们稍后详细介绍entry目录的子目录。
4.gradle
这 个 目 录 由 系 统 自 动 生 成,包 含gradle-wrapper.jar 和 配 置 文 件。gradle-wrapper.jar 是对 Gradle 的封装,可以用来简化Gradle的构建操作。
5..gitignore
该文件用于在git版本控制中选择将哪些文件或目录忽略,使其不用被 git管理,比如 IDE自身的配置信息等。
6.build.gradle
该文件是 Gradle 的构建脚本,这个文件在entry目录下也存在。这里的build.gradle是全局构建脚本,在子模块中的 build.gradle 是针对各个模块的构建脚本。其中指定了项目所依赖的库文件、仓库地址等信息。可以把需要引入的外部程序包在build.gradle中进行声明。
7.gradle.properties
该文件是Gradle的配置文件,以Key-Value格式进行声明,可用于保存项目的全局变量。
8.gradlew和gradlew.bat
这两个文件用于在命令行中执行gradle命令,其中gradlew用于Linux或Mac系统,gradlew.bat用于Windows系统。
9.local.properties
这个文件是DevEco Studio自动生成的,保存了SDK路径,不需要修改这个文件。
10.settings.gradle
该文件表示项目引入的模块,当在项目中创建新的模块后,会自动在这里加入相应的配置,你也可以手动添加要引入的模块名称。
以上为项目的外层目录,需要开发者关注的通常为entry目录和build.gradle文件,其他的大部分文件不需要进行修改。下面来看entry目录下的内容。
(1)build。项目编译后生成的一些文件保存在这里,一般不需要修改。
(2)libs。libs用于存储Entry模块的依赖库文件。
(3)src。src保存了项目的源码。
(4).gitignore。该文件用于在git版本控制中选择将哪些文件或目录忽略,使其不用被git管理。
(5)build.gradle。该文件是本模块的Gradle构建脚本。
(6)proguard-rules.pro。该文件是配置代码混淆模板。
以上为 entry 目录下的文件和文件夹。下面重点来看 src 的文件结构,在src中包括main、ohosTest、test目录。其中:main目录为程序源码位置;ohosTest目录为测试框架的目录,开发者可以利用测试框架编写测试代码;test 目录为编写单元测试代码的目录,运行在本地Java虚拟机(JVM)上。src目录及其含义如表1-1所示。
表1-1 src目录及其含义
续表
以上为 HarmonyOS 项目默认的配置文件介绍。有些文件夹在创建默认项目时没有用到,在后面具体应用时再继续进行介绍。