Gradle 构建工具

1. 配置 gradle.properties

在 %USERPROFILE%\.gradle\gradle.properties 添加：

# 启用构建缓存
org.gradle.caching=true

# 启用并行构建
org.gradle.parallel=true

# 启用配置缓存（Gradle 7.4+）
org.gradle.configuration-cache=true

# 设置 JVM 堆内存
org.gradle.jvmargs=-Xmx2048m -XX:MaxMetaspaceSize=512m

# 启用守护进程
org.gradle.daemon=true

2. 使用构建缓存

# 使用 --build-cache 参数
gradlew build --build-cache

# 或在 gradle.properties 中永久启用
org.gradle.caching=true

3. 常用优化命令

# 并行构建
gradlew build --parallel

# 离线模式（依赖已下载）
gradlew build --offline

# 只运行特定任务
gradlew assembleDebug

# 查看任务执行时间
gradlew build --profile

settings.gradle 配置

rootProject.name = 'my-project'

// 包含子项目
include 'module-a'
include 'module-b'
include 'module-c'

// 或者使用扁平化结构
include ':app', ':lib', ':common'

项目结构示例

my-project/
├── build.gradle          # 根项目配置
├── settings.gradle       # 项目设置
├── gradle.properties     # 全局属性
├── app/                  # 应用模块
│   └── build.gradle
├── lib/                  # 库模块
│   └── build.gradle
└── common/               # 公共模块
    └── build.gradle

模块间依赖

dependencies {
    implementation project(':lib')
    implementation project(':common')
}

plugins {
    id 'com.android.application'
    id 'org.jetbrains.kotlin.android'
}

android {
    namespace 'com.example.app'
    compileSdk 34

    defaultConfig {
        applicationId "com.example.app"
        minSdk 24
        targetSdk 34
        versionCode 1
        versionName "1.0"

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
    
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_17
        targetCompatibility JavaVersion.VERSION_17
    }
}

dependencies {
    implementation 'androidx.core:core-ktx:1.12.0'
    implementation 'androidx.appcompat:appcompat:1.6.1'
    implementation 'com.google.android.material:material:1.11.0'
    
    testImplementation 'junit:junit:4.13.2'
    androidTestImplementation 'androidx.test.ext:junit:1.1.5'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
}

plugins {
    id 'org.jetbrains.kotlin.jvm' version '1.9.21'
    id 'application'
}

repositories {
    mavenCentral()
}

dependencies {
    // Kotlin 标准库
    implementation 'org.jetbrains.kotlin:kotlin-stdlib:1.9.21'
    
    // Kotlin 协程
    implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.3'
    
    // 测试依赖
    testImplementation 'org.jetbrains.kotlin:kotlin-test:1.9.21'
    testImplementation 'org.junit.jupiter:junit-jupiter:5.10.1'
}

tasks.test {
    useJUnitPlatform()
}

kotlin {
    jvmToolchain(17)
}

解决方案：

1. 增加 Gradle JVM 堆内存：

   # gradle.properties
   org.gradle.jvmargs=-Xmx4096m -XX:MaxMetaspaceSize=1024m

2. 设置 GRADLE_OPTS 环境变量：

   # Windows
   set GRADLE_OPTS=-Xmx4096m
   
   # Mac/Linux
   export GRADLE_OPTS="-Xmx4096m"

3. 关闭其他应用释放内存

查看依赖树：

gradlew dependencies
gradlew dependencyInsight --dependency <库名>

解决方案：

1. 使用 constraints 强制指定版本
2. 使用 exclude 排除传递依赖
3. 使用平台/BOM 统一管理版本

dependencies {
    // 强制指定版本
    constraints {
        implementation 'com.google.guava:guava:32.1.3-jre'
    }
    
    // 排除传递依赖
    implementation('some:lib:1.0') {
        exclude group: 'conflict-group', module: 'conflict-module'
    }
}

Gradle 与 JDK 版本对应关系：

建议：使用 Gradle Wrapper 管理版本，避免版本不兼容问题

使用 Wrapper 升级（推荐）：

# 升级 Wrapper 到指定版本
gradlew wrapper --gradle-version 8.5

# 升级 Wrapper 到最新版本
gradlew wrapper --gradle-version latest

# 然后提交 gradle-wrapper.properties 到版本控制

手动升级：

1. 修改 gradle/wrapper/gradle-wrapper.properties
2. 更新 distributionUrl 指向新版本

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-8.5-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists