[AGP 9] Added Flutter Errors #179765

jesswrd · 2025-12-11T23:41:43Z

Added Flutter errors that direct users to Updating to AGP 9 Flutter docs. The doc outlines the changes that must be made in order to successfully build Flutter apps on Android using AGP 9+.

As of this moment, the doc has yet to be written. The errors just have to be cherry picked to stable and beta by Tuesday, 12/16. The Flutter doc PR here can land later.

Resolves #179914

Pre-launch Checklist

I read the Contributor Guide and followed the process outlined there for submitting PRs.
I read the Tree Hygiene wiki page, which explains my responsibilities.
I read and followed the Flutter Style Guide, including Features we expect every widget to implement.
I signed the CLA.
I listed at least one issue that this PR fixes in the description above.
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.
I followed the breaking change policy and added Data Driven Fixes where supported.
All existing and new tests are passing.

If you need help, consider asking for advice on the #hackers-new channel on Discord.

Note: The Flutter team is currently trialing the use of Gemini Code Assist for GitHub. Comments from the gemini-code-assist bot should not be taken as authoritative feedback from the Flutter team. If you find its comments useful you can update your code accordingly, but if you are unsure or disagree with the feedback, please feel free to wait for a Flutter team member's review for guidance on which automated comments should be addressed.

camsim99

This LGTM just left some nits!

Ideally, I'd suggest this land around the same time as the website PR so if you cherry-pick this, the link is valid from the jump.

packages/flutter_tools/lib/src/android/gradle_errors.dart

reidbaker · 2025-12-16T17:48:50Z

packages/flutter_tools/lib/src/android/gradle_errors.dart

+@visibleForTesting
+final useNewAgpDslErrorHandler = GradleHandledError(
+  test: (String line) {
+    return line.contains("> Failed to apply plugin 'dev.flutter.flutter-gradle-plugin'.");


This feels too generic for the error text you are using. I feel like there are multiple reasons why the flutter plugin might fail to apply. Is there more of this error you can use to trigger?

Yeah, I think you're right. After a quick search, I see others running into similar or the same error. It looks like they're running into this error due to incompatible dependency versions.

I think there's still value in having this newDSL error message. What do you think about something like this:

To resolve this update flutter, ensure all dependencies are compatible with each other, or opt-out of `android.newDsl`.

I think we need to find a longer/most specific part of the error message to match on. For dependencies we could have them run flutter analyze --suggestions but we know that can be out of date compared to what is used.

I realize it would be good to match on the more specific part, but the entire error message is pretty generic. This is the whole message:

FAILURE: Build failed with an exception. * Where: Build file '/Users/jesswon/Desktop/fresh_flutter_app/android/app/build.gradle.kts' line: 4 * What went wrong: An exception occurred applying plugin request [id: 'dev.flutter.flutter-gradle-plugin'] > Failed to apply plugin 'dev.flutter.flutter-gradle-plugin'. > java.lang.NullPointerException (no error message)

Even if I matched using these two lines, I would also include/capture those dependency errors:

> Failed to apply plugin 'dev.flutter.flutter-gradle-plugin'. > java.lang.NullPointerException (no error message)

I can add a line that suggests running flutter analyze --suggestions.

I made a longer error message to match against and added the flutter analyze --suggestions suggestion to the error message.

packages/flutter_tools/lib/src/android/gradle_errors.dart

Added Flutter errors that direct users to Updating to AGP 9 Flutter docs. The doc outlines the changes that must be made in order to successfully build Flutter apps on Android using AGP 9+. As of this moment, the doc has yet to be written. The errors just have to be cherry picked to stable and beta by Tuesday, 12/16. The Flutter doc PR [here](flutter/website#12825) can land later. Resolves flutter#179914 ## 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]. - [x] I listed at least one issue that this PR fixes in the description above. - [x] I updated/added relevant documentation (doc comments with `///`). - [x] 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. - [ ] All existing and new tests are passing. If you need help, consider asking for advice on the #hackers-new channel on [Discord]. **Note**: The Flutter team is currently trialing the use of [Gemini Code Assist for GitHub](https://developers.google.com/gemini-code-assist/docs/review-github-code). Comments from the `gemini-code-assist` bot should not be taken as authoritative feedback from the Flutter team. If you find its comments useful you can update your code accordingly, but if you are unsure or disagree with the feedback, please feel free to wait for a Flutter team member's review for guidance on which automated comments should be addressed.  [Contributor Guide]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#overview [Tree Hygiene]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md [test-exempt]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#tests [Flutter Style Guide]: https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md [Features we expect every widget to implement]: https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md#features-we-expect-every-widget-to-implement [CLA]: https://cla.developers.google.com/ [flutter/tests]: https://github.com/flutter/tests [breaking change policy]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#handling-breaking-changes [Discord]: https://github.com/flutter/flutter/blob/main/docs/contributing/Chat.md [Data Driven Fixes]: https://github.com/flutter/flutter/blob/main/docs/contributing/Data-driven-Fixes.md

) (#180038) This is a manual cherry pick of #179765 and #180018 to beta. Combined into one CP PR because the second PR is a fix-forward. ### Issue Link: What is the link to the issue this cherry-pick is addressing? #179914 ### Impact Description: Impacted Users (Approximately who will hit this issue, ex. all Flutter devs, Windows developers, all end-customers, apps using X framework feature). Flutter devs who ship to Android and are updating to AGP 9.0.0. ### Changelog Description: Explain this cherry pick: * In one line that is accessible to most Flutter developers. * That describes the state prior to the fix. * That includes which platforms are impacted. See [best practices](https://github.com/flutter/flutter/blob/main/docs/releases/Hotfix-Documentation-Best-Practices.md) for examples. Added Flutter Errors to direct users to AGP 9 Migration Flutter docs when upgrading to AGP 9.0.0. ### Workaround: Is there a workaround for this issue? Currently, you can address the errors by looking through the comments at this issue [here](#175688) or reading Android AGP 9 preview docs [here](https://developer.android.com/build/releases/agp-preview). ### Risk: What is the risk level of this cherry-pick? ### Test Coverage: Are you confident that your fix is well-tested by automated tests? ### Validation Steps: Create or use an existing Flutter app. Update to AGP 9.0.0. Address the errors as instructed in the Flutter error, then run `flutter run` on the project.

…80018) (#180039) This is a manual cherry pick of #179765 and #180018 to beta. Combined into one CP PR because the second PR is a fix-forward. ### Issue Link: What is the link to the issue this cherry-pick is addressing? #179914 (beta CP: #180038) ### Impact Description: Impacted Users (Approximately who will hit this issue, ex. all Flutter devs, Windows developers, all end-customers, apps using X framework feature). Flutter devs who ship to Android and are updating to AGP 9.0.0. ### Changelog Description: Explain this cherry pick: * In one line that is accessible to most Flutter developers. * That describes the state prior to the fix. * That includes which platforms are impacted. See [best practices](https://github.com/flutter/flutter/blob/main/docs/releases/Hotfix-Documentation-Best-Practices.md) for examples. Added Flutter Errors to direct users to AGP 9 Migration Flutter docs when upgrading to AGP 9.0.0. ### Workaround: Is there a workaround for this issue? Currently, you can address the errors by looking through the comments at this issue [here](#175688) or reading Android AGP 9 preview docs [here](https://developer.android.com/build/releases/agp-preview). ### Risk: What is the risk level of this cherry-pick? ### Test Coverage: Are you confident that your fix is well-tested by automated tests? ### Validation Steps: Create or use an existing Flutter app. Update to AGP 9.0.0. Address the errors as instructed in the Flutter error, then run `flutter run` on the project.

flutter errors that direct users to the docs to update to AGP 9

2881ba5

github-actions bot added tool Affects the "flutter" command-line tool. See also t: labels. team-android Owned by Android platform team labels Dec 11, 2025

jesswrd changed the title ~~flutter errors that direct users to the docs to update to AGP 9~~ [AGP 9] Added Flutter Errors Dec 11, 2025

jesswrd marked this pull request as ready for review December 11, 2025 23:54

jesswrd requested a review from a team as a code owner December 11, 2025 23:54

got rid of trailing space

d848ff8

camsim99 mentioned this pull request Dec 16, 2025

Added Docs for AGP 9 flutter/website#12825

Open

4 tasks

camsim99 approved these changes Dec 16, 2025

View reviewed changes

reidbaker reviewed Dec 16, 2025

View reviewed changes

packages/flutter_tools/lib/src/android/gradle_errors.dart Outdated Show resolved Hide resolved

jesswrd added 3 commits December 16, 2025 11:23

resolved all low hanging fruit comments

32ec855

potential error message addition

8a75a65

added more lines to match against

04d9815

jesswrd requested a review from reidbaker December 16, 2025 22:04

jesswrd added 2 commits December 16, 2025 14:15

Merge branch 'master' into agp-9-error

4d9575d

Merge branch 'master' into agp-9-error

d67dec3

jesswrd added the autosubmit Merge PR when tree becomes green via auto submit App label Dec 17, 2025

auto-submit bot added this pull request to the merge queue Dec 17, 2025

Merged via the queue into flutter:master with commit abe119c Dec 17, 2025
141 checks passed

flutter-dashboard bot removed the autosubmit Merge PR when tree becomes green via auto submit App label Dec 17, 2025

jesswrd mentioned this pull request Dec 18, 2025

[CP-Beta] Add Flutter Errors for Migrating to AGP 9 (#179765 and #180018) #180038

Merged

5 tasks

jesswrd mentioned this pull request Dec 18, 2025

[CP-Stable] Add Flutter Errors for Migrating to AGP 9 (#179765 and #180018) #180039

Merged

5 tasks

engine-flutter-autoroll mentioned this pull request Dec 18, 2025

Roll Flutter from 6e1aa823523d to 4717a6489841 (103 revisions) flutter/packages#10642

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Dec 18, 2025

abe119cf6 [AGP 9] Added Flutter Errors (flutter/flutter#179765)

4ec089a

engine-flutter-autoroll mentioned this pull request Dec 18, 2025

Roll Flutter from 6e1aa823523d to 070d238e0e9a (104 revisions) flutter/packages#10643

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Dec 18, 2025

abe119cf6 [AGP 9] Added Flutter Errors (flutter/flutter#179765)

51a0f2f

engine-flutter-autoroll mentioned this pull request Dec 18, 2025

Roll Flutter from 6e1aa823523d to c967b4dc28bf (105 revisions) flutter/packages#10645

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Dec 18, 2025

abe119cf6 [AGP 9] Added Flutter Errors (flutter/flutter#179765)

b74718e

engine-flutter-autoroll mentioned this pull request Dec 18, 2025

Roll Flutter from 6e1aa823523d to 052435ce7b60 (106 revisions) flutter/packages#10646

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Dec 18, 2025

abe119cf6 [AGP 9] Added Flutter Errors (flutter/flutter#179765)

7e9ef73

engine-flutter-autoroll mentioned this pull request Dec 18, 2025

Roll Flutter from 6e1aa823523d to 5632701286ca (107 revisions) flutter/packages#10647

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Dec 18, 2025

abe119cf6 [AGP 9] Added Flutter Errors (flutter/flutter#179765)

c03e7de

engine-flutter-autoroll mentioned this pull request Dec 18, 2025

Roll Flutter from 6e1aa823523d to ca986c3900aa (108 revisions) flutter/packages#10648

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Dec 18, 2025

abe119cf6 [AGP 9] Added Flutter Errors (flutter/flutter#179765)

a456def

engine-flutter-autoroll mentioned this pull request Dec 19, 2025

Roll Flutter from 6e1aa823523d to 8663dcc606ab (123 revisions) flutter/packages#10650

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Dec 19, 2025

abe119cf6 [AGP 9] Added Flutter Errors (flutter/flutter#179765)

88a5b2e

engine-flutter-autoroll mentioned this pull request Dec 19, 2025

Roll Flutter from 6e1aa823523d to 2f7e4e773d3d (124 revisions) flutter/packages#10651

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Dec 19, 2025

abe119cf6 [AGP 9] Added Flutter Errors (flutter/flutter#179765)

36f45a9

engine-flutter-autoroll mentioned this pull request Dec 19, 2025

Roll Flutter from 6e1aa823523d to a38f2f3fe6d5 (125 revisions) flutter/packages#10652

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Dec 19, 2025

abe119cf6 [AGP 9] Added Flutter Errors (flutter/flutter#179765)

75726c7

engine-flutter-autoroll mentioned this pull request Dec 19, 2025

Roll Flutter from 6e1aa823523d to 4df70366d409 (126 revisions) flutter/packages#10653

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Dec 19, 2025

abe119cf6 [AGP 9] Added Flutter Errors (flutter/flutter#179765)

71b5fc5

engine-flutter-autoroll mentioned this pull request Dec 19, 2025

Roll Flutter from 6e1aa823523d to 0e9461ea4aef (127 revisions) flutter/packages#10654

Open

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Dec 19, 2025

abe119cf6 [AGP 9] Added Flutter Errors (flutter/flutter#179765)

bf7656c

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

[AGP 9] Added Flutter Errors #179765

[AGP 9] Added Flutter Errors #179765

jesswrd commented Dec 11, 2025 •

edited

Loading

Uh oh!

camsim99 left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

reidbaker Dec 16, 2025

Uh oh!

jesswrd Dec 16, 2025 •

edited

Loading

Uh oh!

reidbaker Dec 16, 2025

Uh oh!

jesswrd Dec 16, 2025

Uh oh!

jesswrd Dec 16, 2025

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

[AGP 9] Added Flutter Errors #179765

[AGP 9] Added Flutter Errors #179765

Conversation

jesswrd commented Dec 11, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Pre-launch Checklist

Uh oh!

camsim99 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

reidbaker Dec 16, 2025

Choose a reason for hiding this comment

Uh oh!

jesswrd Dec 16, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

reidbaker Dec 16, 2025

Choose a reason for hiding this comment

Uh oh!

jesswrd Dec 16, 2025

Choose a reason for hiding this comment

Uh oh!

jesswrd Dec 16, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

jesswrd commented Dec 11, 2025 •

edited

Loading

jesswrd Dec 16, 2025 •

edited

Loading