Releases: microsoft/WindowsAppSDK
v1.0.4
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
v1.1.0
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:
What's next
To keep up with progress being made on the Windows App SDK, please see our feature roadmap.
v0.8.10
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.".
v1.1.0-preview3
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.
v0.8.8
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.".
v1.1.0-preview2
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.
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.