WindowsAppSDK

Windows App SDK 1.0.4 is now available

Windows App SDK 1.0.4 is a stable servicing release that fixes critical bugs for 1.0.

• If you're building an app with the Windows App SDK for the first time, follow the installation instructions here.

• If you are already using the Windows App SDK 1.0 and would like to update to the latest release, you can do so by following the update instructions here.

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

Updating to this version

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

1.1.0

Windows App SDK 1.1.0 is now available 🎉

You are now able to use the stable version of Windows App SDK 1.1 in your applications! This release includes new features and stability & performance improvements across the component areas. New capabilities for apps using Windows App SDK include:

• Apps can create multiple windows with WinUI3 content on the same UI thread.
• Mica & Background Acrylic styles are available for WinUI 3 content.
• Improved default and custom title bar with new functionalities like z-order, sizing/resizing, tall title bar, and extended show.
• Apps using the Windows App SDK can run with elevated permissions.
• Apps that deploy with all their dependencies together are now able to include the Windows App SDK as well. (self-contained deployment)
• Apps can push notifications regardless of being packaged/unpackaged, or whether the app is published in the Store.
• The environment variables PATH, and PATHEXT can be managed and tracked at runtime using new convenient APIs.
• Apps can restart manually or register themselves to be restarted if it was running when a system update occurs.

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

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.

What's next

To keep up with progress being made on the Windows App SDK, please see our feature roadmap.

Windows App SDK 0.8.10 is now available

Windows App SDK 0.8.10 is a stable servicing release that continues to fix critical bugs for 0.8. As a note, Windows App SDK 0.8.9 was not released. The version released directly after 0.8.8 is 0.8.10.

• If you're building an app with the Windows App SDK for the first time, follow the installation instructions here.

• If you are already using the Windows App SDK 0.8 and would like to update to the latest release, you can do so by following the update instructions here.

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

Updating to this version

The 0.8.10 package is available at https://www.nuget.org/packages/Microsoft.ProjectReunion/0.8.10

For C# developers, one of the following .NET SDK versions (or later) is required: 6.0.202, 6.0.104, 5.0.407, 5.0.213. To update your .NET SDK version, visit .NET Downloads or update to the latest version of Visual Studio. Without the required .NET SDK version, when updating your NuGet package you will see an error like: "This version of WindowsAppSDK requires WinRT.Runtime.dll version 1.6 or greater.".

Windows App SDK 1.1 Preview 3

1.1 Preview 3 Release of Windows App SDK

We've just released our third preview of the 1.1 release of the Windows App SDK! This preview includes new features and bug fixes, including:

• Mica and Background Acrylic available for WinUI 3 apps
• New extension categories in MSIX
• Several bug fixes in the Notifications area

To see everything that's new and changed, see the full release notes here.

What's next

To keep up with progress being made on the Windows App SDK, please see our feature roadmap, which gets updated regularly.

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 0.8.8 is now available

Windows App SDK 0.8.8 is a stable servicing release that continues to fix critical bugs for 0.8.

• If you're building an app with the Windows App SDK for the first time, follow the installation instructions here.

• If you are already using the Windows App SDK 0.8 and would like to update to the latest release, you can do so by following the update instructions here.

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

Updating to this version

The 0.8.8 package is available at https://www.nuget.org/packages/Microsoft.ProjectReunion/0.8.8

For C# developers, one of the following .NET SDK versions (or later) is required: 6.0.202, 6.0.104, 5.0.407, 5.0.213. To update your .NET SDK version, visit .NET Downloads or update to the latest version of Visual Studio. Without the required .NET SDK version, when updating your NuGet package you will see an error like: "This version of WindowsAppSDK requires WinRT.Runtime.dll version 1.6 or greater.".

Windows App SDK 1.1 Preview 2

1.1 Preview 2 Release of Windows App SDK

We've just released our second preview of the 1.1 release of the Windows App SDK! This preview includes several new capabilities, including:

• Additional windowing functionality (see Windows and Messages) available in AppWindow APIs.
• Tall title bar support for apps drawing custom title bars with AppWindowTitleBar.ExtendsContentIntoTitleBar.
• Improved usability and troubleshooting in Bootstrapper APIs for deployment.
• Several bug fixes across the WinUI and Notifications areas.
• Performance improvements in C# applications.

Regression from 1.1 Preview 1: Push notifications are not supported for unpackaged apps. This is expected to be restored in the next release.

To see everything that's new and changed, see the full release notes here.

What's next

To keep up with progress being made on the Windows App SDK, please see our feature roadmap, which gets updated regularly.

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.0.3 is now available

Windows App SDK 1.0.3 is a stable servicing release that includes critical bug fixes for the 1.0 release.

• If you're building an app with the Windows App SDK for the first time, follow the installation instructions here.

• If you are already using the Windows App SDK 1.0 and would like to update to the latest release:

  • Update your Microsoft.WindowsAppSDK NuGet package reference from 1.0.0/1.0.1/1.0.2 to 1.0.3.
  • Download the 1.0.3 runtime using either the standalone Runtime installer (.exe) or the Windows App Runtime Redistributable which includes all MSIX package dependencies.

Bugs fixed in Windows App SDK 1.0.3:

• Fixed issue causing C# apps with WebView2 to crash on launch when the C/C++ Runtime (CRT) isn't installed.
• Fixed touch input issues causing problems with keyboard shortcuts and other scenarios: #6291.

Note: We don't usually add functionality in a servicing release, but this release's WebView2 fix required us to update to the latest version of the WebView2 SDK (1020.46 to 1185.39). See Release Notes for the WebView2 SDK for additional information on WebView2 1.0.1185.39 and Distribute your app and the WebView2 Runtime for additional information on the WebView2 Runtime.

Windows App SDK 1.0.2 is now available

Windows App SDK 1.0.2 is a stable servicing release that includes critical bug fixes for the 1.0 release.

• If you're building an app with the Windows App SDK for the first time, follow the installation instructions here.

• If you are already using the Windows App SDK 1.0 and would like to update to the latest release:

  • Update your Microsoft.WindowsAppSDK NuGet package reference from 1.0.0/1.0.1 to 1.0.2.
  • Download the 1.0.2 runtime using either the standalone Runtime installer (.exe) or the Windows App Runtime Redistributable which includes all MSIX package dependencies.

Bugs fixed in Windows App SDK 1.0.2:

• Fixed layout cycle issue causing an app to crash when scrolling to the end of a ListView: #6218
• Fixed issue causing C# apps to crash on launch when the C/C++ Runtime (CRT) isn't installed. However, the CRT is still required for C# apps using WebView2: #2117
• Fixed issue where applications with Single-project MSIX did not generate a .appinstaller file: #1821
• Fixed issue where WinUI applications did not support .NET 6 dotnet build.

Windows App SDK 0.8.7 is now available!

Windows App SDK 0.8.7 is a stable servicing release that includes several performance improvements for C#/.NET applications.

• If you're building an app with the Windows App SDK for the first time, follow the installation instructions here.

• If you are already using the Windows App SDK 0.8 and would like to update to the latest release, you can do so by following the update instructions here.

For a detailed list of the performance improvements, see the C#/WinRT 1.6.1 release notes.

Updating to this version

The 0.8.7 package is available at https://www.nuget.org/packages/Microsoft.ProjectReunion/0.8.7

To update to this version, you will need to update your .NET SDK to one of the following versions or later: .NET SDK 6.0.104, 6.0.202, 5.0.213, or 5.0.407. See the .NET Downloads page to download the latest .NET SDK.

If you are not able to update your .NET SDK version, add the property <WindowsSdkPackageVersion>10.0.<sdk_version>.24</WindowsSdkPackageVersion> to your csproj file with the SDK version your app is targeting from the TargetFramework property. For example:

<Project Sdk="Microsoft.NET.Sdk"> 
    <PropertyGroup> 
        <OutputType>WinExe</OutputType> 
        <TargetFramework>net6.0-windows10.0.19041.0</TargetFramework> 
        <TargetPlatformMinVersion>10.0.17763.0</TargetPlatformMinVersion> 
        <WindowsSdkPackageVersion>10.0.19041.24</WindowsSdkPackageVersion>  
    <PropertyGroup> 

    ...  

This version of the Windows SDK projection will be available in an upcoming .NET 6 and .NET 5 servicing release. After this .NET SDK update is available, you should remove the <WindowsSdkPackageVersion> property from your project file. If this property is not set, you will see an error like: "Error: This version of Project Reunion requires WinRT.Runtime.dll version 1.6 or greater."

Windows App SDK 1.1 Preview 1

1.1 Preview 1 Release of Windows App SDK

We've just released our first preview of the 1.1 release of the Windows App SDK! This preview includes several new capabilities, including:

• Support for running applications with elevated privileges
• Self-contained app deployment
• Support for multi-window applications (also available in version 1.0.1 and newer)
• Push and app notifications
• Enabling developers to add, remove, and modify environment variables without having to directly use the registry API.

Known issue for WinUI 3 applications: Users are unable to drop an element when drag and drop is enabled.

To see everything that's new and changed, see the full release notes here.

What's next

To keep up with progress being made on the Windows App SDK, please see our feature roadmap, which gets updated regularly.

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.0.1 is now available

Windows App SDK 1.0.1 is a stable servicing release that includes critical bug fixes and multi-window support for the 1.0 release.

• If you're building an app with the Windows App SDK for the first time, follow the installation instructions here.

• If you are already using the Windows App SDK 1.0 and would like to update to the latest release:

  • Update your Microsoft.WindowsAppSDK NuGet package reference from 1.0.0 to 1.0.1.
  • Download the 1.0.1 runtime using either the standalone Runtime installer (.exe) or the Windows App Runtime Redistributable which includes all MSIX package dependencies.

Bugs fixed in Windows App SDK 1.0.1:

• Fixed issue causing the MddBootstrapAutoinitializer to not compile with enabled ImplicitUsings: #1686
• Fixed issue where focus in WebView2 would be unexpectedly lost causing input and selection issues: #5615 & #5570
• Fixed issue causing the in-app toolbar in Visual Studio to be unclickable when using a custom title bar in a WinUI 3 app.
• Fixed issue causing Snap Layout to not appear when using a custom title bar in a WinUI 3 app: #6333 & #6246
• Fixed issue causing an exception when setting Window.ExtendsContentIntoTitleBar property when Window.SetTitlebar has been called with a still-loading UIElement.
• Fixed issue where Single-project MSIX apps did not support dotnet build.
• Fixed issue causing unpackaged apps to not install after installing a packaged app: #1871
• Fixed issue reducing performance during mouse drag operations.
• Fixed crash when calling GetWindowIdFromWindow() in unpackaged apps: Discussed in #1891

Additionally, for apps with custom title bars, we have made changes in this release (and fixed numerous issues) that include fixes to the glass window used for drag&drop operations.
The recommendation is to use the default values and behaviors (give them a try!).
If your title bar used margins so that the default caption buttons were interactive, we recommend visualizing your drag region by setting the background of your title bar to red and then adjusting the margins to extend the drag region to the caption controls.

New capabilities

We have stabilized and enabled the creation of multiple windows on the same thread in WinUI 3 applications. Previously, this would produce an error.

Windows App SDK 0.8.7-preview1 is now available!

Windows App SDK 0.8.7-preview1 is a preview release that includes several C# performance improvements. If you are building a Windows App SDK app with C#/.NET, you can try out this preview release to assess performance improvements. These performance updates will also be available in future stable servicing releases to Windows App SDK 0.8 and 1.0.

Updating to this version

• If you are already using the Windows App SDK 0.8 and would like to update to this preview release, you can do so by following the update instructions here. The instructions for updating between 0.8 Preview to 0.8 Stable or between stable 0.8 versions still apply.

• You will also need to add the WindowsSdkPackageVersion property to your project file (*.csproj) to override the Windows SDK C# projection version:

<PropertyGroup>
    <WindowsSdkPackageVersion>10.0.<sdk_version>.23-preview</WindowsSdkPackageVersion>
</PropertyGroup>

This preview version of the Windows SDK projection will be available in a future .NET 6 and .NET 5 servicing release. After this .NET SDK update is available, you should remove the property from your project file.

Updates in Windows App SDK 0.8.7-preview1

This preview release includes performance improvements for C#/.NET applications. Details on these performance improvements are listed in the C#/WinRT 1.5.0-prerelease release notes.

Windows App SDK 0.8.6 is now available

Windows App SDK 0.8.6 is a stable servicing release that continues to fix critical bugs for 0.8.

• If you're building an app with the Windows App SDK for the first time, follow the installation instructions here.

• If you are already using the Windows App SDK 0.8 and would like to update to the latest release, you can do so by following the update instructions here.

0.8.6 includes several performance improvements for C#/.NET applications. For a detailed list of the performance improvements, see the C#/WinRT 1.4.1 release notes. To update to this version of Windows App SDK, you will need to have the latest .NET SDK December update installed (either .NET SDK 5.0.404 or later, or .NET SDK 5.0.210 or later). You can now download the latest .NET 5 SDK here. If you do not have the minimum required version of the .NET SDK installed, you will see an error like "Error: This version of Project Reunion requires WinRT.Runtime.dll version 1.4 or greater."

1.0 stable release of Windows App SDK is now LIVE!

It's finally here! We've just shipped our latest 1.0 stable release of Windows App SDK! This is the first stable release that fully supports unpackaged apps! In addition, this release includes several new features and lots of bug fixes and stability improvements for WinUI, Windowing, Input, App Lifecycle, Dwrite Core, MRT Core, and deployment.

We can't wait for you to try all the new features and fixes in the 1.0 stable release.

What's new

The 1.0 stable version of WinUI can be used for shipping production apps. There is also a new high-level windowing API that allows for easy-to-use windowing scenarios that integrates well with the Windows user experience and with other apps. This release of the Windows App SDK is focused on supporting unpackaged apps on x86 and x64. Keep an eye out for ARM64 support, which will be added in the next stable release.

To see everything that's new, see the 1.0 stable release notes.

To get started:

· Install developer tools .

· Create a WinUI 3 app.

· Continue your development journey.

What's next

To keep up with the Windows App SDK roadmap, vote on features, and see everything we are planning, please see our productboard portal, which gets updated regularly.

Windows App SDK 0.8.6-preview1 is now available

Windows App SDK 0.8.6-preview1 is a preview release that includes several C#/WinRT performance improvements. If you are building a Windows App SDK app with C#/.NET, you can try out this preview release to assess performance improvements. These performance updates will also be available in a future stable servicing release to Windows App SDK 0.8 and 1.0.

Updating to this version

• If you are already using the Windows App SDK 0.8 and would like to update to this preview release, you can do so by following the update instructions here. The instructions for updating between 0.8 Preview to 0.8 Stable or between stable 0.8 versions still apply.

• You will also need to add the WindowsSdkPackageVersion property to your *.csproj to override the Windows SDK projection version:

<PropertyGroup>
    <WindowsSdkPackageVersion>10.0.<sdk_version>.22-preview</WindowsSdkPackageVersion>
</PropertyGroup>

This preview version of the Windows SDK projection will be available in an upcoming .NET 5 and .NET 6 SDK servicing release. After this .NET SDK update is available, you should remove the property from your project file.

Updates in Windows App SDK 0.8.6-preview1

This preview release includes performance improvements for C#/.NET applications. Details on these performance improvements are listed in the C#/WinRT 1.4.0-prerelease release notes.

1.0 Preview 3 Release of Windows App SDK

We've just released the latest version of 1.0 Preview 3 of the Windows App SDK. This is the first version that adds Windows 11 styles to WinUI 3! This release includes new features, bug fixed, and provide access to APIs and features we are intending to include in the next 1.0 stable release that's coming out very soon!

What's new

This release of WinUI 3 is focused on supporting unpackaged apps on x86 and x64. Please view Instructions for WinUI 3 unpackaged desktop apps to configure your WinUI 3 application to support unpackaged deployment. Keep an eye for ARM64 support that will be added in the next stable release.

• If you're building an app with the Windows App SDK for the first time, follow the getting started instructions here.

To see everything that's new and changed, see the full release notes here. For installation instructions, see Set up your development environment.

What's next

To keep up with progress being made on the Windows App SDK, please see our feature roadmap, which gets updated regularly.

Windows App SDK 0.8.5 is now available

Windows App SDK 0.8.5 is a stable servicing release that continues to fix critical bugs for 0.8.0.

• If you're building an app with the Windows App SDK for the first time, follow the installation instructions here.
• If you are already using the Windows App SDK 0.8 and would like to update to the latest release, you can do so by following the update instructions here.

Bug fixed in Windows App SDK 0.8.5:

• Fixed issue that was causing WinUI apps to crash related to pointer input.
• Fixed issue causing the title bar buttons (min, max, close) to not have rounded corners on Windows 11.
• Fixed issue causing the resizing layout options to not appear when hovering over maximize/restore button in app on Windows 11.
• Fixed issue causing a crashing exception where creating a PointCollection object. For more information, see issue 971 on Github.

1.0 Preview 2 Release of Windows App SDK

WARNING: Versions 1.0 Preview 1 and 2 of the Windows App SDK contain a critical bug that corrupts your system’s PATH variable. We are fixing this in the upcoming 1.0 Preview 3 release. If you’ve already installed one of these previews, see this GitHub thread for how to resolve the issue: https://github.com/microsoft/WindowsAppSDK/issues/1599. Until Preview 3 is available, we recommend using version 1.0 Experimental or being aware of this issue and how it might impact your work.

We've just released version 1.0 Preview 2 of the Windows App SDK. This is the first version that adds Windows 11 styles to WinUI 3! And single-project MSIX project templates are now included with the VSIX, so you can easily create a new packaged project that uses one single project! There are a few known issues around single-project MSIX documented in the release notes. This is a great opportunity to try out what's new and provide feedback before the 1.0 Stable (GA) release!

• If you're building an app with the Windows App SDK for the first time, follow the getting started instructions here.

• Install the C# or C++ extensions for the 1.0 Preview 2 release.

To see everything that's new and changed, see the full release notes here.

What's next

To keep up with progress being made on the Windows App SDK, please see our feature roadmap, which gets updated regularly.

Windows App SDK 0.8.4 is now available

Windows App SDK 0.8.4 is a stable servicing release that continues to fix critical bugs for 0.8.0.

• If you're building an app with the Windows App SDK for the first time, follow the installation instructions here.
• If you are already using the Windows App SDK 0.8 and would like to update to the latest release, you can do so by following the update instructions here.

Bug fixed in Windows App SDK 0.8.4:

• Fixes for custom title bars so that ContentDialog doesn't cover it up, and the title bar buttons are rounded.
• Fix for a crash in image processing when the display scale is changed.
• Fixes clipping bugs where UI disappear or clipped incorrectly

1.0 Preview 1 Release of Windows App SDK

WARNING: Versions 1.0 Preview 1 and 2 of the Windows App SDK contain a critical bug that corrupts your system’s PATH variable. We are fixing this in the upcoming 1.0 Preview 3 release. If you’ve already installed one of these previews, see this GitHub thread for how to resolve the issue: https://github.com/microsoft/WindowsAppSDK/issues/1599. Until Preview 3 is available, we recommend using version 1.0 Experimental or being aware of this issue and how it might impact your work.

We've just released our first preview of the 1.0 release of the Windows App SDK! This preview is our first release that converges our NuGet packages to one single package, reducing clutter in your projects and making it easier to update to future versions! Additionally, the AppInstance APIs are now available to C# apps! This is an awesome opportunity to try out what's new and provide feedback.

If you're building an app with the Windows App SDK for the first time, follow the getting started instructions here.

Install the C# or C++ extensions for the 1.0 Preview 1 release.

Full release notes here.

What's next

To keep up with progress being made on the Windows App SDK, please see our feature roadmap, which gets updated regularly. __