Gradle 使用两个主要目录来执行和管理其工作:Gradle 用户主目录和项目根目录。

Gradle 用户主目录
默认情况下,Gradle 用户主目录(~/.gradle
或 C:\Users\<USERNAME>\.gradle
)存储全局配置属性、初始化脚本、缓存和日志文件。
它可以通过环境变量 GRADLE_USER_HOME
进行设置。
请勿与 GRADLE_HOME 混淆,后者是 Gradle 的可选安装目录。 |
它的结构大致如下:
├── caches (1)
│ ├── 4.8 (2)
│ ├── 4.9 (2)
│ ├── ⋮
│ ├── jars-3 (3)
│ └── modules-2 (3)
├── daemon (4)
│ ├── ⋮
│ ├── 4.8
│ └── 4.9
├── init.d (5)
│ └── my-setup.gradle
├── jdks (6)
│ ├── ⋮
│ └── jdk-14.0.2+12
├── wrapper
│ └── dists (7)
│ ├── ⋮
│ ├── gradle-4.8-bin
│ ├── gradle-4.9-all
│ └── gradle-4.9-bin
└── gradle.properties (8)
1 | 全局缓存目录(用于所有非项目特定的内容)。 |
2 | 特定于版本的缓存(例如,支持增量构建)。 |
3 | 共享缓存(例如,用于依赖项的 artifact)。 |
4 | Gradle 守护进程的注册表和日志。 |
5 | 全局初始化脚本。 |
6 | 工具链支持下载的 JDK。 |
7 | Gradle 包装器下载的分发版。 |
8 | 全局Gradle 配置属性。 |
请查阅Gradle 目录参考以了解更多信息。
项目根目录
项目根目录包含项目中的所有源文件。
它还包含 Gradle 生成的文件和目录,例如 .gradle
和 build
,以及 Gradle 配置目录:gradle
。
gradle 和 .gradle 目录是不同的。 |
虽然 gradle
通常会提交到版本控制中,但 build
和 .gradle
目录包含构建的输出、缓存以及 Gradle 用于支持增量构建等功能的其他临时文件。
典型项目根目录的结构如下:
├── .gradle (1)
│ ├── 4.8 (2)
│ ├── 4.9 (2)
│ └── ⋮
├── build (3)
├── gradle
│ └── wrapper (4)
├── gradle.properties (5)
├── gradlew (6)
├── gradlew.bat (6)
├── settings.gradle.kts (7)
├── subproject-one (8)
| └── build.gradle.kts (9)
├── subproject-two (8)
| └── build.gradle.kts (9)
└── ⋮
1 | Gradle 生成的特定于项目的缓存目录。 |
2 | 特定于版本的缓存(例如,支持增量构建)。 |
3 | 此项目的构建目录,Gradle 将所有构建 artifact 生成到其中。 |
4 | 包含Gradle 包装器的 JAR 文件和配置。 |
5 | 特定于项目的Gradle 配置属性。 |
6 | 使用Gradle 包装器执行构建的脚本。 |
7 | 项目的设置文件,其中定义了子项目列表。 |
8 | 通常,一个项目被组织成一个或多个子项目。 |
9 | 每个子项目都有自己的 Gradle 构建脚本。 |
请查阅Gradle 目录参考以了解更多信息。
下一步:了解如何构建多项目构建 >>