Optimize Android Gradle Build Configurations

This resource provides Android Gradle build configuration patterns using Kotlin DSL (.gradle.kts) for type safety and IDE support. It covers version catalogs for centralized dependency management, build variants and product flavors, signing configurations with environment variables, and build performance optimization through Gradle daemon, parallel execution, and caching. The material includes project-level settings.gradle.kts configuration, version catalog TOML structure, app-level build.gradle.kts patterns, and gradle.properties optimization settings.

Use these patterns when configuring Android projects with Kotlin DSL build scripts, implementing version catalogs in gradle/libs.versions.toml, setting up build types (debug/release) with minification and ProGuard, creating product flavors with buildConfigField and resValue, configuring signing with environment variables, or optimizing build performance with parallel execution and caching. Apply these patterns when structuring multi-module projects or implementing conditional dependencies based on build variants.

Do NOT use these patterns for non-Android Gradle projects or when working exclusively with Groovy DSL build scripts. These patterns assume Android Gradle Plugin and Kotlin plugin usage.

You work with Gradle configuration files including settings.gradle.kts for project structure, gradle/libs.versions.toml for dependency versions, build.gradle.kts for module configuration, and gradle.properties for build optimization. The patterns produce configurations with plugin declarations using the plugins {} block, dependency management with implementation and api, build types with signing configs, product flavors with dimensions, and compiler options for Java and Kotlin.

The configuration patterns reference Android Gradle Plugin (version 8.1.2), Kotlin (version 1.9.10), Jetpack Compose BOM (version 2023.10.01), Retrofit (version 2.9.0), androidx.core:core-ktx (version 1.12.0), Dagger Hilt with kapt, LeakCanary (version 2.12) for debug builds, JUnit (version 4.13.2), Mockito (version 5.5.0), Robolectric (version 4.10.3), and Espresso (version 3.5.1). Repository configuration includes google(), mavenCentral(), and gradlePluginPortal().

These patterns are for developers working with Android Gradle build configuration who need reference implementations for Kotlin DSL syntax, version catalog structure, build variant setup, signing configuration, and performance optimization settings.

Here's a complete settings.gradle.kts configuration with version catalog support:

pluginsManagement {
    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
    versionCatalogs {
        create("libs") {
            from(files("gradle/libs.versions.toml"))
        }
    }
}

rootProject.name = "MyAndroidApp"
include(":app", ":core", ":feature:auth")

And the corresponding version catalog structure:

[versions]
android-gradle-plugin = "8.1.2"
kotlin = "1.9.10"
compose-bom = "2023.10.01"
retrofit = "2.9.0"

[libraries]
androidx-core-ktx = { group = "androidx.core", name = "core-ktx", version = "1.12.0" }
compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "compose-bom" }
retrofit = { group = "com.squareup.retrofit2", name = "retrofit", version.ref = "retrofit" }

[plugins]
android-application = { id = "com.android.application", version.ref = "android-gradle-plugin" }
kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }