📖 Manuel

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.