项目结构与生命周期

1. 标准 Android 项目目录

├── gradlew / gradlew.bat    # Gradle Wrapper 脚本
├── gradle/wrapper/          # 存放 Wrapper 的 jar 和属性文件
├── settings.gradle.kts      # 项目初始化配置
├── build.gradle.kts         # 根项目构建脚本
├── gradle/libs.versions.toml # 版本目录 (Version Catalog)
└── app/                     # 应用模块
    ├── build.gradle.kts     # 模块构建脚本
    └── src/
        ├── main/            # 源码、资源、清单文件
        ├── test/            # 单元测试 (JUnit)
        └── androidTest/     # UI 测试 (Espresso)

2. 构建生命周期 (Lifecycle)

Gradle 的构建过程分为三个阶段，理解它们对优化构建速度至关重要：

1. 初始化阶段 (Initialization): Gradle 确定哪些项目参与构建，并为每个项目创建一个 Project 实例。
2. 配置阶段 (Configuration): 执行所有参与构建的项目的构建脚本。

   • 警告

     不要在配置阶段执行耗时操作（如网络请求、读大文件），因为无论你运行哪个 Task，配置阶段都会执行。

3. 执行阶段 (Execution): Gradle 确定要执行的 Task 集合，并按顺序运行它们。

3. 初始化脚本 (init.gradle)

如果你想在所有项目中统一配置（例如：统一配置镜像源），可以使用初始化脚本。

位置：~/.gradle/init.gradle 或 init.gradle.kts。

// init.gradle.kts 示例：统一阿里云镜像
allprojects {
    repositories {
        maven { setUrl("https://maven.aliyun.com/repository/public") }
        google()
        mavenCentral()
    }
}