android-build-gradle

Android Gradle Plugin (AGP) Build Reference

A skill covering the main topics of the Android Gradle Plugin (AGP) official documentation. Depending on the user's task, read the appropriate README.md and follow it to the individual files.

Directory structure

skills/android-build-gradle/
  SKILL.md
  references/
    build-config/
      README.md
      settings-gradle.md
      root-build-gradle.md
      module-build-gradle.md
      plugins-block.md
      android-block.md
      default-config.md
      build-types.md
      product-flavors.md
      build-features.md
      source-sets.md
      compile-kotlin-options.md
      signing-configs.md
      packaging.md
      test-options.md
      lint-config.md
      gradle-properties.md
      local-properties.md
      multidex.md
      native-16kb-page-size.md
      native-dependencies-prefab.md
      native-build-cmake.md
    dependencies/
      README.md
      dependency-configurations.md
      dependency-coordinates.md
      repositories.md
      version-catalog.md
      compose-bom.md
      dependency-exclusion.md
      viewing-dependencies.md
      ksp-vs-kapt.md
      migrate-to-catalogs.md
      variant-specific-dependencies.md
      dependency-verification.md
    optimize-release/
      README.md
      shrink-code.md
      proguard-rules.md
      r8-troubleshooting.md
      shrink-resources.md
      app-bundle.md
      bundle-config.md
      apk-splits.md
      app-signing.md
      debuggable-obfuscation.md
      baseline-profiles.md
      build-variant-optimization.md
      release-checklist.md
      native-debug-symbols.md
      dynamic-feature-modules.md
    publish-library/
      README.md
      prep-library-release.md
      publication-variants.md
      upload-library.md
      test-fixtures-publishing.md
      fused-library.md
    migrate-troubleshoot/
      README.md
      build-speed-optimization.md
      build-cache-configuration-cache.md
      migrate-to-ksp.md
      migrate-to-kotlin-dsl.md
      agp-upgrade-assistant.md
      agp-gradle-version-compatibility.md
      jdk-configuration.md
      namespace-migration.md
      manifest-merger-conflicts.md
      build-analyzer.md
      dependency-resolution-errors.md
      migrate-to-built-in-kotlin.md
      custom-build-logic.md
      sdk-upgrade-assistant.md
      agp-kotlin-d8-r8-compatibility.md

Exploration procedure

Derive the category from the task, and identify the target page in the category's README.md:

1. Find the category corresponding to the task in the mapping table below
2. That category's references/{category}/README.md Refer to to identify the target page
3. The relevant page's .md Read to check the details

Task → Category Mapping

Task	Category	Reference README
Want to know the structure of settings.gradle.kts / build.gradle.kts	build-config	references/build-config/README.md
Want to configure the android {} block, defaultConfig, buildTypes, productFlavors	build-config	references/build-config/README.md
Want to configure buildFeatures (Compose/ViewBinding), sourceSets, signingConfigs	build-config	references/build-config/README.md
Want to check gradle.properties / local.properties / lint settings	build-config	references/build-config/README.md
Want to use dependency configurations such as implementation / api / ksp / kapt	dependencies	references/dependencies/README.md
Want to manage versions with a version catalog (libs.versions.toml) or the Compose BOM	dependencies	references/dependencies/README.md
Excluding and resolving dependencies, and ./gradlew dependencies want to know how to read	dependencies	references/dependencies/README.md
Want to configure code shrinking and obfuscation with R8/ProGuard	optimize-release	references/optimize-release/README.md
Want to optimize releases with App Bundle / APK splits / baseline profile	optimize-release	references/optimize-release/README.md
Want to check signing settings and the release checklist	optimize-release	references/optimize-release/README.md
Want to prepare an Android library for release and configure metadata	publish-library	references/publish-library/README.md
Want to publish a library to Maven (publication variants / upload)	publish-library	references/publish-library/README.md
Want to publish a fused library or test fixtures	publish-library	references/publish-library/README.md
Want to improve build speed, build cache / configuration cache	migrate-troubleshoot	references/migrate-troubleshoot/README.md
Want to migrate from kapt to KSP, and from Groovy to Kotlin DSL	migrate-troubleshoot	references/migrate-troubleshoot/README.md
Want to deal with AGP upgrades, manifest merging, and dependency resolution errors	migrate-troubleshoot	references/migrate-troubleshoot/README.md

For how to write tests, see android-testing; for manifest and resource specifications, see android-platform-core is in charge.