Skip to content

Conversation

@flutteractionsbot
Copy link

@flutteractionsbot flutteractionsbot commented Nov 24, 2025

This pull request is created by automatic cherry pick workflow
Please fill in the form below, and a flutter domain expert will evaluate this cherry pick request.

Issue Link:

What is the link to the issue this cherry-pick is addressing?

#178660

Changelog Description:

Explain this cherry pick in one line that is accessible to most Flutter developers. See best practices for examples

flutter widget-preview start can crash if .dart_tool/widget_preview_scaffold/.dart_tool doesn't exist on subsequent runs.

Impact Description:

What is the impact (ex. visual jank on Samsung phones, app crash, cannot ship an iOS app)? Does it impact development (ex. flutter doctor crashes when Android Studio is installed), or the shipping production app (the app crashes on launch)

If the .dart_tool/widget_preview_scaffold/.dart_tool/ directory wasn't created during the initial run of flutter widget-preview start due to the command being interrupted or pub being disabled, flutter widget-preview start would crash due to the package_config.json logic walking up the directory structure looking for the nearest package_config.json. This would point to the parent project's package_config.json, which would not be compatible with the widget preview scaffold project.

Workaround:

Is there a workaround for this issue?

Manually running flutter pub get in .dart_tool/widget_preview_scaffold/.

Risk:

What is the risk level of this cherry-pick?

  • Low
  • Medium
  • High

Test Coverage:

Are you confident that your fix is well-tested by automated tests?

  • Yes
  • No

Validation Steps:

What are the steps to validate that this fix works?

  1. Run flutter widget-preview start and close it once the previewer opens
  2. Delete .dart_tool/widget_preview_scaffold/.dart_tool
  3. Run flutter widget-preview start and verify the previewer opens

…` doesn't exist (flutter#178662)

If the `.dart_tool/widget_preview_scaffold/.dart_tool/` directory wasn't
created during the initial run of `flutter widget-preview start` due to
the command being interrupted or `pub` being disabled, `flutter
widget-preview start` would crash due to the `package_config.json` logic
walking up the directory structure looking for the nearest
`package_config.json`. This would point to the parent project's
`package_config.json`, which would not be compatible with the widget
preview scaffold project.

Fixes flutter#178660 and
flutter#177655
@flutteractionsbot flutteractionsbot added the cp: review Cherry-picks in the review queue label Nov 24, 2025
@flutteractionsbot
Copy link
Author

@bkonyi please fill out the PR description above, afterwards the release team will review this request.

@flutter-dashboard
Copy link

This pull request was opened from and to a release candidate branch. This should only be done as part of the official Flutter release process. If you are attempting to make a regular contribution to the Flutter project, please close this PR and follow the instructions at Tree Hygiene for detailed instructions on contributing to Flutter.

Reviewers: Use caution before merging pull requests to release branches. Ensure the proper procedure has been followed.

@github-actions github-actions bot added the tool Affects the "flutter" command-line tool. See also t: labels. label Nov 24, 2025
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 addresses a crash in the widget preview feature that occurs when the widget_preview_scaffold/.dart_tool directory is missing. The fix introduces a check for this directory's existence and, if absent, generates the necessary package configuration. This logic is encapsulated in a new, reusable method within PreviewPubspecBuilder. Additionally, a new integration test has been added to verify the fix and prevent future regressions. The changes are well-structured and effectively resolve the issue.

@eyebrowsoffire eyebrowsoffire added the autosubmit Merge PR when tree becomes green via auto submit App label Dec 2, 2025
@auto-submit auto-submit bot merged commit aa5986c into flutter:flutter-3.38-candidate.0 Dec 2, 2025
141 checks passed
engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Dec 4, 2025
engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request Dec 5, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

autosubmit Merge PR when tree becomes green via auto submit App cp: review Cherry-picks in the review queue tool Affects the "flutter" command-line tool. See also t: labels.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants