From 5602a8865310f75b8901abd570c72fb26fa15041 Mon Sep 17 00:00:00 2001 From: jesswrd Date: Mon, 27 Jul 2026 16:41:05 -0700 Subject: [PATCH 1/2] 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/2] 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`