Skip to content

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

Closed
flutter/flutter
#168561

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.

Activity

  1. sfshaza2 commented on Jan 14, 2025

    @sfshaza2
    Contributor

    @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.

  2. added
    p2-mediumNecessary but not urgent concern. Resolve when possible.
    e2-daysEffort: < 5 days
    on Jan 14, 2025
  3. jmagman commented on May 8, 2025

    @jmagman
    Member

    @reidbaker @gmackall could you give guidance?

  4. gmackall commented on May 8, 2025

    @gmackall
    Member

    We should just delete the old link

    https://github.com/flutter/flutter/pull/168561/files

  5. gmackall commented on May 9, 2025

    @gmackall
    Member

    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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

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