Windows App SDK 1.7.0 (1.7.250310001)

[RDMacLachlan]

Windows App SDK 1.7.0 (1.7.25031001)

WinAppSDK 1.7.0 is the latest stable version of WinAppSDK providing new features and improvements to the platform.

Whats new in WinAppSDK 1.7.0:

• New Microsoft.UI.Windowing.AppWindow APIs make it easier to control your app windows to create a great experience. New capabilities include using:
  • SetTaskBarIcon and SetTitleBarIcon to independently set the taskbar and titlebar icons
  • AppWindowTitleBar.PreferredTheme to set the light/dark theme of the titlebar
  • using new properties like OverlappedPresenter.PreferredMinimumWidth
  • OverlappedPresenter.PreferredMaximumHeight to set a minimum or maximum width or height for the window.
• New Microsoft.Windows.Media.Capture.CameraCaptureUI API to WinAppSDK to provide a streamlined solution with feature parity, now supporting WindowID in the constructor for enhanced desktop compatibility.
• New OAuth2Manager API provides a streamlined solution for web authentication, offering OAuth 2.0 capabilities with full feature parity across all Windows platforms supported by Windows App SDK.
• New BackgroundTaskBuilder API provides WinAppSDK dependent apps the ability to directly register the full trust COM components with background tasks, removing the need to implement a workaround.
• TitleBar control makes it much easier to create a great, customizable titlebar for your app.
• RichEditBox now supports MathML, via RichEditTextDocument.SetMathMode and RichEditTextDocument.SetMathML.
• Windows App SDK's Dynamic Dependencies APIs delegate all calls to Windows 11's implementation when running on >= Windows 11 24H2 (10.0.26100.0) providing improved performance and robustness.
• Updates in the Microsoft.UI.Content namespace introduce several significant enhancements and new features aimed at improving the functionality and interoperability of the ContentIsland APIs.
  • DesktopPopupSiteBridge: Enables hosting a ContentIsland in the environment of a Win32 window with WS_POPUP style.
  • ChildSiteLink: Allows a parent ContentIsland to host a nested child ContentIsland, providing a seamless partitioning of the rendering surface without user experience seams.
  • DesktopAttachedSiteBridge: Attaches to an existing Win32 window instead of creating a new one, designed to host a ContentIsland with Windows.UI.Composition.Visuals at the root of the Win32 window hierarchy, ensuring full control over Win32-based input processing and accessibility.
  • Enhanced rendering and input synchronization
  • ContentIslands with Windows.UI.Composition.Visuals
• New RuntimeCompatibilityOptions support will allow more control over how servicing changes affect apps. For more info, see GitHub #4966.
• A new ReleaseInfo API provides easy access to the version of the Windows App SDK Runtime in use. For more info, see GitHub #2893.
• Note: Windows Copilot Runtime APIs are not included this release. To experiment with these APIs, please continue to use the 1.7-experimental3 release and share your feedback!

To see everything that's new and changed, see the full Windows App SDK 1.7 release notes.

Try it out

• Download the 1.7.250310001 NuGet package to use WinAppSDK 1.7 in your app.
• Download and update the WinUI Gallery to see the WinUI 3 updates firsthand.

Getting Started

To get started using Windows App SDK to develop Windows apps, check out the following documentation:

• Install developer tools .
• Create a WinUI 3 app.
• Continue your development journey.

---

This discussion was created from the release Windows App SDK 1.7.0 (1.7.250310001).

[huniz86]

Congratulations on the release of Windows App SDK 1.7. Thank you.

Please check if the Windows App SDK 1.7 Runtime file is correct.

1.7.0 (1.7.250310001)
03/18/2025
Release notes
Source Installer (x64)
Installer (x86)
Installer (arm64)
Redistributable

https://aka.ms/windowsappsdk/1.7/1.7.250310001/windowsappruntimeinstall-x64.exe

Please check if the Windows App SDK 1.7 Runtime file is correct.
The uploaded and published file seems to be the 1.6 file.
Did the person in charge make a mistake in publishing the file?

[RDMacLachlan]

Thank you for letting us know. I've reached out to the development team to investigate.

[RDMacLachlan]

Thank you for creating #5246. We will use this GitHub Issue to track and respond.

[gaobin89]

After upgrading to 1.7.250310001, my app can't run. Trying to install the latest version of WebView2 is the same problem. How to fix it ?

Error message:

Method 'GetVirtualMethodTableInfoForKey' in type 'Microsoft.Web.WebView2.Core.CoreWebView2' from assembly 'Microsoft.Web.WebView2.Core.Projection, Version=1.0.2903.40, Culture=neutral, PublicKeyToken=2a8ab48044d2601e' does not have an implementation.

[RDMacLachlan]

Please create an Issue in this GitHub repo for this.

[gaobin89]

Issue created #5248

[RDMacLachlan]

Thank you!

[HotCakeX]

Hi, the link to Dynamic Dependencies APIs leads to a not found error, i think the link should be this: https://learn.microsoft.com/en-us/windows/apps/desktop/modernize/framework-packages/use-the-dynamic-dependency-api

[RDMacLachlan]

Thank you for creating Issue #5251 for this issue.

[Balkoth]

New preferred minimum size APIs are bugged and only take the scaling of the main display into account.

[niels9001]

Would you mind filing a bug for this?

[niels9001]

@Balkoth Opened an issue here, let me know if you are running into the same issue: https://github.com/microsoft/WindowsAppSDK/issues/5249

[Balkoth]

Yep its this problem.

[RDMacLachlan]

Thank you @niels9001 for creating the issue.

[HotCakeX]

I filed an issue for 1.7: https://github.com/microsoft/WindowsAppSDK/issues/5251
Exceptions thrown from an Async method crash the app and are not caught by the UnhandledException event handler in the App class. Doesn't happen in the previous stable version.

[RDMacLachlan]

Thank you.

[Zakariathr22]

How is SetMathML supposed to work? I tried this code, but the app crashes. Am I missing something, or is this an issue that should be reported?

REBox.Document.SetMathMode(RichEditMathMode.MathOnly);
REBox.Document.SetMathML("a^2 + b^2 = c^2");

[RDMacLachlan]

Please create an Issue in this GitHub repo for this.

[Zakariathr22]

Please create an Issue in this GitHub repo for this.

Done! #5257

[RDMacLachlan]

Thank you.

[bogdan-patraucean]

Please fix this issue, makes apps unusable, and has been reported for some time. Should be prioritized.
microsoft/microsoft-ui-xaml#10213

[Balkoth]

Is this version now officially supported on .NET9?

[bogdan-patraucean]

yes, there were no breaking changes to .NET so it works by default now

[DarranRowe]

@bogdan-patraucean

It seems that @Balkoth wants an official note, such as when 1.2 added a note that stated .NET 7 is supported. There is a difference between something that should work and something that is supported by the library vendor.

[Balkoth]

It's strange that this question is dodged in the discussion i started and also here, while @RDMacLachlan posts under all issues...

[bogdan-patraucean]

@DarranRowe that was needed because there were breaking changes, now there are none.

[DarranRowe]

@bogdan-patraucean

While there are no breaking changes to the build system, there ARE breaking changes to .NET 9's core library and JIT. Can you say for sure that the generated code for WinUI 3 or CsWinRT will not fall foul to any of these breaking changes?

[toto45638]

After upgrading to version 1.7, I started getting an exception error when setting ExtendsContentIntoTitleBar to true on a window that is not the main window, and enabling native code debugging. It would be helpful if you could check this.
#5305

[RDMacLachlan]

Please create an Issue for this.

[toto45638]

Here it is. #5305

[RDMacLachlan]

Thank you.