Skip to content

Commit 1d77876

Browse files
committed
Merge branch 'main' into alvinashcraft/main-winappsdk-oauth2-howto
2 parents d947f8d + 52b593c commit 1d77876

File tree

1 file changed

+18
-18
lines changed

1 file changed

+18
-18
lines changed

hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/what-is-supported.md

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: What's supported when migrating from UWP to WinUI 3
33
description: WinUI 3 and the Windows App SDK are new technologies and, when compared to UWP, there are some features that aren't supported. This topic provides information on which features are supported before you attempt migration.
44
ms.topic: article
5-
ms.date: 03/05/2024
5+
ms.date: 03/05/2025
66
keywords: Windows, App, SDK, port, porting, migrate, migration, support
77
ms.localizationpriority: medium
88
---
@@ -13,38 +13,38 @@ WinUI 3 and the Windows App SDK are new technologies and, when compared to UWP,
1313

1414
| UWP feature | WinUI 3 status |
1515
| - | - |
16-
| [Background acrylic](guides/winui3.md#acrylicbrushbackgroundsource-property) | ✅ Available via [DesktopAcrylicController](/windows/windows-app-sdk/api/winrt/microsoft.ui.composition.systembackdrops.desktopacryliccontroller) |
16+
| [Background acrylic](guides/winui3.md#acrylicbrushbackgroundsource-property) | ✅ Available via [DesktopAcrylicController](/windows/windows-app-sdk/api/winrt/microsoft.ui.composition.systembackdrops.desktopacryliccontroller). |
17+
| [Background tasks](/windows/uwp/launch-resume/create-and-register-a-winmain-background-task) | ✅ Supported; see [BackgroundTaskBuilder](/windows/windows-app-sdk/api/winrt/microsoft.windows.applicationmodel.background/backgroundtaskbuilder) (introduced in 1.7). |
1718
| Common UI controls | ✅ Supported |
18-
| [Composition/DirectX interop](https://github.com/microsoft/microsoft-ui-xaml/issues/5025) | ✅ Mostly supported; most Composition features and most Drawing features are available. But using global composition effects isn't supported in 1.5 |
19+
| [CameraCaptureUI](https://github.com/microsoft/WindowsAppSDK/pull/4721) | ✅ Supported; see [CameraCaptureUI](/windows/windows-app-sdk/api/winrt/microsoft.windows.media.capture) (introduced in 1.7). For alternative APIs, see [Using video capture](/windows/win32/multimedia/using-video-capture). |
20+
| [Composition/DirectX interop](https://github.com/microsoft/microsoft-ui-xaml/issues/5025) | ✅ Most Composition and Drawing features are supported (global composition effects aren't supported in 1.7); see [Enhance UI with the Visual layer](../composition.md). |
1921
| Distributing via Store | ✅ Supported |
2022
| Live Tiles (on Windows 10) | ✅ Supported |
21-
| [MapControl](/uwp/api/windows.ui.xaml.controls.maps.mapcontrol) | ✅ Supported; see [MapControl](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.mapcontrol) (introduced in 1.5) |
22-
| [MediaElement](/uwp/api/windows.ui.xaml.controls.mediaelement) and [MediaPlayerElement](/uwp/api/windows.ui.xaml.controls.mediaplayerelement) | ✅ Use [MediaPlayerElement](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.mediaplayerelement), which was introduced in 1.2 |
23+
| [MapControl](/uwp/api/windows.ui.xaml.controls.maps.mapcontrol) | ✅ Supported; see [MapControl](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.mapcontrol) (introduced in 1.5). |
24+
| [MediaElement](/uwp/api/windows.ui.xaml.controls.mediaelement) and [MediaPlayerElement](/uwp/api/windows.ui.xaml.controls.mediaplayerelement) | ✅ Use [MediaPlayerElement](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.mediaplayerelement), which was introduced in 1.2. |
2325
| MSAL library | ✅ Supported |
2426
| MSIX | ✅ Supported |
2527
| [Single-instancing](guides/applifecycle.md#single-instanced-apps) | ✅ Supported |
26-
| [TaskbarManager](/uwp/api/windows.ui.shell.taskbarmanager) API | ✅ Supported; for details, see [TaskbarManager desktop samples](https://github.com/microsoft/Windows-classic-samples/tree/main/Samples/TaskbarManager) |
28+
| [TaskbarManager](/uwp/api/windows.ui.shell.taskbarmanager) API | ✅ Supported; for details, see [TaskbarManager desktop samples](https://github.com/microsoft/Windows-classic-samples/tree/main/Samples/TaskbarManager). |
2729
| [Toast notifications](guides/toast-notifications.md) | ✅ Supported |
2830
| [Visual Studio App Center](https://appcenter.ms/) | ✅ Supported |
29-
| [Background tasks](/windows/uwp/launch-resume/create-and-register-a-winmain-background-task) | ✅ Supported for C++ <br> ⚠️ Partially supported for C# (OOP background tasks supported)|
30-
| Best launch speed and performance | ⚠️ Slight disadvantage, see [performance considerations](#performance-considerations) |
31+
| [WebAuthenticationBroker](/windows/uwp/security/web-authentication-broker) | ✅ Supported; see [Microsoft.Security.Authentication.OAuth](/windows/windows-app-sdk/api/winrt/microsoft.security.authentication.oauth/microsoft_security_authentication_oauth) (introduced in 1.7). |
32+
| Best launch speed and performance | ⚠️ Slight disadvantage, see [performance considerations](#performance-considerations). |
3133
| CoreTextServicesManager | ⚠️ Supported only on Windows 11 |
32-
| [PrintManager](https://portal.productboard.com/winappsdk/1-windows-app-sdk/c/50-support-printmanager-api) | ⚠️ Supported on Windows 11 (not yet available on Windows 10) |
33-
| [CameraCaptureUI](https://portal.productboard.com/winappsdk/1-windows-app-sdk/c/49-support-cameracaptureui) | ❌ Not supported in 1.5. For alternative APIs, see [Using video capture](/windows/win32/multimedia/using-video-capture) |
34-
| [CoreWindow](/uwp/api/windows.ui.core.corewindow) and related APIs | ❌ Not supported in 1.5. For alternative APIs with some of the same functionality, see [AppWindow](/windows/windows-app-sdk/api/winrt/microsoft.ui.windowing.appwindow), and [HWND](/windows/apps/develop/ui-input/retrieve-hwnd)-based APIs |
35-
| Full containerization of your app | ❌ Not supported in 1.5 |
36-
| [InkCanvas](https://portal.productboard.com/winappsdk/1-windows-app-sdk/c/31-inking-controls) | ❌ Not supported in 1.5 |
37-
| [Single-app kiosk](https://portal.productboard.com/winappsdk/1-windows-app-sdk/c/62-support-single-app-kiosk) | ❌ Not supported in 1.5 |
38-
| [WebAuthenticationBroker](/windows/uwp/security/web-authentication-broker) | ❌ Not supported in 1.5; but see the [IWebAuthenticationCoreManagerInterop interface](/windows/win32/api/webauthenticationcoremanagerinterop/nn-webauthenticationcoremanagerinterop-iwebauthenticationcoremanagerinterop) |
39-
| [Xbox](/windows/uwp/xbox-apps/) and HoloLens support | ❌ Not supported in 1.5 |
34+
| [PrintManager](/uwp/api/windows.graphics.printing.printmanager) | ⚠️ Supported on Windows 11 (not yet available on Windows 10) |
35+
| [CoreWindow](/uwp/api/windows.ui.core.corewindow) and related APIs | ❌ Not supported in 1.7. For alternative APIs with some of the same functionality, see [AppWindow](/windows/windows-app-sdk/api/winrt/microsoft.ui.windowing.appwindow), and [HWND](/windows/apps/develop/ui-input/retrieve-hwnd)-based APIs. |
36+
| [Virtual key support for gamepad input](/uwp/api/windows.system.virtualkey) | ❌ Not supported in 1.7; see [Gamepad support in WinUI 3](https://github.com/microsoft/microsoft-ui-xaml/issues/6891) |
37+
| [InkCanvas](/uwp/api/windows.ui.xaml.controls.inkcanvas) | ❌ Not supported in 1.7 |
38+
| [Single-app kiosk](https://github.com/microsoft/WindowsAppSDK/issues/3642) | ❌ Not supported in 1.7 |
39+
| [Xbox](/windows/uwp/xbox-apps/) and HoloLens | ❌ Not supported in 1.7 |
4040

4141
## Performance considerations
4242

43-
Today in version 1.5 of the Windows App SDK, launch speeds, RAM usage, and installation size of WinUI 3 apps are larger/slower than seen in UWP. We're actively working to improve this.
43+
Today in version 1.7 of the Windows App SDK, launch speeds, RAM usage, and installation size of WinUI 3 apps are larger/slower than seen in UWP. We're actively working to improve this.
4444

4545
## Visual Studio
4646

47-
The **Design** tab of the XAML Designer in Visual Studio (and Blend for Visual Studio) doesn't currently support WinUI 3 projects (as of version 1.5 of the Windows App SDK). For more info, see [Create a UI by using XAML Designer](/visualstudio/xaml-tools/creating-a-ui-by-using-xaml-designer-in-visual-studio).
47+
The **Design** tab of the XAML Designer in Visual Studio (and Blend for Visual Studio) doesn't currently support WinUI 3 projects (as of version 1.7 of the Windows App SDK). For more info, see [Create a UI by using XAML Designer](/visualstudio/xaml-tools/creating-a-ui-by-using-xaml-designer-in-visual-studio).
4848

4949
## See Also
5050

0 commit comments

Comments
 (0)