From 1b4cd80e000532f3f4c41d33f7dfad097d220aac Mon Sep 17 00:00:00 2001 From: Luan Nico Date: Mon, 3 Aug 2026 08:45:39 -0400 Subject: [PATCH 1/3] refactor!: Clean up deprecated MultiDragDispatcher / MultiDragDispatcherKey aliases --- doc/flame/migration.md | 17 +++++++++++++++++ packages/flame/lib/events.dart | 2 -- packages/flame/lib/src/events/deprecated.dart | 7 ------- 3 files changed, 17 insertions(+), 9 deletions(-) delete mode 100644 packages/flame/lib/src/events/deprecated.dart diff --git a/doc/flame/migration.md b/doc/flame/migration.md index e0047302499..eae1c88b9cf 100644 --- a/doc/flame/migration.md +++ b/doc/flame/migration.md @@ -7,6 +7,23 @@ major versions of Flame, together with the steps required to migrate your code. ## Migrating from v1.38.0 to v2.0.0 +### `MultiDragDispatcher` removed + +The deprecated `MultiDragDispatcher` and `MultiDragDispatcherKey` aliases have been removed. Use +`MultiDragScaleDispatcher` and `MultiDragScaleDispatcherKey` instead, if you were using them +directly at all (normally you should just use the mixins). + +```dart +// Before +game.findByKey(const MultiDragDispatcherKey()) + as MultiDragDispatcher?; + +// After +game.findByKey(const MultiDragScaleDispatcherKey()) + as MultiDragScaleDispatcher?; +``` + + ### `GameWidget.controlled` renamed to `GameWidget.managed` The `GameWidget.controlled` constructor has been renamed to `GameWidget.managed`. The behavior is diff --git a/packages/flame/lib/events.dart b/packages/flame/lib/events.dart index 4e7878f6a3a..8ab167f20cb 100644 --- a/packages/flame/lib/events.dart +++ b/packages/flame/lib/events.dart @@ -11,8 +11,6 @@ export 'src/events/callbacks/secondary_tap_callbacks.dart' export 'src/events/callbacks/tap_callbacks.dart' show TapCallbacks; export 'src/events/callbacks/tertiary_tap_callbacks.dart' show TertiaryTapCallbacks; -export 'src/events/deprecated.dart' - show MultiDragDispatcher, MultiDragDispatcherKey; export 'src/events/dispatchers/dispatcher.dart' show Dispatcher; export 'src/events/dispatchers/double_tap_dispatcher.dart' show DoubleTapDispatcher, DoubleTapDispatcherKey; diff --git a/packages/flame/lib/src/events/deprecated.dart b/packages/flame/lib/src/events/deprecated.dart deleted file mode 100644 index c2f4628ebc9..00000000000 --- a/packages/flame/lib/src/events/deprecated.dart +++ /dev/null @@ -1,7 +0,0 @@ -import 'package:flame/src/events/dispatchers/multi_drag_scale_dispatcher.dart'; - -@Deprecated('Use MultiDragScaleDispatcher instead.') -typedef MultiDragDispatcher = MultiDragScaleDispatcher; - -@Deprecated('Use MultiDragScaleDispatcherKey instead.') -typedef MultiDragDispatcherKey = MultiDragScaleDispatcherKey; From 94ef16763d6389a6e95be9b328af260ffc147660 Mon Sep 17 00:00:00 2001 From: Luan Nico Date: Mon, 3 Aug 2026 10:35:19 -0400 Subject: [PATCH 2/3] Apply suggestion from @luanpotter --- doc/flame/migration.md | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/flame/migration.md b/doc/flame/migration.md index 14fe3f86143..5f92ec55a9d 100644 --- a/doc/flame/migration.md +++ b/doc/flame/migration.md @@ -74,6 +74,7 @@ If you were using `handled` to let an event reach several components, set The equivalent field on the deprecated `*Info` event classes (`TapDownInfo.handled` and friends) has been removed as well. + ### `GameWidget.controlled` renamed to `GameWidget.managed` The `GameWidget.controlled` constructor has been renamed to `GameWidget.managed`. The behavior is From b3bba95e688d607191f547460110608454773256 Mon Sep 17 00:00:00 2001 From: Luan Nico Date: Mon, 3 Aug 2026 10:52:57 -0400 Subject: [PATCH 3/3] Apply suggestion from @luanpotter --- doc/flame/migration.md | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/flame/migration.md b/doc/flame/migration.md index 5f92ec55a9d..63bf2be1315 100644 --- a/doc/flame/migration.md +++ b/doc/flame/migration.md @@ -23,6 +23,7 @@ game.findByKey(const MultiDragScaleDispatcherKey()) as MultiDragScaleDispatcher?; ``` + ### `Event.handled` removed in favour of `continuePropagation` Events used to carry two independent booleans: `handled`, which Flame never set nor read, and