Skip to content

Lack of information in docs which possibly needs a more modern fix via LLM's #11530

Closed
flutter/flutter
#168561
@nav9

Description

@nav9

Page URL

https://docs.flutter.dev/release/breaking-changes/android-java-gradle-migration-guide/

Page source

https://github.com/flutter/website/tree/main/src/content/release/breaking-changes/android-java-gradle-migration-guide.md

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    e2-daysEffort: < 5 daysfrom.page-issueReported in a reader-filed concernp2-mediumNecessary but not urgent concern. Resolve when possible.

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions