Expose DispatcherExtensions so it could be used outside of Maui as well (#30488)

Vignesh-SF3580 · web-flow · commit b18db8bcfcd2 · 2025-07-28T12:43:25.000+01:00
* updated code changes

* Added UnitTest

* added testcases

* resolved build errors.

* Update PublicAPI.Unshipped.txt

* Update DispatcherExtensions.cs
diff --git a/src/Compatibility/Core/src/Android/CollectionView/ObservableGroupedSource.cs b/src/Compatibility/Core/src/Android/CollectionView/ObservableGroupedSource.cs
@@ -2,6 +2,7 @@
 using System.Collections;
 using System.Collections.Generic;
 using System.Collections.Specialized;
+using Microsoft.Maui.Dispatching;
 
 namespace Microsoft.Maui.Controls.Compatibility.Platform.Android
 {
diff --git a/src/Compatibility/Core/src/Android/CollectionView/ObservableItemsSource.cs b/src/Compatibility/Core/src/Android/CollectionView/ObservableItemsSource.cs
@@ -1,6 +1,7 @@
 using System;
 using System.Collections;
 using System.Collections.Specialized;
+using Microsoft.Maui.Dispatching;
 
 namespace Microsoft.Maui.Controls.Compatibility.Platform.Android
 {
diff --git a/src/Compatibility/Core/src/Windows/ListViewRenderer.cs b/src/Compatibility/Core/src/Windows/ListViewRenderer.cs
@@ -25,6 +25,7 @@
 using WListView = Microsoft.UI.Xaml.Controls.ListView;
 using WRect = Windows.Foundation.Rect;
 using WSelectionChangedEventArgs = Microsoft.UI.Xaml.Controls.SelectionChangedEventArgs;
+using Microsoft.Maui.Dispatching;
 
 namespace Microsoft.Maui.Controls.Compatibility.Platform.UWP
 {
diff --git a/src/Compatibility/Core/src/iOS/VisualElementTracker.cs b/src/Compatibility/Core/src/iOS/VisualElementTracker.cs
@@ -6,6 +6,7 @@
 using Microsoft.Maui.Controls.Internals;
 using Microsoft.Maui.Controls.Platform;
 using Microsoft.Maui.Graphics;
+using Microsoft.Maui.Dispatching;
 
 #if __MOBILE__
 using ObjCRuntime;
diff --git a/src/Controls/src/Core/AppThemeBinding.cs b/src/Controls/src/Core/AppThemeBinding.cs
@@ -3,6 +3,7 @@
 using Microsoft.Maui.ApplicationModel;
 using Microsoft.Maui.Controls.Internals;
 using Microsoft.Maui.Controls.Xaml.Diagnostics;
+using Microsoft.Maui.Dispatching;
 
 namespace Microsoft.Maui.Controls
 {
diff --git a/src/Controls/src/Core/BindingExpression.cs b/src/Controls/src/Core/BindingExpression.cs
@@ -10,6 +10,7 @@
 using System.Runtime.CompilerServices;
 using Microsoft.Maui.Controls.Internals;
 using Microsoft.Maui.Controls.Xaml.Diagnostics;
+using Microsoft.Maui.Dispatching;
 
 namespace Microsoft.Maui.Controls
 {
diff --git a/src/Controls/src/Core/DispatcherExtensions.cs b/src/Controls/src/Core/DispatcherExtensions.cs
@@ -1,5 +1,4 @@
 using System;
-using System.Threading.Tasks;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Maui.Dispatching;
 using Microsoft.Maui.Hosting;
@@ -47,46 +46,6 @@ bindableObject is Element element &&
 			throw new InvalidOperationException("BindableObject was not instantiated on a thread with a dispatcher nor does the current application have a dispatcher.");
 		}
 
-		public static void DispatchIfRequired(this IDispatcher? dispatcher, Action action)
-		{
-			dispatcher = EnsureDispatcher(dispatcher);
-			if (dispatcher.IsDispatchRequired)
-			{
-				dispatcher.Dispatch(action);
-			}
-			else
-			{
-				action();
-			}
-		}
-
-		public static Task DispatchIfRequiredAsync(this IDispatcher? dispatcher, Action action)
-		{
-			dispatcher = EnsureDispatcher(dispatcher);
-			if (dispatcher.IsDispatchRequired)
-			{
-				return dispatcher.DispatchAsync(action);
-			}
-			else
-			{
-				action();
-				return Task.CompletedTask;
-			}
-		}
-
-		public static Task DispatchIfRequiredAsync(this IDispatcher? dispatcher, Func<Task> action)
-		{
-			dispatcher = EnsureDispatcher(dispatcher);
-			if (dispatcher.IsDispatchRequired)
-			{
-				return dispatcher.DispatchAsync(action);
-			}
-			else
-			{
-				return action();
-			}
-		}
-
 		static IDispatcher EnsureDispatcher(IDispatcher? dispatcher)
 		{
 			if (dispatcher is not null)
diff --git a/src/Controls/src/Core/Handlers/Items/Android/ItemsSources/ObservableGroupedSource.cs b/src/Controls/src/Core/Handlers/Items/Android/ItemsSources/ObservableGroupedSource.cs
@@ -3,6 +3,7 @@
 using System.Collections;
 using System.Collections.Generic;
 using System.Collections.Specialized;
+using Microsoft.Maui.Dispatching;
 
 namespace Microsoft.Maui.Controls.Handlers.Items
 {
diff --git a/src/Controls/src/Core/Handlers/Items/Android/ItemsSources/ObservableItemsSource.cs b/src/Controls/src/Core/Handlers/Items/Android/ItemsSources/ObservableItemsSource.cs
@@ -2,6 +2,7 @@
 using System;
 using System.Collections;
 using System.Collections.Specialized;
+using Microsoft.Maui.Dispatching;
 
 namespace Microsoft.Maui.Controls.Handlers.Items
 {
diff --git a/src/Controls/src/Core/Platform/Windows/CollectionView/GroupedItemTemplateCollection.cs b/src/Controls/src/Core/Platform/Windows/CollectionView/GroupedItemTemplateCollection.cs
@@ -3,6 +3,7 @@
 using System.Collections;
 using System.Collections.ObjectModel;
 using System.Collections.Specialized;
+using Microsoft.Maui.Dispatching;
 
 namespace Microsoft.Maui.Controls.Platform
 {
diff --git a/src/Controls/src/Core/Platform/Windows/CollectionView/ObservableItemTemplateCollection.cs b/src/Controls/src/Core/Platform/Windows/CollectionView/ObservableItemTemplateCollection.cs
@@ -4,6 +4,7 @@
 using System.Collections.ObjectModel;
 using System.Collections.Specialized;
 using System.Threading;
+using Microsoft.Maui.Dispatching;
 
 namespace Microsoft.Maui.Controls.Platform
 {
diff --git a/src/Core/src/Dispatching/DispatcherExtensions.cs b/src/Core/src/Dispatching/DispatcherExtensions.cs
@@ -89,6 +89,90 @@ public static Task DispatchAsync(this IDispatcher dispatcher, Func<Task> funcTas
 				return true;
 			});
 
+		/// <summary>
+		/// Schedules the provided action on the UI thread from a worker thread if the current thread is not the UI thread. If the current thread is the UI thread, then the action is executed immediately.
+		/// </summary>
+		/// <param name="dispatcher">The <see cref="IDispatcher"/> instance this method is called on.</param>
+		/// <param name="action">The <see cref="Action"/> to be scheduled for processing on the UI thread.</param>
+		public static void DispatchIfRequired(this IDispatcher dispatcher, Action action)
+		{
+			if (dispatcher?.IsDispatchRequired == true)
+			{
+				dispatcher.Dispatch(action);
+				return;
+			}
+
+			if (dispatcher is null)
+			{
+				var currentThreadDispatcher = Dispatcher.GetForCurrentThread();
+				if (currentThreadDispatcher?.IsDispatchRequired == true)
+				{
+					currentThreadDispatcher.Dispatch(action);
+					return;
+				}
+			}
+
+			action();
+		}
+
+		/// <summary>
+		/// Checks if a dispatch is required. If a dispatch is required, the provided action will be executed on the UI thread.
+		/// </summary>
+		/// <param name="dispatcher"></param>
+		/// <param name="action"></param>
+		/// <returns></returns>
+		public static Task DispatchIfRequiredAsync(this IDispatcher dispatcher, Action action)
+		{
+			if (dispatcher.IsDispatchRequired)
+			{
+				return dispatcher.DispatchAsync(action);
+			}
+
+			action();
+			return Task.CompletedTask;
+		}
+
+		/// <summary>
+		/// Checks if a dispatch is required. If a dispatch is required, the provided function will be executed on the UI thread.
+		/// </summary>
+		/// <param name="dispatcher"></param>
+		/// <param name="action"></param>
+		/// <returns></returns>
+		public static Task DispatchIfRequiredAsync(this IDispatcher dispatcher, Func<Task> action)
+		{
+			return dispatcher.IsDispatchRequired
+				? dispatcher.DispatchAsync(action)
+				: action();
+		}
+
+		/// <summary>
+		/// Checks if a dispatch is required. If a dispatch is required, the provided function will be executed on the UI thread.
+		/// </summary>
+		/// <typeparam name="T">The type returned from the function.</typeparam>
+		/// <param name="dispatcher">The <see cref="IDispatcher"/> instance this method is called on.</param>
+		/// <param name="func">The function to be executed by the dispatcher.</param>
+		/// <returns>A <see cref="Task{TResult}"/> object containing the result of the function.</returns>
+		public static Task<T> DispatchIfRequiredAsync<T>(this IDispatcher dispatcher, Func<T> func)
+		{
+			return dispatcher.IsDispatchRequired
+				? dispatcher.DispatchAsync(func)
+				: Task.FromResult(func());
+		}
+
+		/// <summary>
+		/// Checks if a dispatch is required. If a dispatch is required, the provided function will be executed on the UI thread.
+		/// </summary>
+		/// <typeparam name="T">The type returned from the function.</typeparam>
+		/// <param name="dispatcher">The <see cref="IDispatcher"/> instance this method is called on.</param>
+		/// <param name="funcTask">The function to be executed by the dispatcher.</param>
+		/// <returns>A <see cref="Task{TResult}"/> object containing the result of the function.</returns>
+		public static Task<T> DispatchIfRequiredAsync<T>(this IDispatcher dispatcher, Func<Task<T>> funcTask)
+		{
+			return dispatcher.IsDispatchRequired
+				? dispatcher.DispatchAsync(funcTask)
+				: funcTask();
+		}
+
 		/// <summary>
 		/// Gets the synchronization context for the current thread.
 		/// </summary>
diff --git a/src/Core/src/PublicAPI/net-android/PublicAPI.Unshipped.txt b/src/Core/src/PublicAPI/net-android/PublicAPI.Unshipped.txt
@@ -186,6 +186,11 @@ static Microsoft.Maui.Platform.ButtonExtensions.UpdateRippleColor(this Google.An
 static Microsoft.Maui.Platform.EditTextExtensions.GetCursorPosition(this Android.Widget.EditText! editText, int cursorOffset = 0) -> int
 static Microsoft.Maui.Platform.EditTextExtensions.GetSelectedTextLength(this Android.Widget.EditText! editText) -> int
 static Microsoft.Maui.Platform.EditTextExtensions.UpdateClearButtonVisibility(this Android.Widget.EditText! editText, Microsoft.Maui.IEntry! entry) -> void
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequired(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Action! action) -> void
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequiredAsync(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Action! action) -> System.Threading.Tasks.Task!
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequiredAsync(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Func<System.Threading.Tasks.Task!>! action) -> System.Threading.Tasks.Task!
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequiredAsync<T>(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Func<T>! func) -> System.Threading.Tasks.Task<T>!
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequiredAsync<T>(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Func<System.Threading.Tasks.Task<T>!>! funcTask) -> System.Threading.Tasks.Task<T>!
 *REMOVED*static Microsoft.Maui.Platform.EditTextExtensions.UpdateClearButtonVisibility(this Android.Widget.EditText! editText, Microsoft.Maui.IEntry! entry, Android.Graphics.Drawables.Drawable? clearButtonDrawable) -> void
 *REMOVED*static Microsoft.Maui.Platform.EditTextExtensions.UpdateClearButtonVisibility(this Android.Widget.EditText! editText, Microsoft.Maui.IEntry! entry, System.Func<Android.Graphics.Drawables.Drawable?>? getClearButtonDrawable) -> void
 static Microsoft.Maui.Platform.ImageButtonExtensions.UpdateBackground(this Google.Android.Material.ImageView.ShapeableImageView! platformButton, Microsoft.Maui.IImageButton! imageButton) -> void
diff --git a/src/Core/src/PublicAPI/net-ios/PublicAPI.Unshipped.txt b/src/Core/src/PublicAPI/net-ios/PublicAPI.Unshipped.txt
@@ -182,6 +182,11 @@ static Microsoft.Maui.SwipeViewSwipeEnded.operator !=(Microsoft.Maui.SwipeViewSw
 static Microsoft.Maui.SwipeViewSwipeEnded.operator ==(Microsoft.Maui.SwipeViewSwipeEnded? left, Microsoft.Maui.SwipeViewSwipeEnded? right) -> bool
 static Microsoft.Maui.SwipeViewSwipeStarted.operator !=(Microsoft.Maui.SwipeViewSwipeStarted? left, Microsoft.Maui.SwipeViewSwipeStarted? right) -> bool
 static Microsoft.Maui.SwipeViewSwipeStarted.operator ==(Microsoft.Maui.SwipeViewSwipeStarted? left, Microsoft.Maui.SwipeViewSwipeStarted? right) -> bool
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequired(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Action! action) -> void
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequiredAsync(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Action! action) -> System.Threading.Tasks.Task!
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequiredAsync(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Func<System.Threading.Tasks.Task!>! action) -> System.Threading.Tasks.Task!
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequiredAsync<T>(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Func<T>! func) -> System.Threading.Tasks.Task<T>!
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequiredAsync<T>(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Func<System.Threading.Tasks.Task<T>!>! funcTask) -> System.Threading.Tasks.Task<T>!
 virtual Microsoft.Maui.Animations.Lerp.LerpDelegate.Invoke(object! start, object! end, double progress) -> object!
 virtual Microsoft.Maui.Handlers.ContextFlyoutItemHandlerUpdate.<Clone>$() -> Microsoft.Maui.Handlers.ContextFlyoutItemHandlerUpdate!
 virtual Microsoft.Maui.Handlers.ContextFlyoutItemHandlerUpdate.EqualityContract.get -> System.Type!
diff --git a/src/Core/src/PublicAPI/net-maccatalyst/PublicAPI.Unshipped.txt b/src/Core/src/PublicAPI/net-maccatalyst/PublicAPI.Unshipped.txt
@@ -185,6 +185,11 @@ static Microsoft.Maui.SwipeViewSwipeEnded.operator !=(Microsoft.Maui.SwipeViewSw
 static Microsoft.Maui.SwipeViewSwipeEnded.operator ==(Microsoft.Maui.SwipeViewSwipeEnded? left, Microsoft.Maui.SwipeViewSwipeEnded? right) -> bool
 static Microsoft.Maui.SwipeViewSwipeStarted.operator !=(Microsoft.Maui.SwipeViewSwipeStarted? left, Microsoft.Maui.SwipeViewSwipeStarted? right) -> bool
 static Microsoft.Maui.SwipeViewSwipeStarted.operator ==(Microsoft.Maui.SwipeViewSwipeStarted? left, Microsoft.Maui.SwipeViewSwipeStarted? right) -> bool
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequired(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Action! action) -> void
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequiredAsync(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Action! action) -> System.Threading.Tasks.Task!
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequiredAsync(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Func<System.Threading.Tasks.Task!>! action) -> System.Threading.Tasks.Task!
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequiredAsync<T>(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Func<T>! func) -> System.Threading.Tasks.Task<T>!
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequiredAsync<T>(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Func<System.Threading.Tasks.Task<T>!>! funcTask) -> System.Threading.Tasks.Task<T>!
 virtual Microsoft.Maui.Animations.Lerp.LerpDelegate.Invoke(object! start, object! end, double progress) -> object!
 virtual Microsoft.Maui.Handlers.ContextFlyoutItemHandlerUpdate.<Clone>$() -> Microsoft.Maui.Handlers.ContextFlyoutItemHandlerUpdate!
 virtual Microsoft.Maui.Handlers.ContextFlyoutItemHandlerUpdate.EqualityContract.get -> System.Type!
diff --git a/src/Core/src/PublicAPI/net-tizen/PublicAPI.Unshipped.txt b/src/Core/src/PublicAPI/net-tizen/PublicAPI.Unshipped.txt
@@ -152,6 +152,11 @@ static Microsoft.Maui.SwipeViewSwipeEnded.operator !=(Microsoft.Maui.SwipeViewSw
 static Microsoft.Maui.SwipeViewSwipeEnded.operator ==(Microsoft.Maui.SwipeViewSwipeEnded? left, Microsoft.Maui.SwipeViewSwipeEnded? right) -> bool
 static Microsoft.Maui.SwipeViewSwipeStarted.operator !=(Microsoft.Maui.SwipeViewSwipeStarted? left, Microsoft.Maui.SwipeViewSwipeStarted? right) -> bool
 static Microsoft.Maui.SwipeViewSwipeStarted.operator ==(Microsoft.Maui.SwipeViewSwipeStarted? left, Microsoft.Maui.SwipeViewSwipeStarted? right) -> bool
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequired(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Action! action) -> void
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequiredAsync(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Action! action) -> System.Threading.Tasks.Task!
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequiredAsync(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Func<System.Threading.Tasks.Task!>! action) -> System.Threading.Tasks.Task!
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequiredAsync<T>(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Func<T>! func) -> System.Threading.Tasks.Task<T>!
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequiredAsync<T>(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Func<System.Threading.Tasks.Task<T>!>! funcTask) -> System.Threading.Tasks.Task<T>!
 virtual Microsoft.Maui.Animations.Lerp.LerpDelegate.Invoke(object! start, object! end, double progress) -> object!
 virtual Microsoft.Maui.Handlers.ContextFlyoutItemHandlerUpdate.<Clone>$() -> Microsoft.Maui.Handlers.ContextFlyoutItemHandlerUpdate!
 virtual Microsoft.Maui.Handlers.ContextFlyoutItemHandlerUpdate.EqualityContract.get -> System.Type!
diff --git a/src/Core/src/PublicAPI/net-windows/PublicAPI.Unshipped.txt b/src/Core/src/PublicAPI/net-windows/PublicAPI.Unshipped.txt
@@ -158,6 +158,11 @@ static Microsoft.Maui.Handlers.WindowHandler.MapIsMinimizable(Microsoft.Maui.Han
 static Microsoft.Maui.Hosting.AppHostBuilderExtensions.ConfigureEnvironmentVariables(this Microsoft.Maui.Hosting.MauiAppBuilder! builder) -> Microsoft.Maui.Hosting.MauiAppBuilder!
 static Microsoft.Maui.Platform.CalendarDatePickerExtensions.ToDateFormat(this string! dateFormat) -> string!
 static Microsoft.Maui.Platform.DatePickerExtensions.UpdateBackground(this Microsoft.UI.Xaml.Controls.CalendarDatePicker! platformDatePicker, Microsoft.Maui.IDatePicker! datePicker) -> void
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequired(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Action! action) -> void
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequiredAsync(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Action! action) -> System.Threading.Tasks.Task!
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequiredAsync(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Func<System.Threading.Tasks.Task!>! action) -> System.Threading.Tasks.Task!
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequiredAsync<T>(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Func<T>! func) -> System.Threading.Tasks.Task<T>!
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequiredAsync<T>(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Func<System.Threading.Tasks.Task<T>!>! funcTask) -> System.Threading.Tasks.Task<T>!
 *REMOVED*static Microsoft.Maui.Platform.ScrollViewerExtensions.UpdateScrollBarVisibility(this Microsoft.UI.Xaml.Controls.ScrollViewer! scrollViewer, Microsoft.Maui.ScrollOrientation orientation, Microsoft.Maui.ScrollBarVisibility horizontalScrollBarVisibility) -> void
 static Microsoft.Maui.Platform.ScrollViewerExtensions.UpdateScrollBarVisibility(this Microsoft.UI.Xaml.Controls.ScrollViewer! scrollViewer, Microsoft.Maui.ScrollOrientation orientation, Microsoft.Maui.ScrollBarVisibility visibility) -> void
 static Microsoft.Maui.Platform.SearchBarExtensions.UpdateReturnType(this Microsoft.UI.Xaml.Controls.AutoSuggestBox! platformControl, Microsoft.Maui.ISearchBar! searchBar) -> void
diff --git a/src/Core/src/PublicAPI/net/PublicAPI.Unshipped.txt b/src/Core/src/PublicAPI/net/PublicAPI.Unshipped.txt
@@ -159,6 +159,11 @@ static Microsoft.Maui.SwipeViewSwipeEnded.operator !=(Microsoft.Maui.SwipeViewSw
 static Microsoft.Maui.SwipeViewSwipeEnded.operator ==(Microsoft.Maui.SwipeViewSwipeEnded? left, Microsoft.Maui.SwipeViewSwipeEnded? right) -> bool
 static Microsoft.Maui.SwipeViewSwipeStarted.operator !=(Microsoft.Maui.SwipeViewSwipeStarted? left, Microsoft.Maui.SwipeViewSwipeStarted? right) -> bool
 static Microsoft.Maui.SwipeViewSwipeStarted.operator ==(Microsoft.Maui.SwipeViewSwipeStarted? left, Microsoft.Maui.SwipeViewSwipeStarted? right) -> bool
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequired(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Action! action) -> void
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequiredAsync(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Action! action) -> System.Threading.Tasks.Task!
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequiredAsync(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Func<System.Threading.Tasks.Task!>! action) -> System.Threading.Tasks.Task!
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequiredAsync<T>(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Func<T>! func) -> System.Threading.Tasks.Task<T>!
+static Microsoft.Maui.Dispatching.DispatcherExtensions.DispatchIfRequiredAsync<T>(this Microsoft.Maui.Dispatching.IDispatcher! dispatcher, System.Func<System.Threading.Tasks.Task<T>!>! funcTask) -> System.Threading.Tasks.Task<T>!
 virtual Microsoft.Maui.Animations.Lerp.LerpDelegate.Invoke(object! start, object! end, double progress) -> object!
 virtual Microsoft.Maui.Handlers.ContextFlyoutItemHandlerUpdate.<Clone>$() -> Microsoft.Maui.Handlers.ContextFlyoutItemHandlerUpdate!
 virtual Microsoft.Maui.Handlers.ContextFlyoutItemHandlerUpdate.EqualityContract.get -> System.Type!
diff --git a/src/Core/src/PublicAPI/netstandard/PublicAPI.Unshipped.txt b/src/Core/src/PublicAPI/netstandard/PublicAPI.Unshipped.txt
diff --git a/src/Core/src/PublicAPI/netstandard2.0/PublicAPI.Unshipped.txt b/src/Core/src/PublicAPI/netstandard2.0/PublicAPI.Unshipped.txt
diff --git a/src/Core/tests/UnitTests/Dispatching/DispatcherTests.cs b/src/Core/tests/UnitTests/Dispatching/DispatcherTests.cs

Original file line number	Diff line number	Diff line change
`@@ -2,6 +2,7 @@`
`2`	`2`	`using System.Collections;`
`3`	`3`	`using System.Collections.Generic;`
`4`	`4`	`using System.Collections.Specialized;`
	`5`	`+using Microsoft.Maui.Dispatching;`
`5`	`6`
`6`	`7`	`namespace Microsoft.Maui.Controls.Compatibility.Platform.Android`
`7`	`8`	`{`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,7 @@`
`1`	`1`	`using System;`
`2`	`2`	`using System.Collections;`
`3`	`3`	`using System.Collections.Specialized;`
	`4`	`+using Microsoft.Maui.Dispatching;`
`4`	`5`
`5`	`6`	`namespace Microsoft.Maui.Controls.Compatibility.Platform.Android`
`6`	`7`	`{`
Original file line number	Diff line number	Diff line change
`@@ -25,6 +25,7 @@`
`25`	`25`	`using WListView = Microsoft.UI.Xaml.Controls.ListView;`
`26`	`26`	`using WRect = Windows.Foundation.Rect;`
`27`	`27`	`using WSelectionChangedEventArgs = Microsoft.UI.Xaml.Controls.SelectionChangedEventArgs;`
	`28`	`+using Microsoft.Maui.Dispatching;`
`28`	`29`
`29`	`30`	`namespace Microsoft.Maui.Controls.Compatibility.Platform.UWP`
`30`	`31`	`{`
Original file line number	Diff line number	Diff line change
`@@ -3,6 +3,7 @@`
`3`	`3`	`using Microsoft.Maui.ApplicationModel;`
`4`	`4`	`using Microsoft.Maui.Controls.Internals;`
`5`	`5`	`using Microsoft.Maui.Controls.Xaml.Diagnostics;`
	`6`	`+using Microsoft.Maui.Dispatching;`
`6`	`7`
`7`	`8`	`namespace Microsoft.Maui.Controls`
`8`	`9`	`{`
Original file line number	Diff line number	Diff line change
`@@ -10,6 +10,7 @@`
`10`	`10`	`using System.Runtime.CompilerServices;`
`11`	`11`	`using Microsoft.Maui.Controls.Internals;`
`12`	`12`	`using Microsoft.Maui.Controls.Xaml.Diagnostics;`
	`13`	`+using Microsoft.Maui.Dispatching;`
`13`	`14`
`14`	`15`	`namespace Microsoft.Maui.Controls`
`15`	`16`	`{`
Original file line number	Diff line number	Diff line change
`@@ -3,6 +3,7 @@`
`3`	`3`	`using System.Collections;`
`4`	`4`	`using System.Collections.ObjectModel;`
`5`	`5`	`using System.Collections.Specialized;`
	`6`	`+using Microsoft.Maui.Dispatching;`
`6`	`7`
`7`	`8`	`namespace Microsoft.Maui.Controls.Platform`
`8`	`9`	`{`