Repository navigation
Lack of information in docs which possibly needs a more modern fix via LLM's #11530
Description
Page URL
https://docs.flutter.dev/release/breaking-changes/android-java-gradle-migration-guide/
Page source
Describe the problem
The actual error I encountered was:
Running Gradle task 'assembleRelease'...
FAILURE: Build failed with an exception.
- What went wrong:
Could not open cp_settings generic class cache for settings file '/home/nav/code/simple_notes/android/settings.gradle' (/home/nav/.gradle/caches/7.6.3/scripts/digrbcejqtzh2o323b6w8i67r).BUG! exception in phase 'semantic analysis' in source unit 'BuildScript' Unsupported class file major version 65
For which a Flutter fix was displayed as:
[!] Your project's Gradle version is incompatible with the Java version that Flutter is using │
│ for Gradle. │
│ │
│ If you recently upgraded Android Studio, consult the migration guide at │
│ https://flutter.dev/to/java-gradle-incompatibility.
But in the solution, what is mentioned is In Android Studio, open the android folder. This should bring up the following dialog:. And I don't know what this means. In my project when I open the android folder in Android Studio, no dialog opens up.
Expected fix
You need to clearly specify all the steps to do to reach this "android folder" you mentioned. But why are you guys expecting Users to follow these long set of instructions?
This is the age of LLM's. Can't you guys change the IDE functionality to let the IDE automatically figure out what the errors are and automatically do the necessary downloads and fixes? Why are you still expecting Users to go through error messages and then go to documentation pages and then search the internet or StackOverflow for a solution? Besides, it would be annoying for your team to keep updating the documentation too, especially when your other team members keep changing the UI as per their whims.
Please escalate this matter and find a more modern solution to this issue.
Additional context
No response
I would like to fix this problem.
- I will try and fix this problem on docs.flutter.dev.
Activity
sfshaza2 commentedon Jan 14, 2025
@jmagman, the Flutter tooling generates an error that refers the developer to the above doc (java-gradle-incompatibility), which redirects to a breaking change doc published for the 3.10 release (android-java-gradle-migrations-guide).
That migration guide is, not surprisingly, out of date. Can you tell me: do we need a new guide for this (different) issue? We don't typically upgrade breaking change docs that are so old, but I'm not sure what the best course of action here is.
jmagman commentedon May 8, 2025
@reidbaker @gmackall could you give guidance?
gmackall commentedon May 8, 2025
We should just delete the old link
https://github.com/flutter/flutter/pull/168561/files
Remove old link for java gradle incompatibility (#168561)
gmackall commentedon May 9, 2025
The link was deleted in flutter/flutter#168561, should we mark this as completed? I expect the rest of the issue is out of scope for a website issue.
Remove old link for java gradle incompatibility (#168561)