SuperAPI AI 工具集

kotlin-tooling-agp9-migration

通用与其它

查看项目

更新于 10-15 23:47

技能介绍

用途:指导把 Kotlin Multiplatform(KMP)项目迁移到 Android Gradle Plugin(AGP)9.0+。AGP 9.0 使 Android 应用与库插件无法与 KMP 插件在同一模块共存,因此需要按模块类型选择迁移路径。

主要能力:先分析项目结构(settings.gradle.kts、各模块 build.gradle.kts、版本目录 gradle/libs.versions.toml、gradle-wrapper.properties、gradle.properties),再按模块分类:kotlin.multiplatform + com.android.library 走 Path A(库插件替换为 com.android.kotlin.multiplatform.library,DSL 移入 kotlin { android {} },源目录改为 androidMain/androidHostTest/androidDeviceTest,依赖移入 sourceSets,按需启用 androidResources、withJava()、withHostTest、withDeviceTest,Compose 工具依赖改用 androidRuntimeClasspath,并用 localDependencySelection 处理多变体依赖);kotlin.multiplatform + com.android.application 必须走 Path B(拆出 androidApp 模块,迁移入口代码与清单,原模块转为库);含多平台入口的单体模块推荐 Path C(拆出 desktopApp、webApp,重命名 composeApp 为 shared)。

必要用法:Gradle wrapper 升级到 9.1.0+,AGP 升级到 9.0.0+,JDK 17+,SDK Build Tools 36.0.0。移除 org.jetbrains.kotlin.android(AGP 9.0 内置 Kotlin),kapt 迁移到 KSP 或 com.android.legacy-kapt,kotlinOptions 迁移到 kotlin.compilerOptions,kotlin.sourceSets 迁移到 android.sourceSets。可逐模块迁移:先设 android.builtInKotlin=false,再对已迁移模块应用 com.android.built-in-kotlin。

适用场景:KMP 项目升级 AGP 9.0 时的插件替换、模块拆分与属性默认值调整。

限制:需先核对插件兼容性表;部分插件需临时 opt-out(android.builtInKotlin=false、android.newDsl=false);Gradle 属性默认值变更需逐项检查。具体版本与兼容性细节以官方资料为准。