Android 深度实践

Appearance

Gradle 概览 ​

源：Gradle 官方文档 | Android 构建概览

Gradle 是一个高度可定制的开源构建自动化工具，Android Studio 使用它来将你的源码、依赖和资源编译成最终的 APK/AAB。

1. 为什么 Android 选择 Gradle？ ​

  • 灵活的变体管理：支持开发版、生产版等多套包名和配置共存。
  • 依赖管理：自动从 Maven 等仓库下载库文件，处理版本冲突。
  • 增量构建：只编译发生变化的部分，大幅提升二次构建速度。
  • 可扩展性：支持自定义 Plugin 和 Task 来满足特殊的打包流程。

2. 三大核心文件 ​

kotlin
// 定义项目名称及包含哪些子模块
rootProject.name = "MyAwesomeApp"
include(":app")
include(":core:network")
kotlin
// 全局配置，通常用于定义插件版本和公共属性
plugins {
    alias(libs.plugins.android.application) apply false
    alias(libs.plugins.kotlin.android) apply false
}
kotlin
// 具体模块的编译逻辑：依赖、SDK版本、混淆规则等
plugins {
    alias(libs.plugins.android.application)
}

android {
    namespace = "com.example.app"
    compileSdk = 34
    // ...
}

3. Gradle Wrapper (gradlew) ​

最佳实践

始终建议通过 ./gradlew (Unix) 或 gradlew.bat (Windows) 来运行构建，而不是直接使用全局安装的 gradle。

它可以保证团队中所有人、所有服务器都使用完全一致的 Gradle 版本，避免“在我机器上能跑”的问题。