flutter · mattkae · Mar 5, 2026 · Feb 2, 2026 · Feb 2, 2026 · Feb 2, 2026
diff --git a/examples/api/lib/widgets/windows/window_manager.0.dart b/examples/api/lib/widgets/windows/window_manager.0.dart
@@ -0,0 +1,111 @@
+// Copyright 2014 The Flutter Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+// TODO(mattkae): remove invalid_use_of_internal_member ignore comment when this API is stable.
+// See: https://github.com/flutter/flutter/issues/177586
+// ignore_for_file: invalid_use_of_internal_member
+// ignore_for_file: implementation_imports
+import 'package:flutter/widgets.dart';
+import 'package:flutter/src/widgets/_window.dart';
+
+void main() {
+  try {
+    WidgetsFlutterBinding.ensureInitialized();
+    final RegularWindowController controller = RegularWindowController(
+      preferredSize: const Size(800, 600),
+    );
+    runWidget(
+      WindowManager(
+        child: RegularWindow(controller: controller, child: const MainWindow()),
+      ),
+    );
+  } on UnsupportedError catch (e) {
+    // TODO(mattkae): Remove this catch block when windowing is supported in tests.
+    // For now, we need to catch the error so that the API smoke tests pass.
+    runApp(
+      WidgetsApp(
+        color: const Color(0xFFFFFFFF),
+        builder: (BuildContext context, Widget? child) {
+          return Center(
+            child: Text(
+              e.message ?? 'Unsupported',
+              textDirection: TextDirection.ltr,
+            ),
+          );
+        },
+      ),
+    );
+  }
+}
+
+class MainWindow extends StatefulWidget {
+  const MainWindow({super.key});
+
+  @override
+  State<StatefulWidget> createState() => MainWindowState();
+}
+
+class MainWindowState extends State<MainWindow> {
+  WindowEntry? entry;
+
+  void _openDialog(BuildContext context) {
+    final WindowRegistry? registry = WindowRegistry.maybeOf(context);
+    assert(registry != null);
+    entry = WindowEntry(
+      controller: DialogWindowController(
+        parent: WindowScope.of(context),
+        preferredSize: const Size(400, 300),
+        delegate: _DialogWindowControllerDelegate(
+          mainWindow: this,
+          registry: registry!,
+        ),
+      ),
+      builder: (BuildContext context) {
+        return const SizedBox.shrink();
+      },
+    );
+    registry.register(entry!);
+  }
+
+  void closeDialog(WindowRegistry registry) {
+    if (entry != null) {
+      registry.unregister(entry!);
+      entry = null;
+    }
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return WidgetsApp(
+      color: const Color(0xFFFFFFFF),
+      builder: (BuildContext context, Widget? child) {
+        return Center(
+          child: GestureDetector(
+            onTap: () => _openDialog(context),
+            child: const Text(
+              'Open a dialog',
+              textDirection: TextDirection.ltr,
+            ),
+          ),
+        );
+      },
+    );
+  }
+}
+
+class _DialogWindowControllerDelegate extends DialogWindowControllerDelegate {
+  _DialogWindowControllerDelegate({
+    required this.mainWindow,
+    required this.registry,
+  });
+
+  final MainWindowState mainWindow;
+  final WindowRegistry registry;
+
+  @override
+  void onWindowDestroyed() {
+    super.onWindowDestroyed();
+    mainWindow.closeDialog(registry);
+  }
+}
diff --git a/examples/api/test/widgets/windows/window_manager.0_test.dart b/examples/api/test/widgets/windows/window_manager.0_test.dart
@@ -0,0 +1,15 @@
+// Copyright 2014 The Flutter Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+import 'package:flutter_api_samples/widgets/windows/window_manager.0.dart'
+    as example;
+import 'package:flutter_test/flutter_test.dart';
+
+void main() {
+  testWidgets('Calling window_manager main returns normally', (
+    WidgetTester tester,
+  ) async {
+    expect(() => example.main(), returnsNormally);
+  });
+}
diff --git a/examples/multiple_windows/lib/app/dialog_window_content.dart b/examples/multiple_windows/lib/app/dialog_window_content.dart
@@ -17,7 +17,9 @@ class DialogWindowContent extends StatelessWidget {
 
   @override
   Widget build(BuildContext context) {
-    final WindowManager windowManager = WindowManagerAccessor.of(context);
+    final KeyedWindowManager windowManager = KeyedWindowManagerAccessor.of(
+      context,
+    );
     final WindowSettings windowSettings = WindowSettingsAccessor.of(context);
 
     final child = FocusScope(

diff --git a/examples/multiple_windows/lib/app/main_window.dart b/examples/multiple_windows/lib/app/main_window.dart
@@ -24,7 +24,9 @@ class MainWindow extends StatelessWidget {
 
   @override
   Widget build(BuildContext context) {
-    final WindowManager windowManager = WindowManagerAccessor.of(context);
+    final KeyedWindowManager windowManager = KeyedWindowManagerAccessor.of(
+      context,
+    );
 
     return ViewAnchor(
       view: ListenableBuilder(
@@ -81,7 +83,10 @@ class MainWindow extends StatelessWidget {
 }
 
 class _WindowsTable extends StatelessWidget {
-  List<DataRow> _buildRows(WindowManager windowManager, BuildContext context) {
+  List<DataRow> _buildRows(
+    KeyedWindowManager windowManager,
+    BuildContext context,
+  ) {
     List<DataRow> rows = [];
     for (KeyedWindow controller in windowManager.windows) {
       rows.add(
@@ -150,7 +155,9 @@ class _WindowsTable extends StatelessWidget {
 
   @override
   Widget build(BuildContext context) {
-    final WindowManager windowManager = WindowManagerAccessor.of(context);
+    final KeyedWindowManager windowManager = KeyedWindowManagerAccessor.of(
+      context,
+    );
     return DataTable(
       showBottomBorder: true,
       columns: const [
@@ -176,7 +183,9 @@ class _WindowsTable extends StatelessWidget {
 class _WindowCreatorCard extends StatelessWidget {
   @override
   Widget build(BuildContext context) {
-    final WindowManager windowManager = WindowManagerAccessor.of(context);
+    final KeyedWindowManager windowManager = KeyedWindowManagerAccessor.of(
+      context,
+    );
     final WindowSettings windowSettings = WindowSettingsAccessor.of(context);
     final BaseWindowController windowController = WindowScope.of(context);
 

diff --git a/examples/multiple_windows/lib/app/models.dart b/examples/multiple_windows/lib/app/models.dart
@@ -39,8 +39,8 @@ class KeyedWindow {
 /// The window manager manages a flat list of all of the [BaseWindowController]s
 /// that have been created by the application as well as which controller is
 /// currently selected by the UI.
-class WindowManager extends ChangeNotifier {
-  WindowManager({required List<KeyedWindow> initialWindows})
+class KeyedWindowManager extends ChangeNotifier {
+  KeyedWindowManager({required List<KeyedWindow> initialWindows})
     : _windows = initialWindows;
 
   final List<KeyedWindow> _windows;
@@ -61,18 +61,18 @@ class WindowManager extends ChangeNotifier {
   }
 }
 
-/// Provides access to the [WindowManager] from the widget tree.
-class WindowManagerAccessor extends InheritedNotifier<WindowManager> {
-  const WindowManagerAccessor({
+/// Provides access to the [KeyedWindowManager] from the widget tree.
+class KeyedWindowManagerAccessor extends InheritedNotifier<KeyedWindowManager> {
+  const KeyedWindowManagerAccessor({
     super.key,
     required super.child,
-    required WindowManager windowManager,
+    required KeyedWindowManager windowManager,
   }) : super(notifier: windowManager);
 
-  static WindowManager of(BuildContext context) {
-    final WindowManagerAccessor? result = context
-        .dependOnInheritedWidgetOfExactType<WindowManagerAccessor>();
-    assert(result != null, 'No WindowManager found in context');
+  static KeyedWindowManager of(BuildContext context) {
+    final KeyedWindowManagerAccessor? result = context
+        .dependOnInheritedWidgetOfExactType<KeyedWindowManagerAccessor>();
+    assert(result != null, 'No KeyedWindowManager found in context');
     return result!.notifier!;
   }
 }

diff --git a/examples/multiple_windows/lib/app/regular_window_content.dart b/examples/multiple_windows/lib/app/regular_window_content.dart
@@ -34,7 +34,9 @@ class RegularWindowContent extends StatelessWidget {
   Widget build(BuildContext context) {
     final dpr = MediaQuery.of(context).devicePixelRatio;
     final windowSize = WindowScope.contentSizeOf(context);
-    final WindowManager windowManager = WindowManagerAccessor.of(context);
+    final KeyedWindowManager windowManager = KeyedWindowManagerAccessor.of(
+      context,
+    );
     final WindowSettings windowSettings = WindowSettingsAccessor.of(context);
 
     final child = Scaffold(

diff --git a/examples/multiple_windows/lib/app/tooltip_button.dart b/examples/multiple_windows/lib/app/tooltip_button.dart
@@ -109,7 +109,7 @@ class _TooltipButtonState extends State<TooltipButton> {
   }
 
   void _onPressed(
-    final WindowManager windowManager,
+    final KeyedWindowManager windowManager,
     final WindowSettings windowSettings,
   ) {
     // Toggle tooltip visibility.
@@ -159,7 +159,9 @@ class _TooltipButtonState extends State<TooltipButton> {
 
   @override
   Widget build(BuildContext context) {
-    final WindowManager windowManager = WindowManagerAccessor.of(context);
+    final KeyedWindowManager windowManager = KeyedWindowManagerAccessor.of(
+      context,
+    );
     final WindowSettings windowSettings = WindowSettingsAccessor.of(context);
 
     return OutlinedButton(

diff --git a/examples/multiple_windows/lib/main.dart b/examples/multiple_windows/lib/main.dart
@@ -40,12 +40,12 @@ class _MultiWindowAppState extends State<MultiWindowApp> {
     delegate: MainControllerWindowDelegate(),
   );
   final WindowSettings settings = WindowSettings();
-  late final WindowManager windowManager;
+  late final KeyedWindowManager windowManager;
 
   @override
   void initState() {
     super.initState();
-    windowManager = WindowManager(
+    windowManager = KeyedWindowManager(
       initialWindows: <KeyedWindow>[
         KeyedWindow(
           isMainWindow: true,
@@ -68,7 +68,7 @@ class _MultiWindowAppState extends State<MultiWindowApp> {
       controller: controller,
       child: MaterialApp(home: MainWindow(controller: controller)),
     );
-    return WindowManagerAccessor(
+    return KeyedWindowManagerAccessor(
       windowManager: windowManager,
       child: WindowSettingsAccessor(
         windowSettings: settings,