Skip to content

Update built-in Kotlin migration doc#13254

Merged
sfshaza2 merged 28 commits intoflutter:mainfrom
jesswrd:update-built-in-kotlin-migration-doc
Apr 9, 2026
Merged

Update built-in Kotlin migration doc#13254
sfshaza2 merged 28 commits intoflutter:mainfrom
jesswrd:update-built-in-kotlin-migration-doc

Conversation

@jesswrd
Copy link
Copy Markdown
Contributor

@jesswrd jesswrd commented Apr 6, 2026

Updated the name of doc from "Upgrade to AGP 9 Migration Docs" to "Built-in Kotlin Migraction Docs."

I added the following:
-migration instructions for plugin authors
-migration isntructions for app develoeprs working on add-to-app host apps

I also refactored the docs to have the same structure as the swift package manager migration docs here. They seem more readable.

These website docs links here are referenced when developers receive error logs here.

Related to: flutter/flutter#181557

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.

@jesswrd jesswrd requested review from a team and sfshaza2 as code owners April 6, 2026 23:34
Copy link
Copy Markdown
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 updates the breaking changes documentation by replacing the Android Gradle Plugin 9.0.0 migration guide with a more comprehensive guide focused on migrating Flutter Android projects to built-in Kotlin. The new documentation provides detailed instructions for apps, plugins, and host apps using both Kotlin and Groovy DSLs. Review feedback focuses on improving the documentation's adherence to technical writing standards, including the correct capitalization of "Flutter" and "Android," fixing grammatical errors in pluralization, and removing first-person pronouns and informal phrasing to align with style guidelines.

@flutter-website-bot
Copy link
Copy Markdown
Collaborator

flutter-website-bot commented Apr 6, 2026

Visit the preview URL for this PR (updated for commit 58d6ed8):

https://flutter-docs-prod--pr13254-update-built-in-kotlin-migr-k8k1lhh5.web.app

@jesswrd jesswrd changed the title Update built-in Kotlin migration doc [WIP] Update built-in Kotlin migration doc Apr 7, 2026
@jesswrd jesswrd marked this pull request as draft April 7, 2026 16:42
@jesswrd jesswrd marked this pull request as ready for review April 9, 2026 19:46
@jesswrd jesswrd changed the title [WIP] Update built-in Kotlin migration doc Update built-in Kotlin migration doc Apr 9, 2026
Copy link
Copy Markdown
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 replaces the previous Android Gradle Plugin 9.0.0 migration guide with a comprehensive set of documents for migrating Flutter projects to built-in Kotlin. The new documentation includes dedicated guides for app developers and plugin authors, along with updated site navigation. Feedback identifies a missing link definition for Issue #184839 and suggests several improvements to the clarity of DSL block descriptions and the directness of internal links.

Copy link
Copy Markdown
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.

Overall, lgtm! Just a few formatting issues.

@sfshaza2 sfshaza2 merged commit ce8d625 into flutter:main Apr 9, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants