android-gradle-expert

Android Gradle Expertise 🐘💎

The ultimate guide to modern, efficient, and modular Android builds with Gradle Kotlin DSL and Version Catalogs.

⚡ When to Use

• Dependency Management: Centralizing versions and libraries.
• Build Types & Flavors: Implementing environments (staging, prod) or product variants.
• Modularization: Splitting data, UI, or library modules.
• Gradle Performance: Optimizing build times.
• Code Optimization: Configuring R8, ProGuard, and shrinking.
• Release Automation: Signing APKs/AABs.

🏗️ Foundational Build Files

Before starting any Gradle configuration, ensure the following core files are present and properly configured:

1. gradle-wrapper.properties (8.4+)

• Rule: ALWAYS use a modern Gradle version (8.4+) to support Kotlin 1.9.x+ and modern AGP (8.3.x+).
• Core Setting: distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-bin.zip

2. gradle.properties (AndroidX & Performance)

• Role: Enabling Modern Android support and build performance.

• Mandatory:

  android.useAndroidX=true
  android.enableJetifier=true
  org.gradle.parallel=true
  org.gradle.caching=true
  

🏗️ Modern Build Standards

1. Version Catalogs (libs.versions.toml)

• Rule: Never hardcode versions in build.gradle.kts. Use the catalog.

• Structure:

  [versions]
  compose = "1.6.0"
  kotlin = "2.0.0"
  
  [libraries]
  compose-ui = { group = "androidx.compose.ui", name = "ui", version.ref = "compose" }
  
  [plugins]
  android-app = { id = "com.android.application", version = "8.3.0" }
  

2. Kotlin DSL (.kts)

• Consistently use Kotlin for build scripts for type-safety and IDE support.

3. Convention Plugins

• For multi-module projects, use "Convention Plugins" (in build-logic) to share common build logic (e.g., Compose setup, Hilt, Room).

4. Crucial Dependencies (Often Missed)

When scaffolding a new Compose project, ensure these are added to prevent compilation/runtime errors:

• Image Loading: io.coil-kt:coil-compose
• Hilt Navigation: androidx.hilt:hilt-navigation-compose
• Adaptive UI: androidx.compose.material3:material3-window-size-class
• Security: androidx.biometric:biometric (use androidx, NOT android.hardware.biometrics for UI prompts)