Migrate tests and documentation to set java version to 17 (flutter#176204)

reidbaker · gemini-code-assist[bot] · web-flow · commit 2a109b46cfb4 · 2025-09-29T17:12:54.000Z
## Pre-launch Checklist

- [x] I read the [Contributor Guide] and followed the process outlined
there for submitting PRs.
- [x] I read the [Tree Hygiene] wiki page, which explains my
responsibilities.
- [x] I read and followed the [Flutter Style Guide], including [Features
we expect every widget to implement].
- [x] I signed the [CLA].
- [ ] I listed at least one issue that this PR fixes in the description
above.
- [x] I updated/added relevant documentation (doc comments with `///`).
- [ ] I added new tests to check the change I am making, or this PR is
[test-exempt].
- [x] I followed the [breaking change policy] and added [Data Driven
Fixes] where supported.
- [x] All existing and new tests are passing.

---------

Co-authored-by: gemini-code-assist[bot] &lt;176961590+gemini-code-assist[bot]@users.noreply.github.com&gt;
diff --git a/dev/a11y_assessments/android/app/build.gradle b/dev/a11y_assessments/android/app/build.gradle
@@ -46,12 +46,12 @@ android {
     }
 
     compileOptions {
-        sourceCompatibility = JavaVersion.VERSION_11
-        targetCompatibility = JavaVersion.VERSION_11
+        sourceCompatibility = JavaVersion.VERSION_17
+        targetCompatibility = JavaVersion.VERSION_17
     }
 
     kotlinOptions {
-        jvmTarget = JavaVersion.VERSION_11.toString()
+        jvmTarget = JavaVersion.VERSION_17.toString()
     }
 
     sourceSets {
diff --git a/dev/benchmarks/complex_layout/android/app/build.gradle b/dev/benchmarks/complex_layout/android/app/build.gradle
@@ -39,8 +39,8 @@ android {
     }
 
     compileOptions {
-        sourceCompatibility JavaVersion.VERSION_11
-        targetCompatibility JavaVersion.VERSION_11
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
     }
 
     defaultConfig {
diff --git a/dev/benchmarks/macrobenchmarks/android/app/build.gradle b/dev/benchmarks/macrobenchmarks/android/app/build.gradle
@@ -39,8 +39,8 @@ android {
     }
 
     compileOptions {
-        sourceCompatibility JavaVersion.VERSION_11
-        targetCompatibility JavaVersion.VERSION_11
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
     }
 
     defaultConfig {
diff --git a/dev/benchmarks/microbenchmarks/android/app/build.gradle b/dev/benchmarks/microbenchmarks/android/app/build.gradle
@@ -39,8 +39,8 @@ android {
     }
 
     compileOptions {
-        sourceCompatibility JavaVersion.VERSION_11
-        targetCompatibility JavaVersion.VERSION_11
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
     }
 
     defaultConfig {
diff --git a/dev/benchmarks/platform_views_layout/android/app/build.gradle b/dev/benchmarks/platform_views_layout/android/app/build.gradle
@@ -39,8 +39,8 @@ android {
     }
 
     compileOptions {
-        sourceCompatibility JavaVersion.VERSION_11
-        targetCompatibility JavaVersion.VERSION_11
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
     }
 
     defaultConfig {
diff --git a/dev/benchmarks/platform_views_layout_hybrid_composition/android/app/build.gradle b/dev/benchmarks/platform_views_layout_hybrid_composition/android/app/build.gradle
@@ -39,8 +39,8 @@ android {
     }
 
     compileOptions {
-        sourceCompatibility JavaVersion.VERSION_11
-        targetCompatibility JavaVersion.VERSION_11
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
     }
 
     defaultConfig {
diff --git a/dev/benchmarks/test_apps/stocks/android/app/build.gradle b/dev/benchmarks/test_apps/stocks/android/app/build.gradle
@@ -39,8 +39,8 @@ android {
     }
 
     compileOptions {
-        sourceCompatibility JavaVersion.VERSION_11
-        targetCompatibility JavaVersion.VERSION_11
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
     }
 
     defaultConfig {
diff --git a/dev/manual_tests/android/app/build.gradle b/dev/manual_tests/android/app/build.gradle
@@ -40,12 +40,12 @@ android {
     }
 
     compileOptions {
-        sourceCompatibility JavaVersion.VERSION_11
-        targetCompatibility JavaVersion.VERSION_11
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
     }
 
     kotlinOptions {
-        jvmTarget = JavaVersion.VERSION_11.toString()
+        jvmTarget = JavaVersion.VERSION_17.toString()
     }
 
     sourceSets {
diff --git a/docs/contributing/Android-API-And-Related-Versions.md b/docs/contributing/Android-API-And-Related-Versions.md
@@ -129,19 +129,19 @@ classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
 - jvmTarget should use JavaVersion.<SOMEVERSION>.toString() or there should be a comment explaining why.
 
 ```
-// Ok
+// Correct configuration
 compileOptions {
-    sourceCompatibility = JavaVersion.VERSION_11
-    targetCompatibility = JavaVersion.VERSION_11
+    sourceCompatibility = JavaVersion.VERSION_17
+    targetCompatibility = JavaVersion.VERSION_17
 }
 
 kotlinOptions {
-    jvmTarget = JavaVersion.VERSION_11.toString()
+    jvmTarget = JavaVersion.VERSION_17.toString()
 }
 ```
 
 ```
-// Not ok
+// Not ok, kotlinOptions uses a string.
 compileOptions {
     sourceCompatibility = JavaVersion.VERSION_17
     targetCompatibility = JavaVersion.VERSION_17
@@ -153,7 +153,7 @@ kotlinOptions {
 ```
 
 ```
-// Not ok
+// Not ok, different versions of java
 compileOptions {
     sourceCompatibility = JavaVersion.VERSION_11
     targetCompatibility = JavaVersion.VERSION_11
diff --git a/engine/src/flutter/shell/platform/android/test_runner/build.gradle b/engine/src/flutter/shell/platform/android/test_runner/build.gradle
@@ -40,8 +40,8 @@ android {
   }
 
   compileOptions {
-    sourceCompatibility JavaVersion.VERSION_11
-    targetCompatibility JavaVersion.VERSION_11
+    sourceCompatibility JavaVersion.VERSION_17
+    targetCompatibility JavaVersion.VERSION_17
   }
 
   testOptions {

Original file line number	Diff line number	Diff line change
`@@ -46,12 +46,12 @@ android {`
`46`	`46`	`}`
`47`	`47`
`48`	`48`	`compileOptions {`
`49`		`- sourceCompatibility = JavaVersion.VERSION_11`
`50`		`- targetCompatibility = JavaVersion.VERSION_11`
	`49`	`+ sourceCompatibility = JavaVersion.VERSION_17`
	`50`	`+ targetCompatibility = JavaVersion.VERSION_17`
`51`	`51`	`}`
`52`	`52`
`53`	`53`	`kotlinOptions {`
`54`		`- jvmTarget = JavaVersion.VERSION_11.toString()`
	`54`	`+ jvmTarget = JavaVersion.VERSION_17.toString()`
`55`	`55`	`}`
`56`	`56`
`57`	`57`	`sourceSets {`
Original file line number	Diff line number	Diff line change
`@@ -39,8 +39,8 @@ android {`
`39`	`39`	`}`
`40`	`40`
`41`	`41`	`compileOptions {`
`42`		`- sourceCompatibility JavaVersion.VERSION_11`
`43`		`- targetCompatibility JavaVersion.VERSION_11`
	`42`	`+ sourceCompatibility JavaVersion.VERSION_17`
	`43`	`+ targetCompatibility JavaVersion.VERSION_17`
`44`	`44`	`}`
`45`	`45`
`46`	`46`	`defaultConfig {`
Original file line number	Diff line number	Diff line change
`@@ -40,12 +40,12 @@ android {`
`40`	`40`	`}`
`41`	`41`
`42`	`42`	`compileOptions {`
`43`		`- sourceCompatibility JavaVersion.VERSION_11`
`44`		`- targetCompatibility JavaVersion.VERSION_11`
	`43`	`+ sourceCompatibility JavaVersion.VERSION_17`
	`44`	`+ targetCompatibility JavaVersion.VERSION_17`
`45`	`45`	`}`
`46`	`46`
`47`	`47`	`kotlinOptions {`
`48`		`- jvmTarget = JavaVersion.VERSION_11.toString()`
	`48`	`+ jvmTarget = JavaVersion.VERSION_17.toString()`
`49`	`49`	`}`
`50`	`50`
`51`	`51`	`sourceSets {`
Original file line number	Diff line number	Diff line change
`@@ -40,8 +40,8 @@ android {`
`40`	`40`	`}`
`41`	`41`
`42`	`42`	`compileOptions {`
`43`		`- sourceCompatibility JavaVersion.VERSION_11`
`44`		`- targetCompatibility JavaVersion.VERSION_11`
	`43`	`+ sourceCompatibility JavaVersion.VERSION_17`
	`44`	`+ targetCompatibility JavaVersion.VERSION_17`
`45`	`45`	`}`
`46`	`46`
`47`	`47`	`testOptions {`