agp-9-upgrade

Upgrade Android projects to AGP 9 with migration steps and build verification.

2|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/iadr-dev/colab --skill agp-9-upgrade-iadr-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agp-9-upgrade
Source: https://github.com/iadr-dev/colab/tree/main/skills/coding/android/agp-9-upgrade
Command: npx skills add https://github.com/iadr-dev/colab --skill agp-9-upgrade-iadr-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Android Gradle Plugin (AGP) 9 upgrades can be breaking and require coordinated changes across Gradle, JDK, Kotlin, and Android build configuration, making migrations slow and error-prone.

Core Features & Use Cases

  • AGP 9 readiness checks: Verifies current AGP version and guards against unsupported project types (like Kotlin Multiplatform).
  • Migration of build setup: Updates KSP and Hilt versions as needed, migrates to built-in Kotlin, and moves to the new AGP DSL.
  • Tooling compatibility fixes: Migrates kapt to KSP or legacy-kapt and handles special cases like custom BuildConfig fields and Paparazzi HTML report issues.
  • Build verification: Confirms migration quality via IDE sync, Gradle help, and a dry-run build.

Quick Start

Ask your AI agent to migrate your Android project to Android Gradle Plugin 9 following the AGP 9 migration guide and then verify Gradle sync and a dry-run build.

Frequently Asked Questions about agp-9-upgrade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate my Android project to Android Gradle Plugin 9?

Migrating to Android Gradle Plugin 9 requires updating KSP and Hilt versions, migrating to built-in Kotlin, applying the new AGP DSL, and cleaning up gradle.properties to ensure full compatibility.

Does AGP 9 migration support Kotlin Multiplatform projects?

AGP 9 migration does not support Kotlin Multiplatform projects. The migration process explicitly rejects KMP projects as unsupported and targets only single-platform Android projects.

What steps are needed to migrate kapt to KSP for AGP 9?

Migrating kapt to KSP for AGP 9 involves updating KSP and Hilt versions, transitioning legacy kapt configurations to KSP, and handling special cases like custom BuildConfig fields and Paparazzi HTML report issues.

What changes are required when moving to the AGP 9 DSL?

Moving to the AGP 9 DSL requires migrating to built-in Kotlin, updating your build configuration syntax, and cleaning up gradle.properties to comply with the new compatibility constraints of Android Gradle Plugin 9.

Why does my AGP 9 upgrade fail during Gradle sync and dry-run build?

An AGP 9 upgrade may fail if prerequisite checks are unmet, such as outdated KSP or Hilt versions, unresolved kapt migrations, or lingering gradle.properties issues that break IDE sync and dry-run build verification.