v1.0.3

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.

v1.0.2

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.

0.8.7

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."

v1.1.0-preview1

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.

1.0.1

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.

0.8.7-preview1 is now Live!

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.

0.8.6 is now LIVE!

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.0

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.

0.8.6-preview 1 is now Live!

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 is LIVE!

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.