skills.rest
IsKenKenYa
IsKenKenYaCOMMUNITY
Explore all skills by this author →
GitHub

agp-9-upgrade

Migrates Android projects to Android Gradle Plugin 9 with built-in Kotlin and new DSL.

2|Updated Jun 21, 2026
Search Tags:#migration#build system#android#gradle#ksp#kapt#agp 9
One-click install
npx skills add https://github.com/IsKenKenYa/skills --skill agp-9-upgrade-iskenkenya
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agp-9-upgrade
Source: https://github.com/IsKenKenYa/skills/tree/main/skills/android/build-system/agp/agp-9-upgrade
Command: npx skills add https://github.com/IsKenKenYa/skills --skill agp-9-upgrade-iskenkenya

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Upgrading an Android project to Android Gradle Plugin (AGP) 9 involves many breaking changes—built-in Kotlin, a new DSL, kapt removal, and BuildConfig API changes—that are easy to get wrong manually. This Skill provides a verified, step-by-step migration procedure. ## Core Features & Use Cases - Guided AGP 9 Migration: Walks through dependency updates (KSP 2.3.6+, Hilt 2.59.2+), built-in Kotlin migration, new AGP DSL adoption, and gradle.properties cleanup. - kapt to KSP Migration: Explains how to check whether annotation processors are KSP-compatible by inspecting jars in the Gradle cache, and how to fall back to the legacy-kapt plugin. - BuildConfig & Troubleshooting References: Covers custom BuildConfig field migration, Paparazzi/Gradle 9 workarounds, and gradle-recipes for old-DSL code replacement. - Use Case: You have an Android app on AGP 8 and want to adopt AGP 9. The Skill checks your current version, updates dependencies, migrates your build scripts to the new DSL, and verifies the result with Gradle sync and dry-run builds. ## Quick Start Migrate this Android project to AGP 9, updating dependencies, build scripts, and kapt usage, then verify the build succeeds.

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 an Android project to AGP 9?▼

First confirm the project is on AGP 9 or higher, using the AGP Upgrade Assistant in Android Studio if needed. Then update KSP to 2.3.6+ and Hilt to 2.59.2+, migrate to built-in Kotlin, adopt the new AGP DSL, convert kapt to KSP, and clean up gradle.properties flags.

How to migrate kapt to KSP in Android Gradle builds?▼

Remove the org.jetbrains.kotlin.kapt plugin, then check each kapt dependency for KSP compatibility by inspecting its jar for a SymbolProcessorProvider service file in the Gradle cache. Migrate compatible processors to KSP and apply the com.android.legacy-kapt plugin for the rest.

Does AGP 9 support Kotlin Multiplatform projects?▼

No, this migration path does not support Kotlin Multiplatform (KMP) projects. The Skill explicitly instructs not to use it for KMP projects, as they are unsupported.

Why does Paparazzi break with AGP 9 and Gradle 9?▼

Paparazzi 2.0.0-alpha04 and lower use internal Gradle classes that moved in Gradle 9, breaking HTML test reports. The workaround is to disable HTML test reports in every module applying the Paparazzi plugin, using either Kotlin or Groovy DSL.

How do I verify an AGP 9 migration succeeded?▼

Verify three things: Gradle IDE sync succeeds, ./gradlew help succeeds, and ./gradlew build --dry-run succeeds. Do not run the clean task during verification, as it wastes time.

Related Skills

Explore More Software Engineering Skills→
citytexicitytexi
1

agp-9-upgrade

Migrates Android projects to Android Gradle Plugin 9 with built-in Kotlin and new DSL.

Community
Advanced
flutterflutter
2.0k

verify-eap-compatibility

Verifies IntelliJ plugin compatibility against latest EAP platform builds using Gradle tasks.

Official
Intermediate
premex-abpremex-ab
1

agp-9-upgrade

Upgrade Android projects to AGP 9 with compatibility checks and migration steps.

Official
Advanced
dominodatalabdominodatalab
6

domino-environments

Create and customize Domino Compute Environments with Dockerfile configuration and package management.

Official
Intermediate