Skip to content

Improve the error if the tool cannot find the locally built engine#184546

Merged
auto-submit[bot] merged 3 commits into
flutter:masterfrom
loic-sharma:engine_src_path_error
Apr 21, 2026
Merged

Improve the error if the tool cannot find the locally built engine#184546
auto-submit[bot] merged 3 commits into
flutter:masterfrom
loic-sharma:engine_src_path_error

Conversation

@loic-sharma

Copy link
Copy Markdown
Member

Updates the error message to bubble up that you can use the --local-engine-src-path flag or the FLUTTER_ENGINE environment variable to manually specify the engine source path. This can be useful in advanced scenarios.

Pre-launch 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.

@loic-sharma
loic-sharma requested a review from bkonyi April 2, 2026 23:32
@github-actions github-actions Bot added the tool Affects the "flutter" command-line tool. See also t: labels. label Apr 2, 2026
@loic-sharma loic-sharma changed the title Improve the error if a locally built engine cannot be found Improve the error if the tool cannot find the locally built engine Apr 2, 2026
@loic-sharma
loic-sharma force-pushed the engine_src_path_error branch from 170c64a to c3defb3 Compare April 2, 2026 23:34

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

Copy link
Copy Markdown
Contributor

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 error message in LocalEngineLocator to provide more detailed troubleshooting instructions when a Flutter engine build directory is missing, and updates the corresponding test. A suggestion was made to use a multi-line string literal for the error message to improve readability.

Comment thread packages/flutter_tools/lib/src/runner/local_engine.dart
@loic-sharma loic-sharma added the CICD Run CI/CD label Apr 3, 2026
@github-actions github-actions Bot removed the CICD Run CI/CD label Apr 3, 2026
@loic-sharma
loic-sharma force-pushed the engine_src_path_error branch from 3dc8a8b to ad3e79e Compare April 5, 2026 00:10
@loic-sharma loic-sharma added the CICD Run CI/CD label Apr 6, 2026

@bkonyi bkonyi left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Nice! Using local engines is always confusing, so making this clearer is great!

@loic-sharma
loic-sharma force-pushed the engine_src_path_error branch from ad3e79e to 1eae0c8 Compare April 15, 2026 00:00
@github-actions github-actions Bot removed the CICD Run CI/CD label Apr 15, 2026
@loic-sharma loic-sharma added the autosubmit Merge PR when tree becomes green via auto submit App label Apr 15, 2026
@auto-submit auto-submit Bot removed the autosubmit Merge PR when tree becomes green via auto submit App label Apr 15, 2026
@auto-submit

auto-submit Bot commented Apr 15, 2026

Copy link
Copy Markdown
Contributor

auto label is removed for flutter/flutter/184546, Failed to enqueue flutter/flutter/184546 with HTTP 400: Pull request Required status check "Merge Queue Guard" is expected..

@loic-sharma
loic-sharma force-pushed the engine_src_path_error branch from 1eae0c8 to b1b9f23 Compare April 15, 2026 21:45
@loic-sharma
loic-sharma requested a review from bkonyi April 16, 2026 17:58
@loic-sharma loic-sharma added the CICD Run CI/CD label Apr 16, 2026
@loic-sharma

Copy link
Copy Markdown
Member Author

@bkonyi Would you mind re-approving? The Merge Queue Guard check was stuck for some reason 👀

bkonyi
bkonyi previously approved these changes Apr 16, 2026

@bkonyi bkonyi left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Lots of infra fun today! LGTM!

@loic-sharma
loic-sharma force-pushed the engine_src_path_error branch from b1b9f23 to ab7a563 Compare April 17, 2026 17:08
@github-actions github-actions Bot removed the CICD Run CI/CD label Apr 17, 2026
@loic-sharma loic-sharma added the CICD Run CI/CD label Apr 17, 2026
@github-actions github-actions Bot removed the CICD Run CI/CD label Apr 17, 2026
@loic-sharma loic-sharma added the CICD Run CI/CD label Apr 17, 2026
@github-actions github-actions Bot removed the CICD Run CI/CD label Apr 20, 2026
@loic-sharma loic-sharma added CICD Run CI/CD autosubmit Merge PR when tree becomes green via auto submit App labels Apr 20, 2026
@auto-submit auto-submit Bot removed the autosubmit Merge PR when tree becomes green via auto submit App label Apr 21, 2026
@auto-submit

auto-submit Bot commented Apr 21, 2026

Copy link
Copy Markdown
Contributor

auto label is removed for flutter/flutter/184546, Failed to enqueue flutter/flutter/184546 with HTTP 400: Pull request New changes require approval from someone other than the last pusher..

@bkonyi bkonyi added the autosubmit Merge PR when tree becomes green via auto submit App label Apr 21, 2026
@auto-submit
auto-submit Bot added this pull request to the merge queue Apr 21, 2026
Merged via the queue into flutter:master with commit a28da9a Apr 21, 2026
173 checks passed
@flutter-dashboard flutter-dashboard Bot removed the autosubmit Merge PR when tree becomes green via auto submit App label Apr 21, 2026
auto-submit Bot pushed a commit to flutter/packages that referenced this pull request Apr 23, 2026
flutter/flutter@3d0e822...5e4f169

2026-04-22 [email protected] Roll Skia from f12c89580766 to 11640d1cbc5c (3 revisions) (flutter/flutter#185418)
2026-04-22 [email protected] Roll Packages from 7c8e13e to 4a2091d (2 revisions) (flutter/flutter#185417)
2026-04-22 [email protected] Roll Skia from f765937d0639 to f12c89580766 (1 revision) (flutter/flutter#185410)
2026-04-22 [email protected] Roll Skia from 635b78342e75 to f765937d0639 (1 revision) (flutter/flutter#185406)
2026-04-22 [email protected] Roll Skia from cda2af3f5c2e to 635b78342e75 (3 revisions) (flutter/flutter#185393)
2026-04-22 [email protected] Roll Skia from 632a41e2baba to cda2af3f5c2e (3 revisions) (flutter/flutter#185390)
2026-04-22 [email protected] Roll Skia from 019de7776cfa to 632a41e2baba (3 revisions) (flutter/flutter#185383)
2026-04-22 98614782+auto-submit[bot]@users.noreply.github.com Reverts "Update libimobiledevice and dependencies (#181932)" (flutter/flutter#185385)
2026-04-22 [email protected] Fix SelectableRegion crash when the selection starts in a scrollable child but does not select anything initially (flutter/flutter#184420)
2026-04-21 [email protected] Fix timeout when `hybrid_android_views` fails `MotionEvent recomposition` (flutter/flutter#185003)
2026-04-21 [email protected] [flutter] Remove dead check on null being in a set of non-nullables (flutter/flutter#184100)
2026-04-21 [email protected] Update the text input triage process to route to platform teams (flutter/flutter#185225)
2026-04-21 [email protected] Compatibility bridge for analyzer 12 and 13. (flutter/flutter#185360)
2026-04-21 [email protected] new_gallery_macos_impeller__transition_perf out of bringup (flutter/flutter#185355)
2026-04-21 [email protected] Roll Skia from 21789d5e2fee to 019de7776cfa (9 revisions) (flutter/flutter#185365)
2026-04-21 [email protected] Update libimobiledevice and dependencies (flutter/flutter#181932)
2026-04-21 [email protected] platform_view_macos_impeller__start_up out of bringup (flutter/flutter#185354)
2026-04-21 [email protected] complex_layout_scroll_perf_macos_impeller__timeline_summary out of bringup (flutter/flutter#185356)
2026-04-21 [email protected] Roll Fuchsia Linux SDK from LPa7NLiXEZP2A7IwZ... to UdpQnaP5eSaDZd3-i... (flutter/flutter#185359)
2026-04-21 [email protected] Roll Packages from 01c505f to 7c8e13e (4 revisions) (flutter/flutter#185361)
2026-04-21 [email protected] Improve the error if the tool cannot find the locally built engine (flutter/flutter#184546)
2026-04-21 [email protected] Roll Skia from a234f0ed7245 to 21789d5e2fee (1 revision) (flutter/flutter#185349)
2026-04-21 [email protected] Replace IndexedStack visibility children with _VisibilityScope + ExcludeFocus (flutter/flutter#184884)
2026-04-21 [email protected] [data_assets] Try fix #184505 (flutter/flutter#185330)

If this roll has caused a breakage, revert this CL and stop the roller
using the controls here:
https://autoroll.skia.org/r/flutter-packages
Please CC [email protected] on the revert to ensure that a human
is aware of the problem.

To file a bug in Packages: https://github.com/flutter/flutter/issues/new/choose

To report a problem with the AutoRoller itself, please file a bug:
https://issues.skia.org/issues/new?component=1389291&template=1850622

Documentation for the AutoRoller is here:
https://skia.googlesource.com/buildbot/+doc/main/autoroll/README.md
creatorpiyush pushed a commit to creatorpiyush/packages that referenced this pull request Jun 10, 2026
…r#11565)

flutter/flutter@3d0e822...5e4f169

2026-04-22 [email protected] Roll Skia from f12c89580766 to 11640d1cbc5c (3 revisions) (flutter/flutter#185418)
2026-04-22 [email protected] Roll Packages from 7c8e13e to 4a2091d (2 revisions) (flutter/flutter#185417)
2026-04-22 [email protected] Roll Skia from f765937d0639 to f12c89580766 (1 revision) (flutter/flutter#185410)
2026-04-22 [email protected] Roll Skia from 635b78342e75 to f765937d0639 (1 revision) (flutter/flutter#185406)
2026-04-22 [email protected] Roll Skia from cda2af3f5c2e to 635b78342e75 (3 revisions) (flutter/flutter#185393)
2026-04-22 [email protected] Roll Skia from 632a41e2baba to cda2af3f5c2e (3 revisions) (flutter/flutter#185390)
2026-04-22 [email protected] Roll Skia from 019de7776cfa to 632a41e2baba (3 revisions) (flutter/flutter#185383)
2026-04-22 98614782+auto-submit[bot]@users.noreply.github.com Reverts "Update libimobiledevice and dependencies (#181932)" (flutter/flutter#185385)
2026-04-22 [email protected] Fix SelectableRegion crash when the selection starts in a scrollable child but does not select anything initially (flutter/flutter#184420)
2026-04-21 [email protected] Fix timeout when `hybrid_android_views` fails `MotionEvent recomposition` (flutter/flutter#185003)
2026-04-21 [email protected] [flutter] Remove dead check on null being in a set of non-nullables (flutter/flutter#184100)
2026-04-21 [email protected] Update the text input triage process to route to platform teams (flutter/flutter#185225)
2026-04-21 [email protected] Compatibility bridge for analyzer 12 and 13. (flutter/flutter#185360)
2026-04-21 [email protected] new_gallery_macos_impeller__transition_perf out of bringup (flutter/flutter#185355)
2026-04-21 [email protected] Roll Skia from 21789d5e2fee to 019de7776cfa (9 revisions) (flutter/flutter#185365)
2026-04-21 [email protected] Update libimobiledevice and dependencies (flutter/flutter#181932)
2026-04-21 [email protected] platform_view_macos_impeller__start_up out of bringup (flutter/flutter#185354)
2026-04-21 [email protected] complex_layout_scroll_perf_macos_impeller__timeline_summary out of bringup (flutter/flutter#185356)
2026-04-21 [email protected] Roll Fuchsia Linux SDK from LPa7NLiXEZP2A7IwZ... to UdpQnaP5eSaDZd3-i... (flutter/flutter#185359)
2026-04-21 [email protected] Roll Packages from 01c505f to 7c8e13e (4 revisions) (flutter/flutter#185361)
2026-04-21 [email protected] Improve the error if the tool cannot find the locally built engine (flutter/flutter#184546)
2026-04-21 [email protected] Roll Skia from a234f0ed7245 to 21789d5e2fee (1 revision) (flutter/flutter#185349)
2026-04-21 [email protected] Replace IndexedStack visibility children with _VisibilityScope + ExcludeFocus (flutter/flutter#184884)
2026-04-21 [email protected] [data_assets] Try fix #184505 (flutter/flutter#185330)

If this roll has caused a breakage, revert this CL and stop the roller
using the controls here:
https://autoroll.skia.org/r/flutter-packages
Please CC [email protected] on the revert to ensure that a human
is aware of the problem.

To file a bug in Packages: https://github.com/flutter/flutter/issues/new/choose

To report a problem with the AutoRoller itself, please file a bug:
https://issues.skia.org/issues/new?component=1389291&template=1850622

Documentation for the AutoRoller is here:
https://skia.googlesource.com/buildbot/+doc/main/autoroll/README.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CICD Run CI/CD tool Affects the "flutter" command-line tool. See also t: labels.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants