kotlin-tooling-agp9-migration

Migrate Kotlin Multiplatform library modules to AGP 9.0 with the new plugin.

302|22|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/JetBrains/skills --skill kotlin-tooling-agp9-migration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kotlin-tooling-agp9-migration
Source: https://github.com/JetBrains/skills/tree/main/kotlin-tooling-agp9-migration
Command: npx skills add https://github.com/JetBrains/skills --skill kotlin-tooling-agp9-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides developers through migrating Kotlin Multiplatform projects to AGP 9.0+, replacing legacy Android library plugins and aligning with the new KMP library model.

Core Features & Use Cases

  • Replaces com.android.library with com.android.kotlin.multiplatform.library in KMP modules.
  • Upgrades Gradle, Kotlin Gradle Plugin, and AGP; updates plugin declarations in root to support built-in Kotlin.
  • Handles single-variant library behavior, removes conflicting Kotlin Android and kapt plugins, and provides migration steps for dependencies and source sets.

Quick Start

Follow the guided steps to convert a KMP library module from AGP 8.x to AGP 9.x, ensuring AGP 9.x compatibility and plugin migration.

Frequently Asked Questions about kotlin-tooling-agp9-migration

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

FAQPage Schema
How do I migrate a Kotlin Multiplatform library to AGP 9.0?

To migrate a Kotlin Multiplatform library to AGP 9.0, replace the com.android.library plugin with com.android.kotlin.multiplatform.library and update your Gradle, Kotlin, and plugin declarations to align with the single-variant library model.

What Gradle and JDK versions are required for AGP 9.0 KMP migration?

AGP 9.0 KMP migration requires Gradle 9.1+, AGP 9.0+, and JDK 17+ as minimum environment prerequisites. You must also update your version catalog or explicitly declare plugin dependencies to support the built-in Kotlin integration.

Why do I need to replace com.android.library with com.android.kotlin.multiplatform.library?

Replacing com.android.library with com.android.kotlin.multiplatform.library enables the new KMP library model in AGP 9.0, ensuring built-in Kotlin integration, single-variant library behavior, and proper support for Android and iOS targets.

How do I handle kapt and KSP plugins when upgrading KMP to AGP 9.0?

When upgrading KMP to AGP 9.0, you must remove conflicting Kotlin Android and kapt plugins. The migration process provides specific steps to address KSP, kapt, resource, and NDK considerations under the new single-variant library model.

Does AGP 9.0 migration work for KMP modules with both Android and iOS targets?

Yes, AGP 9.0 migration applies specifically to Kotlin Multiplatform modules using kotlin.multiplatform with Android and iOS targets, ensuring the single-variant library model and built-in Kotlin integration are properly configured.

What are the limitations of migrating KMP to AGP 9.0?

AGP 9.0 KMP migration requires removing conflicting kapt plugins and addressing NDK, resource, and KSP considerations. Modules must use the single-variant library model, and the environment must meet the Gradle 9.1+, AGP 9.0+, and JDK 17+ minimums.