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..8f762a899cd 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 @@ -296,9 +296,27 @@ kotlin { ## Validate -Execute `flutter run` or `flutter build apk` to -confirm that your app builds and -launches on a connected Android device or emulator. +Before enabling built-in Kotlin, +confirm that you have migrated your application +and any Flutter plugins it uses. + +To enable built-in Kotlin, +set the `android.builtInKotlin` property to `true` +in your `gradle.properties` file: + +```properties diff title="/android/gradle.properties" +# ... ++ android.builtInKotlin=true +``` + +:::version-note +Enabling built-in Kotlin requires Flutter 3.47 or later. +::: + +After enabling built-in Kotlin, +execute `flutter run` or `flutter build apk` +to confirm that your app builds and launches +on a connected Android device or emulator. If your app fails to build because you are using an unmigrated Flutter plugin, 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..76562a01769 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 @@ -419,8 +419,26 @@ the newly released plugin version: ## Validate -Execute `flutter run` or `flutter build apk` to -confirm that your plugin example app builds and launches +Before enabling built-in Kotlin, +confirm that you have migrated your plugin example app +and any Flutter plugins it uses. + +To enable built-in Kotlin, +set the `android.builtInKotlin` property to `true` +in your `gradle.properties` file: + +```properties diff title="/android/gradle.properties" +# ... ++ android.builtInKotlin=true +``` + +:::version-note +Enabling built-in Kotlin requires Flutter 3.47 or later. +::: + +After enabling built-in Kotlin, +execute `flutter run` or `flutter build apk` +to confirm that your plugin example app builds and launches on a connected Android device or emulator. If your plugin example app also applies KGP,