Flutter build log filtering for native toolchain errors

Native Build Error Surfacing

The flutter build command orchestrates native build systems, specifically Gradle for Android and xcodebuild for iOS. By default, the Flutter CLI filters the output from these toolchains to provide a streamlined experience, often resulting in a generic "Build failed" message when a native-level error occurs, such as a dependency resolution failure or a code signing issue.

While the --verbose flag exposes the full native log, this output is often too voluminous for standard debugging. There is an unresolved design tension between maintaining a clean CLI output and providing immediate, actionable native errors without requiring the user to switch to verbose mode or execute native build commands manually in platform-specific directories.

For Flutter versions 3.19 and later, what is the intended behavior for surfacing critical native errors in the default output stream? Is there a configuration to enable selective error surfacing from Gradle or Xcode without triggering full verbose logging?