Wish for the flutter tool to help the user switch to USB instead of WiFi when running/debugging against iOS 26

Use case

Due to architectural changes from iOS 26, running/debugging a Flutter app during development against an iOS 26 iPhone connected to the host development machine via WiFi can be quite slow. We've noticed that the latency is felt most when the target device is connected over WiFi.

Proposal

We propose to detect when people are using iOS 26 devices connected via WiFi, and suggest to them to instead use a wired (USB) connection.

We propose to deliver this feedback via the flutter tool, and our IDE plugins. But, this issue specifically is for the flutter tool.

Agreed.

We will need to add a warning to the top of this method:

flutter/packages/flutter_tools/lib/src/ios/devices.dart

Lines 477 to 487 in 3d6b599

    
           Future<LaunchResult> startApp( 
        
             IOSApp package, { 
        
             String? mainPath, 
        
             String? route, 
        
             required DebuggingOptions debuggingOptions, 
        
             Map<String, Object?> platformArgs = const <String, Object?>{}, 
        
             bool prebuiltApplication = false, 
        
             String? userIdentifier, 
        
             @visibleForTesting Duration? discoveryTimeout, 
        
             @visibleForTesting ShutdownHooks? shutdownHooks, 
        
           }) async {

Code would probably be something this

if (isWirelesslyConnected &&
        debuggingOptions.debuggingEnabled && (sdkVersion != null || sdkVersion! >= Version(26, 0, null)) {
 _logger.printWarning(
     `Wireless debugging on iOS 26 may be slow. Consider using a wired connection.` // or something like that
    );
}

I'm not sure if _logger.printWarning already surfaces something when run with --machine, but if not we should try to add something so that this warning can be provided (in a structured way) to the IDEs. That way they could show a more prominent warning than just a line of text in the console output.

@DanTup

@DanTup In the pr #176235 I emitted an event for the warning(see image below as a proposed event detail). If not, please lmk what details you'd like to be included in the event

Could we do this for all wireless-connected devices? We have previously #144634, which is also unresolved.

Add structured warning event for slow wireless debugging on iOS 26+ d… (

Thank you!

[tool/dap] Forward app.warning events from Flutter to DAP client

[tool/dap] Forward app.warning events from Flutter to DAP client (#17…

Add structured warning event for slow wireless debugging on iOS 26+ d… (

[tool/dap] Forward app.warning events from Flutter to DAP client (flu…

This thread has been automatically locked since there has not been any recent activity after it was closed. If you are still experiencing a similar issue, please open a new bug, including the output of flutter doctor -v and a minimal reproduction of the issue.

Add structured warning event for slow wireless debugging on iOS 26+ d… (

Navigation Menu

Repository navigation

Wish for the flutter tool to help the user switch to USB instead of WiFi when running/debugging against iOS 26 #176206

Use case

Proposal

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

	Future<LaunchResult> startApp(
	IOSApp package, {
	String? mainPath,
	String? route,
	required DebuggingOptions debuggingOptions,
	Map<String, Object?> platformArgs = const <String, Object?>{},
	bool prebuiltApplication = false,
	String? userIdentifier,
	@visibleForTesting Duration? discoveryTimeout,
	@visibleForTesting ShutdownHooks? shutdownHooks,
	}) async {

Wish for the flutter tool to help the user switch to USB instead of WiFi when running/debugging against iOS 26 #176206

Description

Use case

Proposal

Activity

vashworth commented on Sep 29, 2025

DanTup commented on Sep 29, 2025

okorohelijah commented on Sep 29, 2025

AlexV525 commented on Sep 30, 2025

sethladd commented on Oct 8, 2025

github-actions commented on Oct 22, 2025

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions