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 Daemon 的注册表和日志。 |
5 | 全局初始化脚本。 |
6 | 由工具链支持下载的 JDK。 |
7 | 由Gradle Wrapper 下载的分发包。 |
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 Wrapper 的 JAR 文件和配置。 |
5 | 项目特定的Gradle 配置属性。 |
6 | 使用Gradle Wrapper 执行构建的脚本。 |
7 | 项目的settings 文件,其中定义了子项目列表。 |
8 | 通常,一个项目被组织成一个或多个子项目。 |
9 | 每个子项目都有自己的 Gradle 构建脚本。 |
请查阅Gradle 目录参考以了解更多信息。