From 5602a8865310f75b8901abd570c72fb26fa15041 Mon Sep 17 00:00:00 2001 From: jesswrd Date: Mon, 27 Jul 2026 16:41:05 -0700 Subject: [PATCH 1/3] added warnings to only migrate to built-in kotlin only if project already applies KGP --- .../migrate-to-built-in-kotlin/for-app-developers.md | 7 +++++++ .../migrate-to-built-in-kotlin/for-plugin-authors.md | 7 +++++++ .../breaking-changes/migrate-to-built-in-kotlin/index.md | 7 +++++++ 3 files changed, 21 insertions(+) diff --git a/sites/docs/src/content/release/breaking-changes/migrate-to-built-in-kotlin/for-app-developers.md b/sites/docs/src/content/release/breaking-changes/migrate-to-built-in-kotlin/for-app-developers.md index 2c034dbf21d..4489aa2c423 100644 --- a/sites/docs/src/content/release/breaking-changes/migrate-to-built-in-kotlin/for-app-developers.md +++ b/sites/docs/src/content/release/breaking-changes/migrate-to-built-in-kotlin/for-app-developers.md @@ -11,6 +11,13 @@ an AGP version created before 9.0.0 to an AGP version 9.0.0+. You should also use the minimum compatible dependency versions listed in the [Android Gradle Plugin docs][AGP block]. +:::warning +This guide only applies to apps that already use the +Kotlin Gradle Plugin (KGP). +If your project doesn't currently apply KGP, +don't migrate to built-in Kotlin. +::: + :::note To update Flutter plugins to use built-in Kotlin, follow the [migration guide for plugin authors][]. diff --git a/sites/docs/src/content/release/breaking-changes/migrate-to-built-in-kotlin/for-plugin-authors.md b/sites/docs/src/content/release/breaking-changes/migrate-to-built-in-kotlin/for-plugin-authors.md index 67f5398f415..e2816f2a4db 100644 --- a/sites/docs/src/content/release/breaking-changes/migrate-to-built-in-kotlin/for-plugin-authors.md +++ b/sites/docs/src/content/release/breaking-changes/migrate-to-built-in-kotlin/for-plugin-authors.md @@ -6,6 +6,13 @@ description: >- This guide outlines the migration steps specifically for plugin authors. +:::warning +This guide only applies to plugins that already use the +Kotlin Gradle Plugin (KGP). +If your plugin project doesn't currently apply KGP, +don't migrate to built-in Kotlin. +::: + :::note To update Flutter apps to use built-in Kotlin, follow the [migration guide for app developers][]. diff --git a/sites/docs/src/content/release/breaking-changes/migrate-to-built-in-kotlin/index.md b/sites/docs/src/content/release/breaking-changes/migrate-to-built-in-kotlin/index.md index 241aa1093cc..e77bf12bc2e 100644 --- a/sites/docs/src/content/release/breaking-changes/migrate-to-built-in-kotlin/index.md +++ b/sites/docs/src/content/release/breaking-changes/migrate-to-built-in-kotlin/index.md @@ -7,6 +7,13 @@ description: >- {% render "docs/breaking-changes.md" %} +:::warning +This guide only applies to apps and plugins that already use the +Kotlin Gradle Plugin (KGP). +If your project doesn't currently apply KGP, +don't migrate to built-in Kotlin. +::: + ## Summary To build a Flutter app for Android, From 202616486621c06b673e2e09fac704e242a42cd1 Mon Sep 17 00:00:00 2001 From: jesswrd Date: Mon, 27 Jul 2026 18:25:50 -0700 Subject: [PATCH 2/3] ensure plugin authors are updating example plugin apps to agp 9+ when verifying --- .../migrate-to-built-in-kotlin/for-plugin-authors.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/sites/docs/src/content/release/breaking-changes/migrate-to-built-in-kotlin/for-plugin-authors.md b/sites/docs/src/content/release/breaking-changes/migrate-to-built-in-kotlin/for-plugin-authors.md index 5991deab75e..a55b6f9baf3 100644 --- a/sites/docs/src/content/release/breaking-changes/migrate-to-built-in-kotlin/for-plugin-authors.md +++ b/sites/docs/src/content/release/breaking-changes/migrate-to-built-in-kotlin/for-plugin-authors.md @@ -428,7 +428,8 @@ the newly released plugin version: Before enabling built-in Kotlin, confirm that you have migrated your plugin example app -and any Flutter plugins it uses. +and any Flutter plugins it uses. Also confirm you have updated your +plugin example app to AGP version 9.0.0+. To enable built-in Kotlin, set the `android.builtInKotlin` property to `true` From 7f67bbfa0b97e89a10a45bef3e62ad84ce3134fc Mon Sep 17 00:00:00 2001 From: jesswrd Date: Thu, 30 Jul 2026 00:14:48 -0700 Subject: [PATCH 3/3] added directions on how to locate and verify kgp application also added agp 9 req --- .../for-app-developers.md | 14 +++++++++++++- .../for-plugin-authors.md | 15 +++++++++++++-- 2 files changed, 26 insertions(+), 3 deletions(-) diff --git a/sites/docs/src/content/release/breaking-changes/migrate-to-built-in-kotlin/for-app-developers.md b/sites/docs/src/content/release/breaking-changes/migrate-to-built-in-kotlin/for-app-developers.md index 0b1aa74e3c9..fa82e8d2cd3 100644 --- a/sites/docs/src/content/release/breaking-changes/migrate-to-built-in-kotlin/for-app-developers.md +++ b/sites/docs/src/content/release/breaking-changes/migrate-to-built-in-kotlin/for-app-developers.md @@ -14,7 +14,17 @@ listed in the [Android Gradle Plugin docs][AGP block]. :::warning This guide only applies to apps that already use the Kotlin Gradle Plugin (KGP). -If your project doesn't currently apply KGP, + +To verify whether your app applies KGP, +find the `kotlin-android` plugin +(or the `org.jetbrains.kotlin.android` plugin). +It is likely located in the +`/android/app/build.gradle` or +`/android/app/build.gradle.kts` file. +To view the KGP application code, +see [Update the Gradle file](#update-the-gradle-file). + +If your app doesn't currently apply KGP, don't migrate to built-in Kotlin. ::: @@ -306,6 +316,8 @@ kotlin { Before enabling built-in Kotlin, confirm that you have migrated your application and any Flutter plugins it uses. +Also, confirm that you updated your app +to AGP 9+, because built-in Kotlin requires AGP 9+. To enable built-in Kotlin, set the `android.builtInKotlin` property to `true` diff --git a/sites/docs/src/content/release/breaking-changes/migrate-to-built-in-kotlin/for-plugin-authors.md b/sites/docs/src/content/release/breaking-changes/migrate-to-built-in-kotlin/for-plugin-authors.md index a55b6f9baf3..5e6fc8a7b5c 100644 --- a/sites/docs/src/content/release/breaking-changes/migrate-to-built-in-kotlin/for-plugin-authors.md +++ b/sites/docs/src/content/release/breaking-changes/migrate-to-built-in-kotlin/for-plugin-authors.md @@ -9,6 +9,16 @@ This guide outlines the migration steps specifically for plugin authors. :::warning This guide only applies to plugins that already use the Kotlin Gradle Plugin (KGP). + +To verify whether your plugin applies KGP, +find the `kotlin-android` plugin +(or the `org.jetbrains.kotlin.android` plugin). +It is likely located in the +`/build.gradle` or +`/build.gradle.kts` file. +To view the KGP application code, +see [Update the Gradle file](#update-the-gradle-file). + If your plugin project doesn't currently apply KGP, don't migrate to built-in Kotlin. ::: @@ -428,8 +438,9 @@ the newly released plugin version: Before enabling built-in Kotlin, confirm that you have migrated your plugin example app -and any Flutter plugins it uses. Also confirm you have updated your -plugin example app to AGP version 9.0.0+. +and any Flutter plugins it uses. +Also, confirm that you updated your plugin example app +to AGP 9+, because built-in Kotlin requires AGP 9+. To enable built-in Kotlin, set the `android.builtInKotlin` property to `true`