[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M71FQB5VP9CF8XZF4KMWZGZX":3,"skill-same:01M71FQB5VP9CF8XZF4KMWZGZX":71},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":39,"linkOnly":40,"markdownContent":41,"markdownBody":42,"frontMatter":43,"refName":48,"commitSha":49,"skillDirectory":50,"forksCount":51,"repositoryHtmlUrl":52,"repositoryHomepageUrl":6,"ownerHtmlUrl":53,"ownerBlogUrl":54,"ownerDescription":55,"updatedAt":56,"install":57,"resources":70},"01M71FQB5VP9CF8XZF4KMWZGZX","kotlin-tooling-agp9-migration",null,"Migrates Kotlin Multiplatform (KMP) projects to Android Gradle Plugin 9.0+. Handles plugin replacement (com.android.kotlin.multiplatform.library), module splitting, DSL migration, and the new default project structure. Use when upgrading AGP, when build fails due to KMP+AGP incompatibility, or when the user mentions AGP 9.0, android multiplatform plugin, KMP migration, or com.android.kotlin.multiplatform.library.","iDorgham\u002FWorkspace-Factory","iDorgham","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F136521493?v=4","01M6CNGBDAHE4ARW3YJEF4X2FD","Dorgham","01M71E8H3CXZ7DJX59MTM9JEB2",1,"Apache-2.0","https:\u002F\u002Fgithub.com\u002FiDorgham\u002FWorkspace-Factory\u002Fblob\u002Fmaster\u002F.ai\u002Fskills\u002Fofficial_kotlin_kotlin_tooling_agp9_migration\u002Fskill.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38],"kotlin tooling agp9 migration","kotlin","tooling","migration","kotlin tooling","android","use","module","kotlin multiplatform","library","project structure","jetbrains","structure","gradle","when","new","default","project","dsl","projects","2026-11-10 10:12:30",false,"---\nname: kotlin-tooling-agp9-migration\ndescription: >\n  Migrates Kotlin Multiplatform (KMP) projects to Android Gradle Plugin 9.0+.\n  Handles plugin replacement (com.android.kotlin.multiplatform.library), module\n  splitting, DSL migration, and the new default project structure. Use when\n  upgrading AGP, when build fails due to KMP+AGP incompatibility, or when the\n  user mentions AGP 9.0, android multiplatform plugin, KMP migration, or\n  com.android.kotlin.multiplatform.library.\nlicense: Apache-2.0\nmetadata:\n  author: JetBrains\n  version: \"1.0.0\"\n---\n\n# KMP AGP 9.0 Migration\n\nAndroid Gradle Plugin 9.0 makes the Android application and library plugins incompatible\nwith the Kotlin Multiplatform plugin in the same module. This skill guides you through the\nmigration.\n\n## Step 0: Analyze the Project\n\nBefore making any changes, understand the project structure:\n1. Read `settings.gradle.kts` (or `.gradle`) to find all modules\n2. For each module, read its `build.gradle.kts` to identify which plugins are applied\n3. Check if the project uses a Gradle version catalog (`gradle\u002Flibs.versions.toml`). If it exists,\n   read it for current AGP\u002FGradle\u002FKotlin versions. If not, find versions directly in `build.gradle.kts`\n   files (typically in the root `buildscript {}` or `plugins {}` block). **Adapt all examples in this\n   guide accordingly** — version catalog examples use `alias(libs.plugins.xxx)` while direct usage\n   uses `id(\"plugin.id\") version \"x.y.z\"`\n4. Read `gradle\u002Fwrapper\u002Fgradle-wrapper.properties` for the Gradle version\n5. Check `gradle.properties` for any existing workarounds (`android.enableLegacyVariantApi`)\n6. Check for `org.jetbrains.kotlin.android` plugin usage — AGP 9.0 has built-in Kotlin and this plugin must be removed\n7. Check for `org.jetbrains.kotlin.kapt` plugin usage — incompatible with built-in Kotlin, must migrate to KSP or `com.android.legacy-kapt`\n8. Check for third-party plugins that may be incompatible with AGP 9.0 (see \"Plugin Compatibility\" section below)\n\nIf Bash is available, run `scripts\u002Fanalyze-project.sh` from this skill's directory to get a structured summary.\n\n### Classify Each Module\n\nFor each module, determine its type:\n\n| Current plugins                                                          | Migration path                              |\n|--------------------------------------------------------------------------|---------------------------------------------|\n| `kotlin.multiplatform` + `com.android.library`                           | **Path A** — Library plugin swap            |\n| `kotlin.multiplatform` + `com.android.application`                       | **Path B** — Mandatory Android split        |\n| `kotlin.multiplatform` with multiple platform entry points in one module | **Path C** — Full restructure (recommended) |\n| `com.android.application` or `com.android.library` (no KMP)              | See \"Pure Android Tips\" below               |\n\n### Determine Scope\n\n- **Path B is mandatory** for any module combining KMP + Android application plugin\n- **Path C is recommended** when the project has a monolithic `composeApp` (or similar) module\n  containing entry points for multiple platforms (Android, Desktop, Web). This aligns with the\n  new JetBrains default project structure where each platform gets its own app module.\n- **Ask the user** whether they want Path B only (minimum required) or Path C (recommended full restructure)\n\n## Path A: Library Module Migration\n\nUse this when a module applies `kotlin.multiplatform` + `com.android.library`.\n\nSee references\u002FMIGRATION_LIBRARY.md (`references\u002FMIGRATION_LIBRARY.md`) for full before\u002Fafter code.\n\nSummary:\n\n1. **Replace plugin**: `com.android.library` → `com.android.kotlin.multiplatform.library`\n2. **Remove `org.jetbrains.kotlin.android`** plugin if present (AGP 9.0 has built-in Kotlin support)\n3. **Migrate DSL**: Move config from top-level `android {}` block into `kotlin { android {} }`:\n   ```kotlin\n   kotlin {\n       android {\n           namespace = \"com.example.lib\"\n           compileSdk = 35\n           minSdk = 24\n       }\n   }\n   ```\n4. **Rename source directories** (only if the module uses classic Android layout instead of KMP layout):\n   - `src\u002Fmain` → `src\u002FandroidMain`\n   - `src\u002Ftest` → `src\u002FandroidHostTest`\n   - `src\u002FandroidTest` → `src\u002FandroidDeviceTest`\n   - If the module already uses `src\u002FandroidMain\u002F`, no directory renames are needed\n5. **Move dependencies** from top-level `dependencies {}` into `sourceSets`:\n   ```kotlin\n   kotlin {\n       sourceSets {\n           androidMain.dependencies {\n               implementation(\"androidx.appcompat:appcompat:1.7.0\")\n           }\n       }\n   }\n   ```\n6. **Enable resources** explicitly if the module uses Android or Compose Multiplatform resources:\n   ```kotlin\n   kotlin {\n       android {\n           androidResources { enable = true }\n       }\n   }\n   ```\n7. **Enable Java** compilation if module has `.java` source files:\n   ```kotlin\n   kotlin {\n       android {\n           withJava()\n       }\n   }\n   ```\n8. **Enable tests** explicitly if the module has unit or instrumented tests:\n   ```kotlin\n   kotlin {\n       android {\n           withHostTest { isIncludeAndroidResources = true }\n           withDeviceTest {\n               instrumentationRunner = \"androidx.test.runner.AndroidJUnitRunner\"\n           }\n       }\n   }\n   ```\n9. **Update Compose tooling dependency**:\n   ```kotlin\n   \u002F\u002F Old: \n   debugImplementation(libs.androidx.compose.ui.tooling)\n   \u002F\u002F New:\n   androidRuntimeClasspath(libs.androidx.compose.ui.tooling)\n   ```\n10. **Publish consumer ProGuard rules** explicitly if applicable:\n    ```kotlin\n    kotlin {\n        android {\n            consumerProguardFiles.add(file(\"consumer-rules.pro\"))\n        }\n    }\n    ```\n11. **Resolve Sub-dependency Variants (Product Flavors \u002F Build Types)**:\n    Because the new KMP Android library plugin enforces a single-variant architecture, it does not natively understand how to resolve dependencies that publish multiple variants (like `debug`\u002F`release` build types, or product flavors like `free`\u002F`paid`). Configure fallback behaviors using `localDependencySelection`:\n    ```kotlin\n    kotlin {\n        android {\n            localDependencySelection {\n                \u002F\u002F Determine which build type to consume from Android library dependencies, in order of preference\n                selectBuildTypeFrom.set(listOf(\"debug\", \"release\"))\n                \n                \u002F\u002F If the dependency has a 'tier' dimension, select the 'free' flavor\n                productFlavorDimension(\"tier\") {\n                    selectFrom.set(listOf(\"free\"))\n                }\n            }\n        }\n    }\n    ```\n\n## Path B: Android App + Shared Module Split\n\nUse this when a module applies `kotlin.multiplatform` + `com.android.application`. This is **mandatory** for AGP 9.0 compatibility.\n\nSee references\u002FMIGRATION_APP_SPLIT.md (`references\u002FMIGRATION_APP_SPLIT.md`) for full guide.\n\nSummary:\n\n1. **Create `androidApp` module** with its own `build.gradle.kts`:\n   ```kotlin\n   plugins {\n       alias(libs.plugins.androidApplication)\n       \u002F\u002F Do NOT apply kotlin-android — AGP 9.0 includes Kotlin support\n       alias(libs.plugins.composeMultiplatform)  \u002F\u002F if using Compose\n       alias(libs.plugins.composeCompiler)       \u002F\u002F if using Compose\n   }\n\n   android {\n       namespace = \"com.example.app\"\n       compileSdk = 35\n       defaultConfig {\n           applicationId = \"com.example.app\"\n           minSdk = 24\n           targetSdk = 35\n           versionCode = 1\n           versionName = \"1.0\"\n       }\n       buildFeatures { compose = true }\n   }\n\n   dependencies {\n       implementation(projects.shared)  \u002F\u002F or whatever the shared module is named\n       implementation(libs.androidx.activity.compose)\n   }\n   ```\n2. **Move Android entry point code** from `src\u002FandroidMain\u002F` to `androidApp\u002Fsrc\u002Fmain\u002F`:\n   - `MainActivity.kt` (and any other Activities\u002FFragments)\n   - `AndroidManifest.xml` (app-level manifest with `\u003Capplication>` and launcher `\u003Cactivity>`) — verify `android:name` on `\u003Cactivity>` uses the fully qualified class name in its new location\n   - Android Application class if present\n   - App-level resources (launcher icons, theme, etc.)\n3. **Add to `settings.gradle.kts`**: `include(\":androidApp\")`\n4. **Add to root `build.gradle.kts`**: plugin declarations with `apply false`\n5. **Convert original module** from application to library using Path A steps\n6. **Ensure different namespaces**: app module and library module must have distinct namespaces\n7. **Remove from shared module**: `applicationId`, `targetSdk`, `versionCode`, `versionName`\n8. **Update IDE run configurations**: change the module from the old module to `androidApp`\n\n## Path C: Full Restructure (Recommended)\n\nUse this when the project has a monolithic module (typically `composeApp`) containing entry\npoints for multiple platforms. This is optional but aligns with the new JetBrains default.\n\nSee references\u002FMIGRATION_FULL_RESTRUCTURE.md (`references\u002FMIGRATION_FULL_RESTRUCTURE.md`) for full guide.\n\n### Target Structure\n\n```\nproject\u002F\n├── shared\u002F              ← KMP library (was composeApp), pure shared code\n├── androidApp\u002F          ← Android entry point only\n├── desktopApp\u002F          ← Desktop entry point only (if desktop target exists)\n├── webApp\u002F              ← Wasm\u002FJS entry point only (if web target exists)\n├── iosApp\u002F              ← iOS Xcode project (usually already separate)\n└── ...\n```\n\n### Steps\n\n1. **Apply Path B first** — extract `androidApp` (mandatory for AGP 9.0)\n2. **Extract `desktopApp`** (if desktop target exists):\n   - Create module with `org.jetbrains.compose` and `application {}` plugin\n   - Move `main()` function from `desktopMain` to `desktopApp\u002Fsrc\u002Fmain\u002Fkotlin\u002F`\n   - Move `compose.desktop { application { ... } }` config to `desktopApp\u002Fbuild.gradle.kts`\n   - Add dependency on `shared` module\n3. **Extract `webApp`** (if wasmJs\u002Fjs target exists):\n   - Create module with appropriate Kotlin\u002FJS or Kotlin\u002FWasm configuration\n   - Move web entry point from `wasmJsMain`\u002F`jsMain` to `webApp\u002Fsrc\u002FwasmJsMain\u002Fkotlin\u002F`\n   - Move browser\u002Fdistribution config to `webApp\u002Fbuild.gradle.kts`\n   - Add dependency on `shared` module\n4. **iOS** — typically already in a separate `iosApp` directory. Verify:\n   - Framework export config (`binaries.framework`) stays in `shared` module\n   - Xcode project references the correct framework path\n5. **Rename module** from `composeApp` to `shared`:\n   - Rename directory\n   - Update `settings.gradle.kts` include\n   - Update all dependency references across modules\n6. **Clean up shared module**: remove all platform entry point code and app-specific config\n   that was moved to the platform app modules\n\n### Variant: Native UI\n\nIf some platforms use native UI (e.g., SwiftUI for iOS), split `shared` into:\n- `sharedLogic` — business logic consumed by ALL platforms\n- `sharedUI` — Compose Multiplatform UI consumed only by platforms using shared UI\n\n### Variant: Server\n\nIf the project includes a server target:\n- Add `server` module at the root\n- Move all client modules under an `app\u002F` directory\n- Add `core` module for code shared between server and client (models, validation)\n\n## Version Updates\n\nThese are required regardless of migration path:\n\n1. **Gradle wrapper** — update to 9.1.0+:\n   ```properties\n   # gradle\u002Fwrapper\u002Fgradle-wrapper.properties\n   distributionUrl=https\\:\u002F\u002Fservices.gradle.org\u002Fdistributions\u002Fgradle-9.1.0-bin.zip\n   ```\n2. **AGP version** — update to 9.0.0+ and add the KMP library plugin.\n\n   With version catalog (`gradle\u002Flibs.versions.toml`):\n   ```toml\n   [versions]\n   agp = \"9.0.1\"\n\n   [plugins]\n   android-kotlin-multiplatform-library = { id = \"com.android.kotlin.multiplatform.library\", version.ref = \"agp\" }\n   ```\n\n   Without version catalog — update `com.android.*` plugin versions and add in root `build.gradle.kts`:\n   ```kotlin\n   plugins {\n       id(\"com.android.application\") version \"9.0.1\" apply false\n       id(\"com.android.kotlin.multiplatform.library\") version \"9.0.1\" apply false\n   }\n   ```\n3. **JDK** — ensure JDK 17+ is used (required by AGP 9.0)\n4. **SDK Build Tools** — update to 36.0.0:\n   ```\n   Install via SDK Manager or configure in android { buildToolsVersion = \"36.0.0\" }\n   ```\n5. **Review gradle.properties** — remove error-causing properties and review changed defaults (see \"Gradle Properties Default Changes\" section)\n\n## Built-in Kotlin Migration\n\nAGP 9.0 enables built-in Kotlin support by default for all `com.android.application` and `com.android.library`\nmodules. The `org.jetbrains.kotlin.android` plugin is no longer needed and will conflict if applied.\n\n**Important:** Built-in Kotlin does NOT replace KMP support. KMP library modules still need\n`org.jetbrains.kotlin.multiplatform` + `com.android.kotlin.multiplatform.library`.\n\n### Step 1: Remove kotlin-android Plugin\n\nRemove from **all** module-level and root-level build files:\n\n```kotlin\n\u002F\u002F Remove from module build.gradle.kts\nplugins {\n    \u002F\u002F REMOVE: alias(libs.plugins.kotlin.android)\n    \u002F\u002F REMOVE: id(\"org.jetbrains.kotlin.android\")\n}\n\n\u002F\u002F Remove from root build.gradle.kts\nplugins {\n    \u002F\u002F REMOVE: alias(libs.plugins.kotlin.android) apply false\n}\n```\n\nRemove from version catalog (`gradle\u002Flibs.versions.toml`):\n```toml\n[plugins]\n# REMOVE: kotlin-android = { id = \"org.jetbrains.kotlin.android\", version.ref = \"kotlin\" }\n```\n\n### Step 2: Migrate kapt to KSP or legacy-kapt\n\nThe `org.jetbrains.kotlin.kapt` plugin is **incompatible** with built-in Kotlin.\n\n**Preferred: Migrate to KSP** — see the KSP migration guide for each annotation processor.\n\n**Fallback: Use `com.android.legacy-kapt`** (same version as AGP):\n```toml\n# gradle\u002Flibs.versions.toml\n[plugins]\nlegacy-kapt = { id = \"com.android.legacy-kapt\", version.ref = \"agp\" }\n```\n```kotlin\n\u002F\u002F Module build.gradle.kts — replace kotlin-kapt with legacy-kapt\nplugins {\n    \u002F\u002F REMOVE: alias(libs.plugins.kotlin.kapt)\n    alias(libs.plugins.legacy.kapt)\n}\n```\n\n### Step 3: Migrate kotlinOptions to compilerOptions\n\nFor pure Android modules (non-KMP), migrate `android.kotlinOptions {}` to the top-level\n`kotlin.compilerOptions {}`:\n```kotlin\n\u002F\u002F Old\nandroid {\n    kotlinOptions {\n        jvmTarget = \"11\"\n        languageVersion = \"2.0\"\n        freeCompilerArgs += listOf(\"-Xopt-in=kotlin.RequiresOptIn\")\n    }\n}\n\n\u002F\u002F New\nkotlin {\n    compilerOptions {\n        jvmTarget.set(org.jetbrains.kotlin.gradle.dsl.JvmTarget.JVM_11)\n        languageVersion.set(org.jetbrains.kotlin.gradle.dsl.KotlinVersion.KOTLIN_2_0)\n        optIn.add(\"kotlin.RequiresOptIn\")\n    }\n}\n```\n\n**Note:** With built-in Kotlin, `jvmTarget` defaults to `android.compileOptions.targetCompatibility`, so it may be optional if you already set `compileOptions`.\n\n### Step 4: Migrate kotlin.sourceSets to android.sourceSets\n\nWith built-in Kotlin, only `android.sourceSets {}` with the `kotlin` set is supported:\n```kotlin\n\u002F\u002F NOT SUPPORTED with built-in Kotlin:\nkotlin.sourceSets.named(\"main\") {\n    kotlin.srcDir(\"additionalSourceDirectory\u002Fkotlin\")\n}\n\n\u002F\u002F Correct:\nandroid.sourceSets.named(\"main\") {\n    kotlin.directories += \"additionalSourceDirectory\u002Fkotlin\"\n}\n```\n\nFor generated sources, use the Variant API:\n```kotlin\nandroidComponents.onVariants { variant ->\n    variant.sources.kotlin!!.addStaticSourceDirectory(\"additionalSourceDirectory\u002Fkotlin\")\n}\n```\n\n### Per-Module Migration Strategy\n\nFor large projects, migrate module-by-module:\n\n1. Disable globally: `android.builtInKotlin=false` in `gradle.properties`\n2. Enable per migrated module by applying the opt-in plugin:\n   ```kotlin\n   plugins {\n       id(\"com.android.built-in-kotlin\") version \"AGP_VERSION\"\n   }\n   ```\n3. Follow Steps 1-4 for that module\n4. Once all modules are migrated, remove `android.builtInKotlin=false` and all `com.android.built-in-kotlin` plugins\n\n### Optional: Disable Kotlin for Non-Kotlin Modules\n\nFor modules that contain **no Kotlin sources**, disable built-in Kotlin to save build time:\n```kotlin\nandroid {\n    enableKotlin = false\n}\n```\n\n### Opt-Out (Temporary)\n\nIf blocked by plugin incompatibilities, opt out temporarily:\n```properties\n# gradle.properties\nandroid.builtInKotlin=false\nandroid.newDsl=false  # also required if using new DSL opt-out\n```\n\n**Warning:** Ask the user if they want to opt out, and if so, remind them this is a temporary measure.\n\n## Plugin Compatibility\n\nSee references\u002FPLUGIN_COMPATIBILITY.md (`references\u002FPLUGIN_COMPATIBILITY.md`) for the full compatibility table with known compatible versions, opt-out flag workarounds, and broken plugins.\n\n**Before migrating**, inventory all plugins in the project and check each against that table. If any plugin is broken without workaround, inform the user. If plugins need opt-out flags, add them to`gradle.properties` and note them as temporary workarounds.\n\n## Gradle Properties Default Changes\n\nAGP 9.0 changes the defaults for many Gradle properties. Check `gradle.properties` for any explicitly set values that may now conflict. \nKey changes:\n\n| Property                                             | Old Default | New Default | Action                                            |\n|------------------------------------------------------|-------------|-------------|---------------------------------------------------|\n| `android.uniquePackageNames`                         | `false`     | `true`      | Ensure each library has a unique namespace        |\n| `android.enableAppCompileTimeRClass`                 | `false`     | `true`      | Refactor `switch` on R fields to `if\u002Felse`        |\n| `android.defaults.buildfeatures.resvalues`           | `true`      | `false`     | Enable `resValues = true` where needed            |\n| `android.defaults.buildfeatures.shaders`             | `true`      | `false`     | Enable shaders where needed                       |\n| `android.r8.optimizedResourceShrinking`              | `false`     | `true`      | Review R8 keep rules                              |\n| `android.r8.strictFullModeForKeepRules`              | `false`     | `true`      | Update keep rules to be explicit                  |\n| `android.proguard.failOnMissingFiles`                | `false`     | `true`      | Remove invalid ProGuard file references           |\n| `android.r8.proguardAndroidTxt.disallowed`           | `false`     | `true`      | Use `proguard-android-optimize.txt` only          |\n| `android.r8.globalOptionsInConsumerRules.disallowed` | `false`     | `true`      | Remove global options from library consumer rules |\n| `android.sourceset.disallowProvider`                 | `false`     | `true`      | Use `Sources` API on androidComponents            |\n| `android.sdk.defaultTargetSdkToCompileSdkIfUnset`    | `false`     | `true`      | Specify `targetSdk` explicitly                    |\n| `android.onlyEnableUnitTestForTheTestedBuildType`    | `false`     | `true`      | Only if testing non-default build types           |\n\nCheck for and remove properties that now cause errors:\n- `android.r8.integratedResourceShrinking` — removed, always on\n- `android.enableNewResourceShrinker.preciseShrinking` — removed, always on\n\n## Pure Android Tips\n\nFor non-KMP Android modules upgrading to AGP 9.0, follow the \"Built-in Kotlin Migration\" steps above,\nthen review the \"Gradle Properties Default Changes\" table. Additional changes:\n\n- **Review new DSL interfaces** — `BaseExtension` is removed; use `CommonExtension` or specific extension types\n- **Java default changed** from Java 8 to Java 11 — ensure `compileOptions` reflects this\n\n## Verification\n\nAfter migration, verify with the checklist (`assets\u002Fchecklist.md`). Key checks:\n\n1. `.\u002Fgradlew build` succeeds with no errors\n2. All platform targets build successfully (Android, iOS via `xcodebuild`, Desktop, JS\u002FWasm)\n3. `.\u002Fgradlew :shared:allTests` and Android unit tests pass\n4. No `com.android.library` or `com.android.application` in KMP modules\n5. No `org.jetbrains.kotlin.android` in AGP 9.0 modules\n6. Source sets use correct names (`androidMain`, `androidHostTest`, `androidDeviceTest`)\n7. No deprecation warnings about variant API or DSL\n\n## Common Issues\n\nSee references\u002FKNOWN_ISSUES.md (`references\u002FKNOWN_ISSUES.md`) for details. Key gotchas:\n\n### KMP Library Plugin Issues\n- **BuildConfig unavailable** in library modules — use DI\u002F`AppConfiguration` interface, or use [BuildKonfig](https:\u002F\u002Fgithub.com\u002Fyshrsmz\u002FBuildKonfig) or [gradle-buildconfig-plugin](https:\u002F\u002Fgithub.com\u002Fgmazzo\u002Fgradle-buildconfig-plugin) for compile-time constants\n- **No build variants** — single variant architecture; compile-time constants can use BuildKonfig\u002Fgradle-buildconfig-plugin flavors, but variant-specific dependencies\u002Fresources\u002Fsigning must move to app module\n- **NDK\u002FJNI unsupported** in new plugin — extract to separate `com.android.library` module\n- **Compose resources crash** without `androidResources { enable = true }`\n- **Consumer ProGuard rules silently dropped** if not migrated to `consumerProguardFiles.add(file(...))` in new DSL\n- **KSP** requires version 2.3.1+ for AGP 9.0 compatibility\n\n### AGP 9.0 General Issues\n- **BaseExtension removed** — convention plugins using old DSL types need rewriting to use `CommonExtension`\n- **Variant APIs removed** — `applicationVariants`, `libraryVariants`, `variantFilter` replaced by `androidComponents`\n- **Convention plugins** need refactoring — old `android {}` extension helpers are obsolete\n\n## Reference Files\n\n- DSL Reference (`references\u002FDSL_REFERENCE.md`) — side-by-side old→new DSL mapping\n- Version Matrix (`references\u002FVERSION_MATRIX.md`) — AGP\u002FGradle\u002FKGP\u002FCompose\u002FIDE compatibility\n- Plugin Compatibility (`references\u002FPLUGIN_COMPATIBILITY.md`) — third-party plugin status and workarounds\n","# KMP AGP 9.0 Migration\n\nAndroid Gradle Plugin 9.0 makes the Android application and library plugins incompatible\nwith the Kotlin Multiplatform plugin in the same module. This skill guides you through the\nmigration.\n\n## Step 0: Analyze the Project\n\nBefore making any changes, understand the project structure:\n1. Read `settings.gradle.kts` (or `.gradle`) to find all modules\n2. For each module, read its `build.gradle.kts` to identify which plugins are applied\n3. Check if the project uses a Gradle version catalog (`gradle\u002Flibs.versions.toml`). If it exists,\n   read it for current AGP\u002FGradle\u002FKotlin versions. If not, find versions directly in `build.gradle.kts`\n   files (typically in the root `buildscript {}` or `plugins {}` block). **Adapt all examples in this\n   guide accordingly** — version catalog examples use `alias(libs.plugins.xxx)` while direct usage\n   uses `id(\"plugin.id\") version \"x.y.z\"`\n4. Read `gradle\u002Fwrapper\u002Fgradle-wrapper.properties` for the Gradle version\n5. Check `gradle.properties` for any existing workarounds (`android.enableLegacyVariantApi`)\n6. Check for `org.jetbrains.kotlin.android` plugin usage — AGP 9.0 has built-in Kotlin and this plugin must be removed\n7. Check for `org.jetbrains.kotlin.kapt` plugin usage — incompatible with built-in Kotlin, must migrate to KSP or `com.android.legacy-kapt`\n8. Check for third-party plugins that may be incompatible with AGP 9.0 (see \"Plugin Compatibility\" section below)\n\nIf Bash is available, run `scripts\u002Fanalyze-project.sh` from this skill's directory to get a structured summary.\n\n### Classify Each Module\n\nFor each module, determine its type:\n\n| Current plugins                                                          | Migration path                              |\n|--------------------------------------------------------------------------|---------------------------------------------|\n| `kotlin.multiplatform` + `com.android.library`                           | **Path A** — Library plugin swap            |\n| `kotlin.multiplatform` + `com.android.application`                       | **Path B** — Mandatory Android split        |\n| `kotlin.multiplatform` with multiple platform entry points in one module | **Path C** — Full restructure (recommended) |\n| `com.android.application` or `com.android.library` (no KMP)              | See \"Pure Android Tips\" below               |\n\n### Determine Scope\n\n- **Path B is mandatory** for any module combining KMP + Android application plugin\n- **Path C is recommended** when the project has a monolithic `composeApp` (or similar) module\n  containing entry points for multiple platforms (Android, Desktop, Web). This aligns with the\n  new JetBrains default project structure where each platform gets its own app module.\n- **Ask the user** whether they want Path B only (minimum required) or Path C (recommended full restructure)\n\n## Path A: Library Module Migration\n\nUse this when a module applies `kotlin.multiplatform` + `com.android.library`.\n\nSee references\u002FMIGRATION_LIBRARY.md (`references\u002FMIGRATION_LIBRARY.md`) for full before\u002Fafter code.\n\nSummary:\n\n1. **Replace plugin**: `com.android.library` → `com.android.kotlin.multiplatform.library`\n2. **Remove `org.jetbrains.kotlin.android`** plugin if present (AGP 9.0 has built-in Kotlin support)\n3. **Migrate DSL**: Move config from top-level `android {}` block into `kotlin { android {} }`:\n   ```kotlin\n   kotlin {\n       android {\n           namespace = \"com.example.lib\"\n           compileSdk = 35\n           minSdk = 24\n       }\n   }\n   ```\n4. **Rename source directories** (only if the module uses classic Android layout instead of KMP layout):\n   - `src\u002Fmain` → `src\u002FandroidMain`\n   - `src\u002Ftest` → `src\u002FandroidHostTest`\n   - `src\u002FandroidTest` → `src\u002FandroidDeviceTest`\n   - If the module already uses `src\u002FandroidMain\u002F`, no directory renames are needed\n5. **Move dependencies** from top-level `dependencies {}` into `sourceSets`:\n   ```kotlin\n   kotlin {\n       sourceSets {\n           androidMain.dependencies {\n               implementation(\"androidx.appcompat:appcompat:1.7.0\")\n           }\n       }\n   }\n   ```\n6. **Enable resources** explicitly if the module uses Android or Compose Multiplatform resources:\n   ```kotlin\n   kotlin {\n       android {\n           androidResources { enable = true }\n       }\n   }\n   ```\n7. **Enable Java** compilation if module has `.java` source files:\n   ```kotlin\n   kotlin {\n       android {\n           withJava()\n       }\n   }\n   ```\n8. **Enable tests** explicitly if the module has unit or instrumented tests:\n   ```kotlin\n   kotlin {\n       android {\n           withHostTest { isIncludeAndroidResources = true }\n           withDeviceTest {\n               instrumentationRunner = \"androidx.test.runner.AndroidJUnitRunner\"\n           }\n       }\n   }\n   ```\n9. **Update Compose tooling dependency**:\n   ```kotlin\n   \u002F\u002F Old: \n   debugImplementation(libs.androidx.compose.ui.tooling)\n   \u002F\u002F New:\n   androidRuntimeClasspath(libs.androidx.compose.ui.tooling)\n   ```\n10. **Publish consumer ProGuard rules** explicitly if applicable:\n    ```kotlin\n    kotlin {\n        android {\n            consumerProguardFiles.add(file(\"consumer-rules.pro\"))\n        }\n    }\n    ```\n11. **Resolve Sub-dependency Variants (Product Flavors \u002F Build Types)**:\n    Because the new KMP Android library plugin enforces a single-variant architecture, it does not natively understand how to resolve dependencies that publish multiple variants (like `debug`\u002F`release` build types, or product flavors like `free`\u002F`paid`). Configure fallback behaviors using `localDependencySelection`:\n    ```kotlin\n    kotlin {\n        android {\n            localDependencySelection {\n                \u002F\u002F Determine which build type to consume from Android library dependencies, in order of preference\n                selectBuildTypeFrom.set(listOf(\"debug\", \"release\"))\n                \n                \u002F\u002F If the dependency has a 'tier' dimension, select the 'free' flavor\n                productFlavorDimension(\"tier\") {\n                    selectFrom.set(listOf(\"free\"))\n                }\n            }\n        }\n    }\n    ```\n\n## Path B: Android App + Shared Module Split\n\nUse this when a module applies `kotlin.multiplatform` + `com.android.application`. This is **mandatory** for AGP 9.0 compatibility.\n\nSee references\u002FMIGRATION_APP_SPLIT.md (`references\u002FMIGRATION_APP_SPLIT.md`) for full guide.\n\nSummary:\n\n1. **Create `androidApp` module** with its own `build.gradle.kts`:\n   ```kotlin\n   plugins {\n       alias(libs.plugins.androidApplication)\n       \u002F\u002F Do NOT apply kotlin-android — AGP 9.0 includes Kotlin support\n       alias(libs.plugins.composeMultiplatform)  \u002F\u002F if using Compose\n       alias(libs.plugins.composeCompiler)       \u002F\u002F if using Compose\n   }\n\n   android {\n       namespace = \"com.example.app\"\n       compileSdk = 35\n       defaultConfig {\n           applicationId = \"com.example.app\"\n           minSdk = 24\n           targetSdk = 35\n           versionCode = 1\n           versionName = \"1.0\"\n       }\n       buildFeatures { compose = true }\n   }\n\n   dependencies {\n       implementation(projects.shared)  \u002F\u002F or whatever the shared module is named\n       implementation(libs.androidx.activity.compose)\n   }\n   ```\n2. **Move Android entry point code** from `src\u002FandroidMain\u002F` to `androidApp\u002Fsrc\u002Fmain\u002F`:\n   - `MainActivity.kt` (and any other Activities\u002FFragments)\n   - `AndroidManifest.xml` (app-level manifest with `\u003Capplication>` and launcher `\u003Cactivity>`) — verify `android:name` on `\u003Cactivity>` uses the fully qualified class name in its new location\n   - Android Application class if present\n   - App-level resources (launcher icons, theme, etc.)\n3. **Add to `settings.gradle.kts`**: `include(\":androidApp\")`\n4. **Add to root `build.gradle.kts`**: plugin declarations with `apply false`\n5. **Convert original module** from application to library using Path A steps\n6. **Ensure different namespaces**: app module and library module must have distinct namespaces\n7. **Remove from shared module**: `applicationId`, `targetSdk`, `versionCode`, `versionName`\n8. **Update IDE run configurations**: change the module from the old module to `androidApp`\n\n## Path C: Full Restructure (Recommended)\n\nUse this when the project has a monolithic module (typically `composeApp`) containing entry\npoints for multiple platforms. This is optional but aligns with the new JetBrains default.\n\nSee references\u002FMIGRATION_FULL_RESTRUCTURE.md (`references\u002FMIGRATION_FULL_RESTRUCTURE.md`) for full guide.\n\n### Target Structure\n\n```\nproject\u002F\n├── shared\u002F              ← KMP library (was composeApp), pure shared code\n├── androidApp\u002F          ← Android entry point only\n├── desktopApp\u002F          ← Desktop entry point only (if desktop target exists)\n├── webApp\u002F              ← Wasm\u002FJS entry point only (if web target exists)\n├── iosApp\u002F              ← iOS Xcode project (usually already separate)\n└── ...\n```\n\n### Steps\n\n1. **Apply Path B first** — extract `androidApp` (mandatory for AGP 9.0)\n2. **Extract `desktopApp`** (if desktop target exists):\n   - Create module with `org.jetbrains.compose` and `application {}` plugin\n   - Move `main()` function from `desktopMain` to `desktopApp\u002Fsrc\u002Fmain\u002Fkotlin\u002F`\n   - Move `compose.desktop { application { ... } }` config to `desktopApp\u002Fbuild.gradle.kts`\n   - Add dependency on `shared` module\n3. **Extract `webApp`** (if wasmJs\u002Fjs target exists):\n   - Create module with appropriate Kotlin\u002FJS or Kotlin\u002FWasm configuration\n   - Move web entry point from `wasmJsMain`\u002F`jsMain` to `webApp\u002Fsrc\u002FwasmJsMain\u002Fkotlin\u002F`\n   - Move browser\u002Fdistribution config to `webApp\u002Fbuild.gradle.kts`\n   - Add dependency on `shared` module\n4. **iOS** — typically already in a separate `iosApp` directory. Verify:\n   - Framework export config (`binaries.framework`) stays in `shared` module\n   - Xcode project references the correct framework path\n5. **Rename module** from `composeApp` to `shared`:\n   - Rename directory\n   - Update `settings.gradle.kts` include\n   - Update all dependency references across modules\n6. **Clean up shared module**: remove all platform entry point code and app-specific config\n   that was moved to the platform app modules\n\n### Variant: Native UI\n\nIf some platforms use native UI (e.g., SwiftUI for iOS), split `shared` into:\n- `sharedLogic` — business logic consumed by ALL platforms\n- `sharedUI` — Compose Multiplatform UI consumed only by platforms using shared UI\n\n### Variant: Server\n\nIf the project includes a server target:\n- Add `server` module at the root\n- Move all client modules under an `app\u002F` directory\n- Add `core` module for code shared between server and client (models, validation)\n\n## Version Updates\n\nThese are required regardless of migration path:\n\n1. **Gradle wrapper** — update to 9.1.0+:\n   ```properties\n   # gradle\u002Fwrapper\u002Fgradle-wrapper.properties\n   distributionUrl=https\\:\u002F\u002Fservices.gradle.org\u002Fdistributions\u002Fgradle-9.1.0-bin.zip\n   ```\n2. **AGP version** — update to 9.0.0+ and add the KMP library plugin.\n\n   With version catalog (`gradle\u002Flibs.versions.toml`):\n   ```toml\n   [versions]\n   agp = \"9.0.1\"\n\n   [plugins]\n   android-kotlin-multiplatform-library = { id = \"com.android.kotlin.multiplatform.library\", version.ref = \"agp\" }\n   ```\n\n   Without version catalog — update `com.android.*` plugin versions and add in root `build.gradle.kts`:\n   ```kotlin\n   plugins {\n       id(\"com.android.application\") version \"9.0.1\" apply false\n       id(\"com.android.kotlin.multiplatform.library\") version \"9.0.1\" apply false\n   }\n   ```\n3. **JDK** — ensure JDK 17+ is used (required by AGP 9.0)\n4. **SDK Build Tools** — update to 36.0.0:\n   ```\n   Install via SDK Manager or configure in android { buildToolsVersion = \"36.0.0\" }\n   ```\n5. **Review gradle.properties** — remove error-causing properties and review changed defaults (see \"Gradle Properties Default Changes\" section)\n\n## Built-in Kotlin Migration\n\nAGP 9.0 enables built-in Kotlin support by default for all `com.android.application` and `com.android.library`\nmodules. The `org.jetbrains.kotlin.android` plugin is no longer needed and will conflict if applied.\n\n**Important:** Built-in Kotlin does NOT replace KMP support. KMP library modules still need\n`org.jetbrains.kotlin.multiplatform` + `com.android.kotlin.multiplatform.library`.\n\n### Step 1: Remove kotlin-android Plugin\n\nRemove from **all** module-level and root-level build files:\n\n```kotlin\n\u002F\u002F Remove from module build.gradle.kts\nplugins {\n    \u002F\u002F REMOVE: alias(libs.plugins.kotlin.android)\n    \u002F\u002F REMOVE: id(\"org.jetbrains.kotlin.android\")\n}\n\n\u002F\u002F Remove from root build.gradle.kts\nplugins {\n    \u002F\u002F REMOVE: alias(libs.plugins.kotlin.android) apply false\n}\n```\n\nRemove from version catalog (`gradle\u002Flibs.versions.toml`):\n```toml\n[plugins]\n# REMOVE: kotlin-android = { id = \"org.jetbrains.kotlin.android\", version.ref = \"kotlin\" }\n```\n\n### Step 2: Migrate kapt to KSP or legacy-kapt\n\nThe `org.jetbrains.kotlin.kapt` plugin is **incompatible** with built-in Kotlin.\n\n**Preferred: Migrate to KSP** — see the KSP migration guide for each annotation processor.\n\n**Fallback: Use `com.android.legacy-kapt`** (same version as AGP):\n```toml\n# gradle\u002Flibs.versions.toml\n[plugins]\nlegacy-kapt = { id = \"com.android.legacy-kapt\", version.ref = \"agp\" }\n```\n```kotlin\n\u002F\u002F Module build.gradle.kts — replace kotlin-kapt with legacy-kapt\nplugins {\n    \u002F\u002F REMOVE: alias(libs.plugins.kotlin.kapt)\n    alias(libs.plugins.legacy.kapt)\n}\n```\n\n### Step 3: Migrate kotlinOptions to compilerOptions\n\nFor pure Android modules (non-KMP), migrate `android.kotlinOptions {}` to the top-level\n`kotlin.compilerOptions {}`:\n```kotlin\n\u002F\u002F Old\nandroid {\n    kotlinOptions {\n        jvmTarget = \"11\"\n        languageVersion = \"2.0\"\n        freeCompilerArgs += listOf(\"-Xopt-in=kotlin.RequiresOptIn\")\n    }\n}\n\n\u002F\u002F New\nkotlin {\n    compilerOptions {\n        jvmTarget.set(org.jetbrains.kotlin.gradle.dsl.JvmTarget.JVM_11)\n        languageVersion.set(org.jetbrains.kotlin.gradle.dsl.KotlinVersion.KOTLIN_2_0)\n        optIn.add(\"kotlin.RequiresOptIn\")\n    }\n}\n```\n\n**Note:** With built-in Kotlin, `jvmTarget` defaults to `android.compileOptions.targetCompatibility`, so it may be optional if you already set `compileOptions`.\n\n### Step 4: Migrate kotlin.sourceSets to android.sourceSets\n\nWith built-in Kotlin, only `android.sourceSets {}` with the `kotlin` set is supported:\n```kotlin\n\u002F\u002F NOT SUPPORTED with built-in Kotlin:\nkotlin.sourceSets.named(\"main\") {\n    kotlin.srcDir(\"additionalSourceDirectory\u002Fkotlin\")\n}\n\n\u002F\u002F Correct:\nandroid.sourceSets.named(\"main\") {\n    kotlin.directories += \"additionalSourceDirectory\u002Fkotlin\"\n}\n```\n\nFor generated sources, use the Variant API:\n```kotlin\nandroidComponents.onVariants { variant ->\n    variant.sources.kotlin!!.addStaticSourceDirectory(\"additionalSourceDirectory\u002Fkotlin\")\n}\n```\n\n### Per-Module Migration Strategy\n\nFor large projects, migrate module-by-module:\n\n1. Disable globally: `android.builtInKotlin=false` in `gradle.properties`\n2. Enable per migrated module by applying the opt-in plugin:\n   ```kotlin\n   plugins {\n       id(\"com.android.built-in-kotlin\") version \"AGP_VERSION\"\n   }\n   ```\n3. Follow Steps 1-4 for that module\n4. Once all modules are migrated, remove `android.builtInKotlin=false` and all `com.android.built-in-kotlin` plugins\n\n### Optional: Disable Kotlin for Non-Kotlin Modules\n\nFor modules that contain **no Kotlin sources**, disable built-in Kotlin to save build time:\n```kotlin\nandroid {\n    enableKotlin = false\n}\n```\n\n### Opt-Out (Temporary)\n\nIf blocked by plugin incompatibilities, opt out temporarily:\n```properties\n# gradle.properties\nandroid.builtInKotlin=false\nandroid.newDsl=false  # also required if using new DSL opt-out\n```\n\n**Warning:** Ask the user if they want to opt out, and if so, remind them this is a temporary measure.\n\n## Plugin Compatibility\n\nSee references\u002FPLUGIN_COMPATIBILITY.md (`references\u002FPLUGIN_COMPATIBILITY.md`) for the full compatibility table with known compatible versions, opt-out flag workarounds, and broken plugins.\n\n**Before migrating**, inventory all plugins in the project and check each against that table. If any plugin is broken without workaround, inform the user. If plugins need opt-out flags, add them to`gradle.properties` and note them as temporary workarounds.\n\n## Gradle Properties Default Changes\n\nAGP 9.0 changes the defaults for many Gradle properties. Check `gradle.properties` for any explicitly set values that may now conflict. \nKey changes:\n\n| Property                                             | Old Default | New Default | Action                                            |\n|------------------------------------------------------|-------------|-------------|---------------------------------------------------|\n| `android.uniquePackageNames`                         | `false`     | `true`      | Ensure each library has a unique namespace        |\n| `android.enableAppCompileTimeRClass`                 | `false`     | `true`      | Refactor `switch` on R fields to `if\u002Felse`        |\n| `android.defaults.buildfeatures.resvalues`           | `true`      | `false`     | Enable `resValues = true` where needed            |\n| `android.defaults.buildfeatures.shaders`             | `true`      | `false`     | Enable shaders where needed                       |\n| `android.r8.optimizedResourceShrinking`              | `false`     | `true`      | Review R8 keep rules                              |\n| `android.r8.strictFullModeForKeepRules`              | `false`     | `true`      | Update keep rules to be explicit                  |\n| `android.proguard.failOnMissingFiles`                | `false`     | `true`      | Remove invalid ProGuard file references           |\n| `android.r8.proguardAndroidTxt.disallowed`           | `false`     | `true`      | Use `proguard-android-optimize.txt` only          |\n| `android.r8.globalOptionsInConsumerRules.disallowed` | `false`     | `true`      | Remove global options from library consumer rules |\n| `android.sourceset.disallowProvider`                 | `false`     | `true`      | Use `Sources` API on androidComponents            |\n| `android.sdk.defaultTargetSdkToCompileSdkIfUnset`    | `false`     | `true`      | Specify `targetSdk` explicitly                    |\n| `android.onlyEnableUnitTestForTheTestedBuildType`    | `false`     | `true`      | Only if testing non-default build types           |\n\nCheck for and remove properties that now cause errors:\n- `android.r8.integratedResourceShrinking` — removed, always on\n- `android.enableNewResourceShrinker.preciseShrinking` — removed, always on\n\n## Pure Android Tips\n\nFor non-KMP Android modules upgrading to AGP 9.0, follow the \"Built-in Kotlin Migration\" steps above,\nthen review the \"Gradle Properties Default Changes\" table. Additional changes:\n\n- **Review new DSL interfaces** — `BaseExtension` is removed; use `CommonExtension` or specific extension types\n- **Java default changed** from Java 8 to Java 11 — ensure `compileOptions` reflects this\n\n## Verification\n\nAfter migration, verify with the checklist (`assets\u002Fchecklist.md`). Key checks:\n\n1. `.\u002Fgradlew build` succeeds with no errors\n2. All platform targets build successfully (Android, iOS via `xcodebuild`, Desktop, JS\u002FWasm)\n3. `.\u002Fgradlew :shared:allTests` and Android unit tests pass\n4. No `com.android.library` or `com.android.application` in KMP modules\n5. No `org.jetbrains.kotlin.android` in AGP 9.0 modules\n6. Source sets use correct names (`androidMain`, `androidHostTest`, `androidDeviceTest`)\n7. No deprecation warnings about variant API or DSL\n\n## Common Issues\n\nSee references\u002FKNOWN_ISSUES.md (`references\u002FKNOWN_ISSUES.md`) for details. Key gotchas:\n\n### KMP Library Plugin Issues\n- **BuildConfig unavailable** in library modules — use DI\u002F`AppConfiguration` interface, or use [BuildKonfig](https:\u002F\u002Fgithub.com\u002Fyshrsmz\u002FBuildKonfig) or [gradle-buildconfig-plugin](https:\u002F\u002Fgithub.com\u002Fgmazzo\u002Fgradle-buildconfig-plugin) for compile-time constants\n- **No build variants** — single variant architecture; compile-time constants can use BuildKonfig\u002Fgradle-buildconfig-plugin flavors, but variant-specific dependencies\u002Fresources\u002Fsigning must move to app module\n- **NDK\u002FJNI unsupported** in new plugin — extract to separate `com.android.library` module\n- **Compose resources crash** without `androidResources { enable = true }`\n- **Consumer ProGuard rules silently dropped** if not migrated to `consumerProguardFiles.add(file(...))` in new DSL\n- **KSP** requires version 2.3.1+ for AGP 9.0 compatibility\n\n### AGP 9.0 General Issues\n- **BaseExtension removed** — convention plugins using old DSL types need rewriting to use `CommonExtension`\n- **Variant APIs removed** — `applicationVariants`, `libraryVariants`, `variantFilter` replaced by `androidComponents`\n- **Convention plugins** need refactoring — old `android {}` extension helpers are obsolete\n\n## Reference Files\n\n- DSL Reference (`references\u002FDSL_REFERENCE.md`) — side-by-side old→new DSL mapping\n- Version Matrix (`references\u002FVERSION_MATRIX.md`) — AGP\u002FGradle\u002FKGP\u002FCompose\u002FIDE compatibility\n- Plugin Compatibility (`references\u002FPLUGIN_COMPATIBILITY.md`) — third-party plugin status and workarounds\n",{"name":5,"license":15,"metadata":44,"description":47},{"author":45,"version":46},"JetBrains","1.0.0","Migrates Kotlin Multiplatform (KMP) projects to Android Gradle Plugin 9.0+. Handles plugin replacement (com.android.kotlin.multiplatform.library), module splitting, DSL migration, and the new default project structure. Use when upgrading AGP, when build fails due to KMP+AGP incompatibility, or when the user mentions AGP 9.0, android multiplatform plugin, KMP migration, or com.android.kotlin.multiplatform.library.\n","master","c2e410e11df4d80d885e0ecf0583ef3c926df736",".ai\u002Fskills\u002Fofficial_kotlin_kotlin_tooling_agp9_migration",0,"https:\u002F\u002Fgithub.com\u002FiDorgham\u002FWorkspace-Factory","https:\u002F\u002Fgithub.com\u002FiDorgham","Dorgham.me","hey I'm Dorgham \r\nI code, I create, and AI codes back. \r\nMaybe we can give AI the chance!! now we begin. 🚀🤖\r\n... . . . git commit -m \"Hello, Future\" ","2026-05-04 18:39:09",{"source":8,"skillName":5,"commands":58,"prompt":68,"zipAvailable":69},[59,62,65],{"tool":60,"command":61},"npx","npx skills add iDorgham\u002FWorkspace-Factory --skill kotlin-tooling-agp9-migration",{"tool":63,"command":64},"bunx","bunx skills add iDorgham\u002FWorkspace-Factory --skill kotlin-tooling-agp9-migration",{"tool":66,"command":67},"pnpm","pnpm dlx skills add iDorgham\u002FWorkspace-Factory --skill kotlin-tooling-agp9-migration","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FiDorgham\u002FWorkspace-Factory\u002Fblob\u002Fmaster\u002F.ai\u002Fskills\u002Fofficial_kotlin_kotlin_tooling_agp9_migration\u002Fskill.md",true,[],[72,105,128,150,169,192],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":76,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":84,"publishedAt":104},"01M71P8WVBMB2X3D24R0YT0B0E","vercel-react-view-transitions","Guide for implementing smooth, native-feeling animations using React's View Transition API (`\u003CViewTransition>` component, `addTransitionType`, and CSS view transition pseudo-elements). Use this skill whenever the user wants to add page transitions, animate route changes, create shared element animations, animate enter\u002Fexit of components, animate list reorder, implement directional (forward\u002Fback) navigation animations, or integrate view transitions in Next.js. Also use when the user mentions view transitions, `startViewTransition`, `ViewTransition`, transition types, or asks about animating between UI states in React without third-party animation libraries.","MIT","https:\u002F\u002Fgithub.com\u002FiDorgham\u002FWorkspace-Factory\u002Fblob\u002Fmaster\u002Ffactory\u002Flibrary\u002Fskills\u002Fofficial_vercel_labs_react_view_transitions\u002Fskill.md",[79],{"categoryNo":80,"categoryName":81,"taxonomyType":82,"taxonomyTypeDesc":83},"01JBSEEDCAT000000000000009","前端开发","SCENARIO","使用场景",[85,86,87,88,89,90,91,92,93,94,95,96,97,98,33,99,100,101,102,103],"react","vercel react view transitions","view","react view transitions","vercel","transitions","shared","back","Animation","css","types","states","element","implementing","components","api","route","create","libraries","2026-11-10 13:02:02",{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":76,"licenseFileUrl":6,"sourceHtmlUrl":109,"categories":110,"keywords":112,"publishedAt":104},"01M71P8TDGHZ289TSAC5VTG2EW","vercel-react-native-skills","React Native and Expo best practices for building performant mobile apps. Use when building React Native components, optimizing list performance, implementing animations, or working with native modules. Triggers on tasks involving React Native, Expo, mobile performance, or native platform APIs.","https:\u002F\u002Fgithub.com\u002FiDorgham\u002FWorkspace-Factory\u002Fblob\u002Fmaster\u002Ffactory\u002Flibrary\u002Fskills\u002Fofficial_vercel_labs_react_native_skills\u002Fskill.md",[111],{"categoryNo":80,"categoryName":81,"taxonomyType":82,"taxonomyTypeDesc":83},[85,113,114,89,115,116,117,118,98,119,33,120,99,121,122,123,124,125,126,127],"react native","native","vercel react native skills","react native skills","modules","performance","apps","tasks","mobile","expo","list","mobile performance","platform","animations","for",{"skillNo":129,"name":130,"nameZh":6,"description":131,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":76,"licenseFileUrl":6,"sourceHtmlUrl":132,"categories":133,"keywords":135,"publishedAt":104},"01M71P8QK4JF5BYRGYDDGPZQG9","vercel-react-best-practices","React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React\u002FNext.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.","https:\u002F\u002Fgithub.com\u002FiDorgham\u002FWorkspace-Factory\u002Fblob\u002Fmaster\u002Ffactory\u002Flibrary\u002Fskills\u002Fofficial_vercel_labs_react_best_practices\u002Fskill.md",[134],{"categoryNo":80,"categoryName":81,"taxonomyType":82,"taxonomyTypeDesc":83},[85,136,137,89,138,118,139,33,140,120,99,141,142,143,144,145,146,147,148,149],"react best practices","vercel react best practices","best practices","writing","code","data fetching","react components","next","refactoring","data","patterns","Optimization","guidelines","triggers",{"skillNo":151,"name":152,"nameZh":6,"description":153,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":76,"licenseFileUrl":6,"sourceHtmlUrl":154,"categories":155,"keywords":157,"publishedAt":104},"01M71P8HVEA70K5N6ZVJCG2ED3","vercel-composition-patterns","React composition patterns that scale. Use when refactoring components with boolean prop proliferation, building flexible component libraries, or designing reusable APIs. Triggers on tasks involving compound components, render props, context providers, or component architecture. Includes React 19 API changes.","https:\u002F\u002Fgithub.com\u002FiDorgham\u002FWorkspace-Factory\u002Fblob\u002Fmaster\u002Ffactory\u002Flibrary\u002Fskills\u002Fofficial_vercel_labs_composition_patterns\u002Fskill.md",[156],{"categoryNo":80,"categoryName":81,"taxonomyType":82,"taxonomyTypeDesc":83},[158,89,159,146,160,161,162,163,149,164,165,25,33,166,120,99,167,168,100,85],"Composition","composition patterns","vercel composition patterns","react composition patterns","react 19","render","boolean","component architecture","reusable","architecture","react composition",{"skillNo":170,"name":171,"nameZh":6,"description":172,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":76,"licenseFileUrl":6,"sourceHtmlUrl":173,"categories":174,"keywords":178,"publishedAt":104},"01M71P60XXKKP222ZFJRG7R373","supabase-postgres-best-practices","Postgres performance optimization and best practices from Supabase. Use this skill when writing, reviewing, or optimizing Postgres queries, schema designs, or database configurations.","https:\u002F\u002Fgithub.com\u002FiDorgham\u002FWorkspace-Factory\u002Fblob\u002Fmaster\u002Ffactory\u002Flibrary\u002Fskills\u002Fofficial_supabase_supabase_postgres_best_practices\u002Fskill.md",[175],{"categoryNo":176,"categoryName":177,"taxonomyType":82,"taxonomyTypeDesc":83},"01JBSEEDCAT000000000000010","后端与接口",[179,180,181,182,138,183,184,185,127,147,118,186,187,139,188,25,189,190,191,33],"postgres best practices","supabase","postgres","supabase postgres best practices","categories","postgres performance","advanced","correct","schema","impact","Rules","critical","database",{"skillNo":193,"name":194,"nameZh":6,"description":195,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":76,"licenseFileUrl":6,"sourceHtmlUrl":196,"categories":197,"keywords":199,"publishedAt":215},"01M71P2ZCEJD0PKC458YTP1FJW","portable-text-serialization","Render and serialize Portable Text to React, Svelte, Vue, Astro, HTML, Markdown, and plain text. Use when implementing Portable Text rendering in any frontend framework, building custom serializers for non-standard block types, converting Portable Text to HTML strings server-side, converting Portable Text to Markdown, extracting plain text from Portable Text, or troubleshooting rendering issues with marks, blocks, lists, or custom types.","https:\u002F\u002Fgithub.com\u002FiDorgham\u002FWorkspace-Factory\u002Fblob\u002Fmaster\u002Ffactory\u002Flibrary\u002Fskills\u002Fofficial_sanity_io_portable_text_serialization\u002Fskill.md",[198],{"categoryNo":80,"categoryName":81,"taxonomyType":82,"taxonomyTypeDesc":83},[200,201,202,203,204,95,205,163,206,98,207,208,33,85,209,210,211,212,213,214],"text","portable text serialization","portable","serialization","extracting","strings","issues","frontend","svelte","sanity","astro","server","markdown","rendering","vue","2026-11-10 10:56:23"]