Android 项目包含许多与构建相关的文件和目录结构，用于组织您的应用程序源代码和资源。在深入了解配置详细信息之前，我们将先了解整体结构以及每个部分的基本内容。
此表列出了 Android 项目中常见的典型文件。每个文件或目录的描述都包含有关应在其中放置哪种类型内容的说明。最佳实践会随着时间的推移而发展，这些描述可能与您继承的项目或从互联网下载的项目不匹配。
在编写构建文件时，请使用声明式方法；构建逻辑和任务定义应仅出现在插件中。通过将构建逻辑限制在插件中，构建文件将变为数据声明，这使得理解和编辑更加直接。未来的版本可能会包含其他规范，例如 声明式 Gradle，这将阻止构建文件中的构建逻辑。
文件夹/文件 |
用途 |
|---|---|
.gradle/ |
Gradle 项目缓存目录 由 Gradle 管理，包含下载的 Gradle 发行版、项目缓存和配置文件。 不要更改此目录中的文件！ |
.idea/ |
Android Studio 项目元数据 不要更改此目录中的文件！ |
build.gradle(.kts) |
仅应包含插件声明，以在子项目中设置通用的插件类路径。 其他代码应位于设置或嵌套项目级别的构建文件中。 |
gradle.properties |
包含 Gradle 属性，控制 Gradle 构建环境的各个方面，例如堆大小、缓存和并行执行。 此处定义了一些临时的 Android 属性，以减少随着添加和随后删除这些属性而对 AGP DSL 进行的更改。 |
gradlew (Linux, Mac) gradlew.bat (Windows) |
Gradle 包装器 文件 通过下载 Gradle 发行版然后将命令转发给它来引导构建。这样，您无需预先安装 Gradle 即可运行构建。 |
local.properties |
本地计算机配置 包含与本地计算机相关的属性，例如 Android SDK 的位置。 将此文件排除在源代码控制之外！ |
settings.gradle(.kts) |
包含 Gradle 初始化和项目配置的全局构建信息，例如
|
gradle/ |
|
↳ libs.versions.toml |
定义构建内部使用的依赖项和插件的变量。您在此处指定要使用的版本，确保项目中所有子项目的一致性。 |
↳ wrapper/ |
|
↳ gradle-wrapper.jar |
Gradle 引导程序 可执行文件 下载指定的 Gradle 发行版（如果不存在），并运行它，并将所有参数传递给它 |
↳ gradle-wrapper.properties |
Gradle 包装器 的配置 指定下载 Gradle 发行版的位置（包括要使用的版本）。 |
app/ |
子项目（在 Android Studio 中称为“模块”）可以构建应用程序或库，并且可能依赖于其他子项目或外部依赖项。
任何目录都可以是子项目，并且必须至少包含一个 build.gradle(.kts)文件，并使用settings.gradle(.kts)包含在构建中。 |
↳ build.gradle(.kts) |
声明如何构建此子项目。每个子项目都需要一个单独的构建文件，并且应该包含
您不应在构建文件中包含构建逻辑（例如 Kotlin 函数定义或条件）或任务声明。构建逻辑和任务只能包含在插件内部. |
↳ src/ |
子项目源文件 |
↳ main/ |
主 源集 所有构建变体通用的源代码和资源。此源代码充当所有构建的基础，其他更具体的源集会添加到或覆盖此源代码。 |
↳ java/ ↳ kotlin/ |
Kotlin 和 Java 源代码
|
↳ res/ |
包含应用程序资源，例如 XML 文件和图像。所有应用程序都使用一些基本资源，例如启动器图标，但许多这些资源（例如布局和菜单）仅在基于视图的应用程序中使用。Compose 应用程序使用在此目录下定义的字符串资源。 |
↳ AndroidManifest.xml |
由 Android 包管理器读取以告知系统
|
↳ androidTest/ |
设备测试 源集 包含将在 Android 设备或模拟器上运行的测试的源代码。这些测试可以访问真实的 Android 环境，但执行速度比主机测试慢。 |
↳ test/ |
主机测试 源集 包含在 JVM 中本地运行的测试的源代码，而不是在设备上运行的测试。这些测试的运行速度比设备测试快得多。但是，任何系统调用（包括运行应用程序的生命周期）都必须被模拟、伪造、存根或以其他方式模拟。
|
↳ proguard-rules.pro |
定义规则以控制应用程序缩减、优化和混淆。R8 删除不需要的代码和资源，优化运行时性能，并通过重命名标识符进一步最小化您的代码。 |