Skip to content

[go_router_builder] Migrate to Element2 API and update dependencies #9649

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 9 commits into
base: main
Choose a base branch
from

Conversation

koji-1009
Copy link
Contributor

@koji-1009 koji-1009 commented Jul 19, 2025

close flutter/flutter#170832
close flutter/flutter#171003

  • Update build, build_test, and source_gen versions.
  • Update analyzer version to support Element2 API.
  • Fix unit test code formatting and comparison logic
  • Flutter 3.29 and Dart 3.7.

Pre-Review Checklist

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.

Footnotes

  1. Regular contributors who have demonstrated familiarity with the repository guidelines only need to comment if the PR is not auto-exempted by repo tooling. 2 3

Copy link

@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 migrates the go_router_builder package to the Element2 API, updating dependencies and improving test code formatting. The changes are well-structured and consistently applied across the codebase. The migration to the new API is crucial for maintaining compatibility with the latest versions of analyzer, build, and source_gen.

if (element.isRequired) {
if (element.type.nullabilitySuffix == NullabilitySuffix.question &&
_pathParams.contains(element.name)) {
_pathParams.contains(element.displayName)) {

Choose a reason for hiding this comment

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

high

The migration to Element2 API involves changes to how parameter names are accessed. Ensure that the display name is correctly used throughout the codebase to maintain consistency and prevent unexpected behavior.

@@ -60,14 +60,14 @@ class ShellRouteConfig extends RouteBaseConfig {

@override
Iterable<String> classDeclarations() {
if (routeDataClass.unnamedConstructor == null) {
if (routeDataClass.unnamedConstructor2 == null) {

Choose a reason for hiding this comment

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

medium

The migration to Element2 API involves changes to how constructor elements are accessed. Consider updating the error message to reflect the new API usage and improve clarity for developers debugging potential issues related to constructor access.

Comment on lines 60 to 62
final String generated = formatter.format(results.join().replaceAll('\n', ''));
final String expected = formatter.format(expectResult.replaceAll('\n', ''));
expect(generated, equals(expected));

Choose a reason for hiding this comment

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

medium

The comparison logic has been updated to improve robustness against formatting variations. Consider adding a comment explaining why the replaceAll calls are necessary to improve code understanding and maintainability.

@koji-1009
Copy link
Contributor Author

@koji-1009 koji-1009 marked this pull request as ready for review July 21, 2025 02:39
@koji-1009 koji-1009 requested a review from chunhtai as a code owner July 21, 2025 02:39
@koji-1009
Copy link
Contributor Author

koji-1009 commented Jul 21, 2025

Fix test code to support windows path separator. 96d68f9

}
}

InfoIterable _generateForAnnotatedElement(
Element element,
Element2 element,
Copy link
Contributor

Choose a reason for hiding this comment

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

looking at the doc https://pub.dev/documentation/analyzer/latest/dart_element_element/Element2.html

should we keep the original class name

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@chunhtai
Element2 will be deprecated starting with analyzer v8.0.0. Since analyzer: “>=7.4.0 <8.0.0” is set, Element2 is not deprecated.

https://pub.dev/documentation/analyzer/7.7.1/dart_element_element2/Element2-class.html
https://pub.dev/documentation/analyzer/8.0.0/dart_element_element/Element2.html

Other libraries are also replacing Element2 in the same way.

google/json_serializable.dart#1504
rrousselGit/freezed#1276

Copy link
Contributor

@chunhtai chunhtai Jul 30, 2025

Choose a reason for hiding this comment

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

can we pin analyzer 8.0.0 and above directly?

Copy link
Contributor Author

@koji-1009 koji-1009 Jul 30, 2025

Choose a reason for hiding this comment

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

final String routeData = _annotations[type]!;
if (element is! ClassElement) {
if (element is! ClassElement2) {
Copy link
Contributor

Choose a reason for hiding this comment

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

throw InvalidGenerationSourceError(
'The ShellRouteData "$_className" class must have an unnamed constructor.',
element: routeDataClass,
);
}

final bool isConst = routeDataClass.unnamedConstructor!.isConst;
final bool isConst = routeDataClass.unnamedConstructor2!.isConst;
Copy link
Contributor

Choose a reason for hiding this comment

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

Copy link
Contributor

Choose a reason for hiding this comment

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

and all other places

@koji-1009 koji-1009 requested a review from chunhtai July 30, 2025 21:49
@koji-1009
Copy link
Contributor Author

@chunhtai
I think it is better for go_router_builder to specify analyzer ^7.4.0, at least until source_gen starts specifying analyzer ^8.0.0.

https://github.com/dart-lang/source_gen/blob/source_gen-v3.0.0/source_gen/pubspec.yaml

Copy link
Contributor

@chunhtai chunhtai left a comment

Choose a reason for hiding this comment

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

LGTM

@chunhtai chunhtai requested a review from hannah-hyj August 1, 2025 19:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[go_router_builder] ClassElement is deprecated [go_router_builder] Update to build_test 3.x
2 participants