Skip to content

Commit 1db7dbf

Browse files
WinAppSDK 1.3.0 release notes (new) (#3514)
* Downloads and bones for 1.3.0 release notes * Add 1.3 specific release notes * Fix error message formatting, dates, build number * Fix latest download link * Update stable-channel.md --------- Co-authored-by: Steven White <[email protected]>
1 parent e6cd7b9 commit 1db7dbf

File tree

4 files changed

+51
-3
lines changed

4 files changed

+51
-3
lines changed

hub/apps/windows-app-sdk/downloads.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ ms.localizationpriority: medium
1414
This page provides download links to the *latest* releases of the [Windows App SDK](index.md) in the three release channels (stable, preview, and experimental). To get started quickly, download the latest x64 installer below. Or, for older releases, see [Older downloads for the Windows App SDK](./older-downloads.md).
1515

1616
> [!div class="button" style="text-align: left;" width="150px;"]
17-
> [Download the latest x64 stable installer (1.2.5)](https://aka.ms/windowsappsdk/1.2/latest/windowsappruntimeinstall-x64.exe)
17+
> [Download the latest x64 stable installer (1.3.0)](https://aka.ms/windowsappsdk/1.3/latest/windowsappruntimeinstall-x64.exe)
1818
1919
For all the latest Windows App SDK downloads, refer to the tables and links below. To learn more, see [Windows App SDK release channels](release-channels.md) and the release notes provided below for each version.
2020

@@ -23,7 +23,7 @@ For all the latest Windows App SDK downloads, refer to the tables and links belo
2323

2424
| Version | Runtime downloads |
2525
|---|---|
26-
| [1.2.5 (1.2.230313.1) ](stable-channel.md#version-125-122303131) <br> 03/15/2023 <br> [Release notes](stable-channel.md) | [Installer (x64)](https://aka.ms/windowsappsdk/1.2/1.2.230313.1/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/1.2/1.2.230313.1/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/1.2/1.2.230313.1/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable](https://aka.ms/windowsappsdk/1.2/1.2.230313.1/Microsoft.WindowsAppRuntime.Redist.1.2.zip) |
26+
| [1.3.0 (1.3.230331000)](stable-channel.md#version-13-stable) <br> 04/12/2023 <br> [Release notes](stable-channel.md#version-13-stable) | [Installer (x64)](https://aka.ms/windowsappsdk/1.3/1.3.230331000/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/1.3/1.3.230331000/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/1.3/1.3.230331000/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable](https://aka.ms/windowsappsdk/1.3/1.3.230331000/Microsoft.WindowsAppRuntime.Redist.1.3.zip) |
2727

2828
## Preview release
2929
### Windows App SDK 1.3 Preview1

hub/apps/windows-app-sdk/older-downloads.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,7 @@ To learn more, see the [Windows App SDK release channels](release-channels.md) a
3838

3939
| Version | SDK downloads | Runtime downloads |
4040
|---|---|---|
41+
| [1.2.5 (1.2.230313.1) ](stable-channel.md#version-125-122303131) <br> 03/15/2023 <br> [Release notes](stable-channel.md) | [Installer (x64)](https://aka.ms/windowsappsdk/1.2/1.2.230313.1/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/1.2/1.2.230313.1/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/1.2/1.2.230313.1/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable](https://aka.ms/windowsappsdk/1.2/1.2.230313.1/Microsoft.WindowsAppRuntime.Redist.1.2.zip) |
4142
| [1.2.4 (1.2.230217.4) ](stable-channel.md#version-124-122302174) <br> 02/22/2023 <br> [Release notes](stable-channel.md) | [C# Visual Studio 2022 extension](https://aka.ms/windowsappsdk/1.2/1.2.230217.4/WindowsAppSDK.Cs.Extension.Dev17.Standalone.vsix)<br/>[C++ Visual Studio 2022 extension](https://aka.ms/windowsappsdk/1.2/1.2.230217.4/WindowsAppSDK.Cpp.Extension.Dev17.Standalone.vsix) | [Installer (x64)](https://aka.ms/windowsappsdk/1.2/1.2.230217.4/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/1.2/1.2.230217.4/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/1.2/1.2.230217.4/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable](https://aka.ms/windowsappsdk/1.2/1.2.230217.4/Microsoft.WindowsAppRuntime.Redist.1.2.zip) |
4243
| [1.2.3 (1.2.230118.102) ](stable-channel.md#version-123-12230118102) <br> 01/25/2023 <br> [Release notes](stable-channel.md) | [C# Visual Studio 2022 extension](https://aka.ms/windowsappsdk/1.2/1.2.230118.102/WindowsAppSDK.Cs.Extension.Dev17.Standalone.vsix)<br/>[C++ Visual Studio 2022 extension](https://aka.ms/windowsappsdk/1.2/1.2.230118.102/WindowsAppSDK.Cpp.Extension.Dev17.Standalone.vsix) | [Installer (x64)](https://aka.ms/windowsappsdk/1.2/1.2.230118.102/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/1.2/1.2.230118.102/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/1.2/1.2.230118.102/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable](https://aka.ms/windowsappsdk/1.2/1.2.230118.102/Microsoft.WindowsAppRuntime.Redist.1.2.zip) |
4344
| [1.2.2 (1.2.221209.1) ](stable-channel.md#version-122-122212091) <br> 12/14/2022 <br> [Release notes](stable-channel.md) | [C# Visual Studio 2022 extension](https://aka.ms/windowsappsdk/1.2/1.2.221209.1/WindowsAppSDK.Cs.Extension.Dev17.Standalone.vsix)<br/>[C++ Visual Studio 2022 extension](https://aka.ms/windowsappsdk/1.2/1.2.221209.1/WindowsAppSDK.Cpp.Extension.Dev17.Standalone.vsix) | [Installer (x64)](https://aka.ms/windowsappsdk/1.2/1.2.221209.1/windowsappruntimeinstall-x64.exe) <br/> [Installer (x86)](https://aka.ms/windowsappsdk/1.2/1.2.221209.1/windowsappruntimeinstall-x86.exe) <br/> [Installer (arm64)](https://aka.ms/windowsappsdk/1.2/1.2.221209.1/windowsappruntimeinstall-arm64.exe) <br/> [Redistributable](https://aka.ms/windowsappsdk/1.2/1.2.221209.1/Microsoft.WindowsAppRuntime.Redist.1.2.zip) |

hub/apps/windows-app-sdk/release-channels.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,7 @@ The Windows App SDK has a lifecycle. A lifecycle begins when a version or servic
5050

5151
| Windows App SDK version | Original release date | Latest patch version | Patch release date | Support level | End of servicing |
5252
|-------------------------|-----------------------|----------------------|--------------------|---------------|---------------- |
53+
| 1.3 | 04/12/2023 | 1.3.230331000 | N/A | Current | 04/04/2024 |
5354
| 1.2 | 11/10/2022 | 1.2.230313.1 | 03/15/2023 | Current | 11/10/2023 |
5455
| 1.1 | 05/24/2022 | 1.1.5 | 09/14/2022 | Maintenance | 05/24/2023 |
5556
| 1.0 | 11/16/2021 | 1.0.4 | 06/14/2022 | Maintenance | 11/16/2022 |

hub/apps/windows-app-sdk/stable-channel.md

Lines changed: 47 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@ The stable channel provides releases of the Windows App SDK that are supported f
1515

1616
The following releases of the stable channel are currently available:
1717

18+
- [Version 1.3](#version-13)
1819
- [Version 1.2](#version-12)
1920
- [Version 1.1](#version-11)
2021
- [Version 1.0](#version-10)
@@ -30,6 +31,51 @@ The Windows App SDK VSIX and runtime (installer and MSIX packages) are available
3031
> [!NOTE]
3132
> If you have Windows App SDK Visual Studio extensions (VSIX) already installed, then uninstall them before installing a new version. For directions, see [Manage extensions for Visual Studio](/visualstudio/ide/finding-and-using-visual-studio-extensions).
3233
34+
## Version 1.3
35+
36+
### Version 1.3 Stable
37+
38+
The following sections describe new and updated features and known issues for 1.3 Stable.
39+
40+
In an existing Windows App SDK 1.2 Stable app, you can update your Nuget package to 1.3.230320000 (see the **Update a package** section in [Install and manage packages in Visual Studio using the NuGet Package Manager](/nuget/consume-packages/install-use-packages-visual-studio#update-a-package)).
41+
42+
For the updated runtime and MSIX, see [Downloads for the Windows App SDK](./downloads.md).
43+
44+
### XAML Backdrop APIs
45+
With properties built in to the XAML Window, Mica & Background Acrylic backdrops are now easier to use in your WinUI 3 app.
46+
See the [System Backdrop](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.media.systembackdrop) and [Mica Backdrop](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.media.micabackdrop) API docs for more information about the Xaml Backdrop properties.
47+
48+
```csharp
49+
public MainWindow()
50+
{
51+
this.InitializeComponent();
52+
53+
this.SystemBackdrop = new MicaBackdrop();
54+
}
55+
```
56+
57+
### Window.AppWindow
58+
Replacing several lines of boilerplate code, you're now able to use AppWindow APIs directly from an **Window** through [`Window.AppWindow`](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.window.appwindow).
59+
60+
### New features from across WinAppSDK
61+
- `ApplicationModel.DynamicDependency`: `PackageDependency.PackageGraphRevisionId` that replaces the deprecated MddGetGenerationId.
62+
- Environment Manager: [`EnvironmentManager.AreChangesTracked`](/windows/windows-app-sdk/api/winrt/microsoft.windows.system.environmentmanager.arechangestracked) to inform you whether changes to the environment manager are able to be tracked in your application.
63+
- MRT Core: A new event, `Application.ResourceManagerInitializing` allows your app to provide its own implementation of the `IResourceManager` interface, and gives you access to the ResourceManager that WinUI uses to resolve resource URIs. See the [IResourceManager API spec](https://github.com/microsoft/microsoft-ui-xaml/blob/user/evelynwu/custom-iresourcemanager-spec/specs/custom-iresourcemanager-spec.md) on GitHub for more information.
64+
65+
### Other updates
66+
- See our [WinAppSDK 1.3 milestone](https://github.com/microsoft/WindowsAppSDK/milestone/14?closed=1) on the [WinAppSDK GitHub](https://github.com/microsoft/WindowsAppSDK) for additional issues addressed in this release.
67+
- See our [WinUI 3 in WinAppSDK 1.3 milestone](https://github.com/microsoft/microsoft-ui-xaml/milestone/18?closed=1) on the [microsoft-ui-xaml GitHub](https://github.com/microsoft/microsoft-ui-xaml) for additional issues addressed in this release.
68+
- With the latest experimental VSIX, you're now able to convert your app between unpackaged and packaged through the Visual Studio menu instead of in your project file.
69+
70+
### Known issue
71+
Due to a recent change to the xaml compiler, an existing project that upgrades to 1.3 may experience a build error like the following within Visual Studio:
72+
73+
```console
74+
> C:\Users\user\\.nuget\packages\microsoft.windowsappsdk\\**1.3.230331000**\buildTransitive\Microsoft.UI.Xaml.Markup.Compiler.interop.targets(537,17): error MSB4064: The "PrecompiledHeaderFile" parameter is not supported by the "CompileXaml" task loaded from assembly: Microsoft.UI.Xaml.Markup.Compiler, Version=1.0.0.0, Culture=neutral, PublicKeyToken=de31ebe4ad15742b from the path: C:\Users\user\\.nuget\packages\microsoft.windowsappsdk\\**1.2.230118.102**\tools\net472\Microsoft.UI.Xaml.Markup.Compiler.dll. Verify that the parameter exists on the task, the <UsingTask> points to the correct assembly, and it is a settable public instance property.
75+
```
76+
77+
This is caused by Visual Studio using a cached xaml compiler task dll from 1.2, but driving it with incompatible MSBuild logic from 1.3, as seen in the error text above. The workaround is to shut down Visual Studio, restart it, and reload the solution.
78+
3379
## Version 1.2
3480

3581
### Version 1.2.5 (1.2.230313.1)
@@ -934,4 +980,4 @@ This release has the following limitations and known issues:
934980
- [Install tools for the Windows App SDK](set-up-your-development-environment.md)
935981
- [Create your first WinUI 3 project](../winui/winui3/create-your-first-winui3-app.md)
936982
- [Use the Windows App SDK in an existing project](use-windows-app-sdk-in-existing-project.md)
937-
- [Deploy apps that use the Windows App SDK](../package-and-deploy/index.md#use-the-windows-app-sdk)
983+
- [Deploy apps that use the Windows App SDK](../package-and-deploy/index.md#use-the-windows-app-sdk)

0 commit comments

Comments
 (0)