Windows App SDK 1.7.2 (1.7.250513003)

Windows App SDK 1.7.2 (1.7.250513003)

WinAppSDK 1.7.2 is the latest stable version of WinAppSDK providing new features and improvements to the platform. WinAppSDK 1.7.2 introduces exciting new features designed to bring artificial intelligence (AI) to your products with the power of Phi Silica and Windows AI APIs.

Whats new in WinAppSDK 1.7.2:

• Phi Silica, Microsoft's most powerful NPU-tuned local language model, you can specify it to perform common tasks like summarizing a piece of text, rewriting a piece of text for clarity, and converting text to a table format.
• Image Description APIs enable the generation of textual descriptions of images.
• Text recognition, also known as optical character recognition (OCR), detects and extracts text within images, converting it into machine-readable character streams.
• The 'ImageScaler' APIs can increase the sharpness and clarity of an image and upscale the image by up to 8x its original resolution.
• The Image Segmentation APIs allow for the identification of specific objects within an image. By inputting an image and a "hints" object, the model returns a mask of the identified object.
• ApplicationData.MachineFolder is now easier to use on Windows >=10.0.26100.0 (Ge). Windows will create the Machine folder when a package manifesting opt-in support is added to a system if WinAppSDK 1.7.2 is present on the system.

This release also includes the following Bug Fixes:

• Fixed PackageDeploymentManager telemetry to properly capture completion status. For more info, see GitHub issue #5296. (RuntimeCompatibilityChange: N/A)
• Fixed a crash when using pen input on an x86 app. (RuntimeCompatibilityChange: InputStateManager_PenInputCrashX86)
• Fixed a potential crash if the window is already destroyed when WinUI is attempting to initialize for scrolling. (RuntimeCompatibilityChange: ActivateDirectManipulationManager_CheckCanInit)
• Fixed the WINDOWSAPPSDK_RELEASE_PATCH define and Microsoft::WindowsAppSDK::Release::Patch values in WindowsAppSDK-VersionInfo.h to not always be 0. The define is now the yymmdd date of the build, and the Patch value is the mmdd date. This change provides better runtime information on the version being used without changing any variable sizes or the version scheme. (RuntimeCompatibilityChange: N/A, header change)
• Fixed a potential issue in the Bootstrapper if it is used to load a 1.6 or earlier version of WinAppSDK. For more info, see GitHub issue #5349. (RuntimeCompatibilityChange: N/A)
• Fixed an issue where using MSBuild to build a single-project app could incorrectly fail with a build error if it didn't have a correct launchSettings.json. (RuntimeCompatibilityChange: N/A, build .targets change)
• Improved the performance of rendering the first frame on application launch. (RuntimeCompatibilityChange: DwmCoreI_OptimizeFirstFrameLatency)

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.250513003NuGet 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.

1.8.0 Experimental 2 (1.8.250515001-experimental2) 🧪

Windows App SDK 1.8 Experimental 2 introduces exciting new features designed to bring artificial intelligence (AI) to your products with the power of Phi Silica and Windows AI APIs.

Important

This release has Known Issues visit our release notes for more information.

The Windows App SDK incorporates advanced Windows AI capabilities, enabling developers to seamlessly integrate intelligent features into their applications. These enhancements include local AI functionalities such as:

• Summarize Conversation feature that allows you to summarize what people have said over an email, chat, or thread. See Phi Silica for more details
• Low-Rank Adaption (LoRA) for Phi Silica allows developers to fine-tune the on-device language model (Phi Silica) using their own custom data.

This release also include the following:

• Decimal support which offers a high-precision base-10 numeric data type that is invaluable for financial and scientific calculations, avoiding imprecision and rounding errors inherent to floating-point data types.
• The Windows App SDK NuGet package has been converted to a NuGet metapackage. The use of individual component packages enables developers to include only the APIs and functionalities that are necessary for their apps.
• The MSIX publishing support has been factored into a standalone nuget package, which can be independently maintained and consumed by Windows App SDK and other projects.
• In addition, several feature gaps with Single-Project solutions have been addressed including generation of MSIX bundles and MSIX upload packages.

For information on responsible development practices utilized during the creation of the Windows AI APIs, which can also be applied when creating AI-assisted features, consult the Developing Responsible Generative AI Applications and Features on Windows guidance.

Windows App SDK 1.6.8 (1.6.250430001)

Windows App SDK 1.6.8 (1.6.250430001)

This is a servicing release of the Windows App SDK that includes critical bug fixes and a new feature for the 1.6 release.

This release includes the following new features for 1.6:

• ApplicationData.MachineFolder is now easier to use on Windows >=10.0.26100.0 (Ge). Windows will create the Machine folder when a package manifesting opt-in support is added to a system if WinAppSDK 1.6.8 is present on the system. For more details see the ApplicationData spec.

This release includes fixes the following critical bugs for 1.6:

• Fixed PackageDeploymentManager telemetry to properly capture when completion status. For more info, see GitHub issue #5297.
• Fixed a crash when using pen input on an x86 app.
• Fixed a potential crash if the window is already destroyed when WinUI is attempting to initialize for scrolling.
• Fixed the WINDOWSAPPSDK_RELEASE_PATCH define and Microsoft::WindowsAppSDK::Release::Patch values in WindowsAppSDK-VersionInfo.h to not always be 0. The define is now the yymmdd date of the build, and the Patch value is the mmdd date. This change provides better runtime information on the version being used without changing any variable sizes or the version scheme.

Check out our release notes for the list of issues fixed in this release.

Updating to this version

The 1.6.8 package is available at https://www.nuget.org/packages/Microsoft.WindowsAppSDK/1.6.250430001

1.8.0 Experimental 1 (1.8.250410001-experimental1) 🧪

Windows App SDK 1.8 Experimental 1 introduces an exciting new features designed to bring artificial intelligence (AI) to your products with the power of Phi Silica and Windows CoPilot Runtime APIs

• Object Erase - the ImageObjectRemover API can be used to remove objects from images. The model takes both an image and a greyscale mask indicating the object to be removed, erases the masked area from the image, and replaces the erased area with the image background.

This release of the Windows App SDK includes bug fixes for the 1.8 release:

• • Fixed an issue where mouse wheel input is ignored if the "Scroll inactive windows when hovering over them" option in Windows Settings is disabled. For more info, see GitHub issue #10091.

Windows App SDK 1.6.7 (1.6.250402001)

Windows App SDK 1.6.7 (1.6.250402001)

Windows App SDK 1.6.7 is a stable servicing release that fixes the following critical bugs for 1.6:

This is a servicing release of the Windows App SDK that includes critical bug fixes for the 1.6 release.

• Improved the telemetry for failure scenarios in WindowsAppRuntimeInstall-<arch>.exe. For more info, see GitHub issue #5291.
• Fixed an issue where pointer input would stop working when using arrow keys at the same time. For more info, see GitHub issue #10126.
• Fixed an issue where apps in remote desktop stop responding to pointer input. For more info, see GitHub issue #10009. (This is the same fix as the pointer input plus arrow keys fix, due to remote desktop automatically sending some key input during the switch away and back.)
• Fixed a potential crash trying to restore focus if a window activation event is delivered for a window which is closing.
• Fixed a performance regression introduced in WinAppSDK 1.6 due to WinUI binaries missing some linker optimizations.
• Fixed a small performance issue when creating multiple WinUI windows/islands.
• Fixed a potential crash if ProgressBar::SetProgressBarIndicatorWidth is called on a ProgressBar which is not in the tree.
• Fixed a potential crash caused by CPopup::EnsureBridgeClosed sometimes triggering reentrancy.
• Fixed a potential crash when closing a popup due to CUIElement::FlushPendingKeepVisibleOperations using a null children collection.
• Fixed PackageDeploymentManager.EnsurePackage*Ready to ensure version supersedence. For more info, see GitHub issue #5225.

Check out our release notes for the list of issues fixed in this release.

Updating to this version

The 1.6.7 package is available at https://www.nuget.org/packages/Microsoft.WindowsAppSDK/1.6.250402001

Windows App SDK 1.7.1 (1.7.250401001)

Windows App SDK 1.7.1 (1.7.250401001)

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

Whats new in WinAppSDK 1.7.1:

• Improved the telemetry for failure scenarios in WindowsAppRuntimeInstall-<arch>.exe. For more info, see GitHub issue #5289. (RuntimeCompatibilityChange: N/A for this installer change)
• Fixed an issue where pointer input would stop working when using arrow keys at the same time. For more info, see GitHub issue #10126. (RuntimeCompatibilityChange: FixStuckPointerInputQueue)
• Fixed an issue where apps in remote desktop stop responding to pointer input. For more info, see GitHub issue #10009. (This is the same fix as the pointer input plus arrow keys fix, due to remote desktop automatically sending some key input during the switch away and back.) (RuntimeCompatibilityChange: FixStuckPointerInputQueue)
• Fixed a potential crash trying to restore focus if a window activation event is delivered for a window which is closing. (RuntimeCompatibilityChange: FixWindowCloseFocusCrash)
• Fixed a performance regression introduced in WinAppSDK 1.6 due to WinUI binaries missing some linker optimizations. (RuntimeCompatibilityChange: N/A, changed linker options)
• Fixed a potential crash if ProgressBar::SetProgressBarIndicatorWidth is called on a ProgressBar which is not in the tree. (RuntimeCompatibilityChange: FixSetProgressBarIndicatorWidthCrash)
• Fixed a potential crash caused by CPopup::EnsureBridgeClosed sometimes triggering reentrancy. (RuntimeCompatibilityChange: FixPopupClosingReentrancyCrash)
• Fixed a potential crash when closing a popup due to CUIElement::FlushPendingKeepVisibleOperations using a null children collection. (RuntimeCompatibilityChange: FixPopupUnloadingCrash)
• Fixed PackageDeploymentManager.EnsurePackage*Ready to ensure version supersedence. For more info, see GitHub issue #5191. (RuntimeCompatibilityChange: EnsurePackageReadyVersionSupercedence)
• Fixed a potential crash caused by WebView2::UpdateCoreWebViewVisibility sometimes triggering reentrancy. For more info, see GitHub issue #10305. (RuntimeCompatibilityChange: FixWebViewVisibilityReentrancyCrash)
• Fixed an issue where app UI sometimes permanently freezes and can stop rendering due to the DispatcherQueue getting stuck. (RuntimeCompatibilityChange: FixRandomUIFreezeInDispatcher)

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.250401001NuGet 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.

Windows App SDK 1.7.0 (1.7.250310001)

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.

Windows App SDK 1.6.6 (1.6.250228001)

Windows App SDK 1.6.6 (1.6.250228001)

Windows App SDK 1.6.6 is a stable servicing release that fixes the following critical bugs for 1.6:

This is a servicing release of the Windows App SDK that includes critical bug fixes for the 1.6 release.

• Fixed an issue where a child window posting WM_NCMOUSELEAVE to the parent window would result in a loop that blocks new mouse input events.
• Fixed a crash which would occur on the next AppWindow.Changed event after a WebView2 process failure.
• Fixed a potential crash when using an Accessibility tool and closing a window.
• Fixed an issue where a textbox would not accept key input if given focus by clicking in the area of the clear button of the textbox. For more info, see GitHub issue #7703.
• Fixed an issue where a tooltip is not shown for the Minimize button in the titlebar when using ExtendsContentIntoTitleBar=true. For more info, see GitHub issue #9149.

This release includes the following new APIs:

• A new IsPlaceholderContent property on WidgetInfo and WidgetUpdateRequestOptions enables a Widget provider to indicate that it would display placeholder content if rendered.

Check out our release notes for the list of issues fixed in this release.

Updating to this version

The 1.6.6 package is available at https://www.nuget.org/packages/Microsoft.WindowsAppSDK/1.6.250228001

v1.7.0-preview1

1.7 Preview 1 (1.7.250208002-preview1) 🔃

The first preview of WinAppSDK 1.7 is now available! Check out the release notes for more information on the new & updated features and known issues.

Updates to this version:

The 1.7 Preview 1 package is available at https://www.nuget.org/packages/Microsoft.WindowsAppSDK/1.7.250208002-preview1

• New Badge notifications to allow numeric (1-99) or system glyphs to be applied.
• New CameraCaptureUI API provides a streamlined solution with support for WindowID in the constructor for enhanced desktop compatibility.
• New AuthManager has been introduced.
• New background task support, providing the ability to directly register the full trust COM components with background tasks.
• New Titlebar controls includes robust titlebar capabilities like empty-space draggable regions, theme responsiveness, caption buttons and built-in accessibility support.
• Support for MathML
• New Runtime compatibility options to provide more control over how servicing changes affect apps.
• New ReleaseInfo API provides easy access to the version of the WinAppSDK runtime in use.

Bugs fixed in the new WinAppSDK Release:

• #178 - Changed 'SplitButton' so touch input now matches the behavior of mouse input. |
• #939 - Changed cascading menus so sub menus now open immediately if clicked |
• #1467 - Fixed an issue where opening a ComboBox which is in a flyout closes all flyouts
• #2527 - Fixed an issue where SwipeControl would randomly crash in a ListView
• #3458 - Fixed an issue where drag-and-drop only a ListViewItem would leave it in the wrong visual state
• #3842 - Fixed an issue in StackLayout so that is respects the ItemsRepeater.HorizontalAlignment and VerticalAlignment properties
• #6661 - Fixed an issue when deleting items in the ItemsRepeater alignment was stretched
• #8447 - Fixed an issue where the right Alt key would not show Keytips for Access Keys
• #9199 - Fixed a crash where UniformGridLayout would sometimes pick a wrong layout anchor and cause infinite layout passes when scrolling backwards
• #9632 - Fized an issue where setting NavigationFailedEventArgs.Handled to True would still throw an exception
• #9846 - Fixed an issue where TabView would not apply any specific CornerRadius
• #9852 - Fixed a potential layout cycle crash in StackLayout
• #9868 - Fixed a potential crash in ItemsView when removing items.

Providing feedback

As we introduce new & upcoming features in our preview releases, we appreciate all of your feedback as we work towards a stable release:

• For WinUI 3 feedback, please open an issue on the WinUI repo.
• For feedback regarding all other Windows App SDK components, please open an issue here, on the Windows App SDK repo.

Windows App SDK 1.6.5 (1.6.250108002)

Windows App SDK 1.6.5 (1.6.250205002)

Windows App SDK 1.6.5 is a stable servicing release that fixes critical bugs for 1.6.

• Fixed several memory leak issues.

Check out our release notes for the list of issues fixed in this release.

Updating to this version

The 1.6.5 package is available at https://www.nuget.org/packages/Microsoft.WindowsAppSDK/1.6.250205002