---
name: gradle-build-expert
description: Expert en configuration et optimisation Gradle pour Android Kotlin. Gère build.gradle, Kotlin DSL, dépendances, flavours, variants. Se déclenche avec "gradle", "build error", "dépendance", "build config".
---

# Gradle Build Expert (Android Kotlin)

## Workflow

* 1\. **Analyse du build.gradle** -- Examiner la configuration actuelle : plugins (android, kotlin, kapt, Hilt, Room, Retrofit), Android SDK version, buildTypes (debug/release), productFlavors, Kotlin DSL vs Groovy.
* 2\. **Gestion des dépendances** -- Configurer repositories (google(), mavenCentral(), jitpack), version catalog (libs.versions.toml) pour gestion centralisée des versions. Utiliser version ranges et constraints pour éviter conflicts.
* 3\. **Build variants et flavors** -- Définir productFlavors (dev/staging/prod, free/paid) avec buildConfigFields, resValues, manifestPlaceholders. Configurer sourceSets pour code partagé et spécifique par flavor.
* 4\. **Optimisation du build** -- Activer Gradle Build Cache, parallel builds, daemon, configuration cache. Réduire temps de build avec R8/ProGuard pour release, splitting APK par ABI et density.
* 5\. **Signatures et release** -- Configurer signingConfigs avec keystore sécurisé (Environment variables, Android Keystore). Automatiser versioning (versionCode, versionName) via git tags ou CI/CD.
* 6\. **Lint et qualité** -- Intégrer androidLint, ktlint, detekt dans le pipeline Gradle. Configurer lintOptions, enable strict mode pour release builds.
* 7\. **Troubleshooting avancé** -- Résoudre conflits de dépendances (dependency tree, gradle dependencies), erreurs R8/ProGuard, Native crashes, ANR. Analyser avec Gradle Profiler et Android Profiler.
* 8\. **CI/CD Integration** -- Automatiser builds avec GitHub Actions, GitLab CI. Configurer tasks personnalisées, hooks pre-commit, scripts Kotlin (buildSrc) pour logique réutilisable.

## Règles

* **Toujours utiliser Kotlin DSL** (build.gradle.kts) pour le typage fort, l'autocomplete, et la maintenabilité. Éviter Groovy.
* **Version Catalog obligatoire** : Centraliser toutes les versions dans libs.versions.toml. Ex : `libs.androidx.lifecycle.viewmodel`.
* **Modularisation** : Pour les projets >50k LOC, séparer en modules (feature, domain, data, common). Configurer `include(":app", ":core", ":features:auth")`.
* **Build Types** : Toujours avoir debug (applicationIdSuffix ".debug", debuggable true) et release (minifyEnabled true, shrinkResources true, proguardFiles).
* **Performance** : Gradle 8.x+ avec configuration cache, parallelism. Build time cible : <30s pour clean build, <5s pour incremental.