Skip to content

Added Stronger Warning Against Using AGP 9#13039

Merged
jesswrd merged 3 commits intoflutter:mainfrom
jesswrd:stronger-warning-message-agp-9
Feb 6, 2026
Merged

Added Stronger Warning Against Using AGP 9#13039
jesswrd merged 3 commits intoflutter:mainfrom
jesswrd:stronger-warning-message-agp-9

Conversation

@jesswrd
Copy link
Contributor

@jesswrd jesswrd commented Feb 5, 2026

Added stronger warning cautioning users against using AGP 9. This aligns with the messaging in the blog post.

Related to flutter/flutter#181557

Preview:
https://flutter-docs-prod--pr13039-stronger-warning-message-ag-stvfwpvr.web.app/release/breaking-changes/migrate-to-agp-9

Presubmit checklist

  • If you are unwilling, or unable, to sign the CLA, even for a tiny, one-word PR, please file an issue instead of a PR.
  • If this PR is not meant to land until a future stable release, mark it as draft with an explanation.
  • This PR follows the Google Developer Documentation Style Guidelines—for example, it doesn't use i.e. or e.g., and it avoids I and we (first-person pronouns).
  • This PR uses semantic line breaks
    of 80 characters or fewer.

@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello @jesswrd, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request updates the documentation to provide a clearer and more emphatic warning to users about the current issues with Android Gradle Plugin 9 and Flutter applications. The change aims to prevent developers from encountering known incompatibilities, aligning the documentation with current recommendations and the status of ongoing audits.

Highlights

  • Enhanced Warning for AGP 9: A more prominent and detailed warning has been added to the top of the migrate-to-agp-9.md document, strongly advising against updating Flutter apps to Android Gradle Plugin (AGP) 9 due to current incompatibilities with plugins.
  • Warning Relocation: The previous, less prominent warning regarding AGP 9 incompatibility, which was located further down in the 'Migrate' section, has been removed to avoid redundancy and ensure the primary warning is seen first.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Changelog
  • src/content/release/breaking-changes/migrate-to-agp-9.md
    • Added a new, more prominent warning block at the beginning of the document, detailing the incompatibility of Flutter apps with AGP 9 when using plugins and referencing the relevant issue.
    • Removed the older, less prominent warning block from the 'Migrate' section, as its content is now superseded and better presented by the new top-level warning.
Activity
  • The pull request was created by jesswrd with the title "[WIP] Added Stronger Warning Against Using AGP 9" and a description outlining the intent to align messaging with a blog post.
  • No further review comments or activities have been recorded yet.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request strengthens the warning against migrating to Android Gradle Plugin 9 by moving the warning to the top of the document and making the language more direct. The change is well-aligned with the goal stated in the pull request description. I've suggested a minor wording improvement in the new warning message to enhance clarity and adhere more closely to the documentation style guide.

jesswrd and others added 2 commits February 5, 2026 15:50
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
@flutter-website-bot
Copy link
Collaborator

Visit the preview URL for this PR (updated for commit 5c1511e):

https://flutter-docs-prod--pr13039-stronger-warning-message-ag-stvfwpvr.web.app

Copy link
Contributor

@sfshaza2 sfshaza2 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

@sfshaza2 sfshaza2 added the act.await-dev-pr Needs dev PR to merge before merging docs label Feb 6, 2026
@jesswrd jesswrd changed the title [WIP] Added Stronger Warning Against Using AGP 9 Added Stronger Warning Against Using AGP 9 Feb 6, 2026
@jesswrd jesswrd marked this pull request as ready for review February 6, 2026 21:12
@jesswrd jesswrd requested a review from a team as a code owner February 6, 2026 21:12
@jesswrd jesswrd merged commit 63663f7 into flutter:main Feb 6, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

act.await-dev-pr Needs dev PR to merge before merging docs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants