Skip to content

Commit 67dbb9d

Browse files
jesswrdgemini-code-assist[bot]sfshaza2
authored
Add Docs Warning Plugins are not supported in AGP 9 (flutter#13015)
A external package maintainer found that plugins are currently not supported in AGP 9. Added a warning in the migration doc. Related to flutter/flutter#181383 ## Presubmit checklist - [x] 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. - [x] If this PR is not meant to land until a future stable release, mark it as draft with an explanation. - [x] This PR follows the [Google Developer Documentation Style Guidelines](https://developers.google.com/style)—for example, it doesn't use _i.e._ or _e.g._, and it avoids _I_ and _we_ (first-person pronouns). - [x] This PR uses [semantic line breaks](https://github.com/dart-lang/site-shared/blob/main/doc/writing-for-dart-and-flutter-websites.md#semantic-line-breaks) of 80 characters or fewer. --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> Co-authored-by: Shams Zakhour <44418985+sfshaza2@users.noreply.github.com>
1 parent 5cf741e commit 67dbb9d

1 file changed

Lines changed: 18 additions & 3 deletions

File tree

src/content/release/breaking-changes/migrate-to-agp-9.md

Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,13 @@ see the [Android Gradle Plugin docs][AGP block].
2929

3030
## Migrate
3131

32+
:::warning
33+
**Current Status:** Flutter apps using plugins are currently
34+
incompatible with AGP 9: [Issue #181383][].
35+
This support is paused while the Flutter team audits the migration for backwards
36+
compatibility with older versions of AGP.
37+
:::
38+
3239
These instructions assume you are updating from
3340
an AGP version created before 9.0.0 to an AGP version 9.0.0+.
3441
You should also use the minimum compatible dependency versions
@@ -137,16 +144,24 @@ your app's `<app-src>/android/gradle.properties` file.
137144
Execute `flutter run` to confirm that your app builds and
138145
launches on a connected Android device or emulator.
139146

140-
## Timeline
147+
## Next steps
148+
149+
- **Full Support for Plugins:** Full support for plugins on AGP 9
150+
will be enabled once the team confirms the migration is backwards compatible with
151+
older versions of AGP.
141152

142-
In stable release: TBD (for more details, see [Issue #179914][])
153+
- **Remove DSL Gradle Property:** Once the Flutter team completes the migration
154+
to the new AGP DSL, remove `android.newDsl=false` from your
155+
`gradle.properties` file. This document will be updated
156+
to reflect that change.
143157

144158
## References
145159

146160
Relevant issues:
147161

148162
- [Issue #175688][]: Audit flutter for compatibility with the AGP 9.0.0
149163
- [Issue #180137][]: Migrate from old to new AGP DSL
164+
- [Issue #181383][]: Flutter plugins should support AGP 9.0.0
150165

151166
The Gradle build files in your app vary based on the Flutter version
152167
used when your app was created.
@@ -156,6 +171,6 @@ in your app's directory.
156171

157172
[AGP block]: {{site.android-dev}}/build/releases/gradle-plugin
158173

159-
[Issue #179914]: {{site.github}}/flutter/flutter/issues/179914
160174
[Issue #175688]: {{site.github}}/flutter/flutter/issues/175688
161175
[Issue #180137]: {{site.github}}/flutter/flutter/issues/180137
176+
[Issue #181383]: {{site.github}}/flutter/flutter/issues/181383

0 commit comments

Comments
 (0)