用途：将 Android 项目从旧版本 AGP 升级到 AGP 9，适用于迁移到 AGP 9、更新 Gradle 构建文件、迁移到内置 Kotlin 等场景。不适用于 Kotlin Multiplatform (KMP) 项目。
前置检查：先确认当前 AGP 版本，若低于 8.x，建议先在 Android Studio 中运行 AGP Upgrade Assistant。须对照 AGP 9 发布说明核对 Gradle、JDK 与 Kotlin 版本兼容性。
主要步骤：
- 更新依赖：若使用 KSP (com.google.devtools.ksp)，需 2.3.6+；若使用 Hilt，需 2.59.2+；将 AGP 升级到最新稳定 9.x 版本。
- 迁移到内置 Kotlin：AGP 9 内置 Kotlin 支持，不再需要 org.jetbrains.kotlin.android 插件。
- 迁移到新 AGP DSL：android {} 块引入新 DSL，涉及 namespace 处理、构建类型配置和源集声明。
- kapt 迁移：优先迁移到 KSP（Room、Hilt、Moshi）；不支持 KSP 的处理器用 legacy-kapt 作为过渡。
- 更新 BuildConfig：如模块使用自定义 BuildConfig 字段，改用 AGP 9 新语法。
- 清理 gradle.properties：迁移后移除 android.builtInKotlin、android.newDsl、android.uniquePackageNames、android.enableAppCompileTimeRClass。
限制与注意：不得为构建迁移编写或运行 Python 脚本；不要在 gradle.properties 中添加 android.disallowKotlinSourceSets=false；验证时不要运行 clean 任务。
验证方式：./gradlew help 成功；./gradlew build --dry-run 成功；Gradle IDE 同步成功。