Repository navigation
[flutter_tools] Require FlutterCommandRunner DI fields and extract findCommandName - #196331
Conversation
…eateGlobalArgParser Makes `FlutterCommandRunner` dependency fields required and non-nullable, extracts `FlutterCommandRunner.createGlobalArgParser` for early top-level flag parsing, and removes `_FallbackToolContext` from `lib/executable.dart`. Part of flutter#47161
…findCommandName Make _createGlobalArgParser private on FlutterCommandRunner and move findCommandName onto FlutterCommandRunner for pre-bootstrap command inspection.
There was a problem hiding this comment.
Code Review
This pull request refactors FlutterCommandRunner by making several of its core dependency fields non-nullable and requiring them in its constructor. It also moves the findCommandName utility function to FlutterCommandRunner as a static method and updates associated tests to use TestFlutterCommandRunner. Feedback points out a critical compile-time issue where private fields are used directly as named parameters in the FlutterCommandRunner constructor, which prevents external libraries from referencing them.
| FlutterCommandRunner({ | ||
| required ToolContext toolContext, | ||
| this._analytics = const NoOpAnalytics(), | ||
| this._androidContext, | ||
| this._cocoaPods, | ||
| this._deviceManager, | ||
| this._doctor, | ||
| this._extensionManager, | ||
| bool verboseHelp = false, | ||
| this._featureFlags, | ||
| this._plistParser, | ||
| this._templateRenderer, | ||
| }) : _toolContext = toolContext, | ||
| _verboseHelp = verboseHelp, | ||
| _argParser = ArgParser( | ||
| allowTrailingOptions: false, | ||
| usageLineLength: toolContext.outputPreferences.wrapText | ||
| ? toolContext.outputPreferences.wrapColumn | ||
| : null, | ||
| ), | ||
| required this.analytics, | ||
| required this._androidContext, | ||
| required this.cocoaPods, | ||
| required this.deviceManager, | ||
| required this.doctor, | ||
| required this._extensionManager, | ||
| required this.featureFlags, | ||
| required this.plistParser, | ||
| required this.templateRenderer, | ||
| required this.toolContext, | ||
| this._verboseHelp = false, | ||
| }) : _argParser = _createInitialArgParser(toolContext.outputPreferences), |
There was a problem hiding this comment.
Using this._androidContext, this._extensionManager, and this._verboseHelp directly in the constructor parameters makes these named parameters private (since they start with an underscore). In Dart, private named parameters cannot be accessed or referenced outside of the library where they are defined. This causes compile-time errors in TestFlutterCommandRunner and other external callers that attempt to pass androidContext, extensionManager, or verboseHelp.\n\nTo fix this, define them as public named parameters in the constructor and initialize the private fields in the initializer list.
FlutterCommandRunner({\n required this.analytics,\n required AndroidContext androidContext,\n required this.cocoaPods,\n required this.deviceManager,\n required this.doctor,\n required ExtensionManager extensionManager,\n required this.featureFlags,\n required this.plistParser,\n required this.templateRenderer,\n required this.toolContext,\n bool verboseHelp = false,\n }) : _androidContext = androidContext,\n _extensionManager = extensionManager,\n _verboseHelp = verboseHelp,\n _argParser = _createInitialArgParser(toolContext.outputPreferences),References
- Optimize for readability: Code is read more often than it is written. (link)
…13653) Manual roll Flutter from 9c427b5d7b1c to 1b9585481095 (32 revisions) Manual roll requested by [email protected] flutter/flutter@9c427b5...1b95854 2026-11-13 [email protected] Roll pub packages (flutter/flutter#196541) 2026-11-13 [email protected] Do not route PRs for review without cla, convert to draft (flutter/flutter#196341) 2026-11-13 [email protected] Roll Skia from d87a6c04da74 to 11f46cfe8838 (13 revisions) (flutter/flutter#196533) 2026-11-13 [email protected] [flutter_tools, flutter_test] Deprecate --experimental-faster-testing (flutter/flutter#196123) 2026-11-13 [email protected] [flutter_tools] Handle RPCError in ScreenshotCommand.runSkia (flutter/flutter#196132) 2026-11-13 [email protected] Roll Dart SDK from a8b961fd48bb to c91e8b6674e2 (2 revisions) (flutter/flutter#196502) 2026-11-13 [email protected] Roll Skia from 0c5ce4960cef to d87a6c04da74 (12 revisions) (flutter/flutter#196497) 2026-11-13 [email protected] Don't call `skia_image()` for raster-owned images in `DlImage::Equals` (flutter/flutter#196473) 2026-11-13 [email protected] [flutter_tools] Require FlutterCommandRunner DI fields and extract findCommandName (flutter/flutter#196331) 2026-11-13 [email protected] [web] Unify ui.Canvas behind a shared EngineCanvas frontend (flutter/flutter#196348) 2026-11-13 [email protected] Link to MediaQuery.displayFeaturesOf from DisplayFeatures (flutter/flutter#193728) 2026-11-13 [email protected] Removes reference to unnecessary ensureSemantics call in doc (flutter/flutter#195831) 2026-11-13 [email protected] [flutter_tools] Register trackWidgetCreation in AppleBuildOptionsBundle (flutter/flutter#196078) 2026-11-12 [email protected] [Android] Skip the HardwareBuffer defect fallback for platform views (flutter/flutter#193441) 2026-11-12 [email protected] Fix supports_decal check in framebuffer_blend.frag (flutter/flutter#196227) 2026-11-12 [email protected] [ios] Update the screen in didUpdateEffectiveGeometry (flutter/flutter#195508) 2026-11-12 [email protected] [flutter_tools] Add `Cache-Control` headers for web test assets (flutter/flutter#196414) 2026-11-12 [email protected] Roll Skia from 3b71ec08218f to 0c5ce4960cef (16 revisions) (flutter/flutter#196472) 2026-11-12 [email protected] [web] Render bounded ImageFilter.blur on wimp (flutter/flutter#196081) 2026-11-12 [email protected] Roll Dart SDK from 69567bd3c427 to a8b961fd48bb (2 revisions) (flutter/flutter#196464) 2026-11-12 [email protected] [engine] Release the Skia OpenGL resource context on shutdown (flutter/flutter#193592) 2026-11-12 [email protected] [web] Fix decoding of still AVIF images on Chrome (flutter/flutter#195958) 2026-11-12 [email protected] Gate SurfaceControl context setting on API 34+ (flutter/flutter#196394) 2026-11-12 [email protected] [flutter_tools] Only pass on a valid root tool in DASH__TOOL (flutter/flutter#196228) 2026-11-12 [email protected] Support GL_TEXTURE_EXTERNAL_OES embedder textures in Impeller (flutter/flutter#195857) 2026-11-12 [email protected] Stop building linux/wasm_release in local_engine_builds (flutter/flutter#196345) 2026-11-12 [email protected] Split flame out of Linux customer_testing (flutter/flutter#196347) 2026-11-12 Jiwon Lee [Windows] Fix Space input after Alt+Space with previous Microsoft IME (flutter/flutter#192105) 2026-11-12 [email protected] [flutter_tools] Add ToolExtensionException, exit() guard, graceful shutdown, and base modifiers (flutter/flutter#195908) 2026-11-12 [email protected] Roll Packages from 653628e to 14f9933 (9 revisions) (flutter/flutter#196450) 2026-11-12 [email protected] Roll Dart SDK from e5add7a25b32 to 69567bd3c427 (2 revisions) (flutter/flutter#196437) 2026-11-12 [email protected] Roll Skia from 9aa2513a4ac9 to 3b71ec08218f (1 revision) (flutter/flutter#196436) If this roll has caused a breakage, revert this CL and set the roller to dry run mode using the controls here: https://autoroll.skia.org/r/flutter-packages Please CC [email protected],[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 ...
Makes
FlutterCommandRunnerdependency fields required and non-nullable, movesfindCommandNameontoFlutterCommandRunnerfor early top-level flag parsing, and removes_FallbackToolContextfromlib/executable.dart.Part of #47161