0.5.9

0.5.9 Windows App SDK Release

This release is a stable servicing release that includes a security fix. For more information, please check it all here.

Check all our new and updated features, limitations, and known issues for this release on our full release notes here.

What's next

To keep up with progress being made on Windows App SDK, please see our feature roadmap which gets updated regularly. We also give monthly updates on our Windows App SDK Community Calls, where you can directly ask the team any questions you have.

1.0 Experimental (1.0.0-exp)

1.0 Experimental (1.0.0-exp)

We've just released our 1.0 experimental release of Windows App SDK! This is the latest release of the experimental channel that supports all experimental channel features. This release includes bug fixes and provides access to non-stable APIs and features for WinUI3, Push notifications, Windowing, and Deployment of unpackaged apps.

Check all our new and updated features, limitations, and known issues for this release on our full release notes here.

What's next

To keep up with progress being made on Windows App SDK, please see our feature roadmap which gets updated regularly. We also give monthly updates on our Windows App SDK Community Calls, where you can directly ask the team any questions you have.

Attached are the Windows App SDK Installer and MSIX packages needed to test deployment of unpackaged apps or you can find it here.

0.8.1

Windows App SDK 0.8.1 is a stable servicing release that fixes a few critical bugs.

Bugs fixed in Windows App SDK 0.8.1:

• Windows App SDK cannot run on latest Insider build
• Crash in editable ComboBox when entering a value that does not appear in dropdown
• WebView2 doesn't allow user to tab out once focused has been received
• Fully qualify Windows.Foundation.Metadata.DefaultOverload namespace in WinUI generated code to avoid namespace ambiguity
  • This fixes bug #5108.
• Security fix – see CVE-2021-34489 for more details.

The limitations and known issues for v0.8 also apply to v0.8.1, unless marked otherwise in our documentation.

0.8.0

We just released the 0.8 GA release of Windows App SDK formerly known as Project Reunion! This release consists of stabilization improvements, critical bug fixes, and some new functionality. This is an opportunity for our customers to try this out and provide feedback.

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

Full release notes here.

NOTE: This release is not supported on the current Windows Insider Dev channel. We will be fixing this issue in our first 0.8 servicing release coming soon.

Attached are the Windows App SDK Installer and MSIX packages needed to test deployment of unpackaged apps.

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

NOTE: The Windows App SDK was previously known by the code name Project Reunion. Some SDK assets such as the VSIX extension and NuGet packages still use the code name, but these assets will be renamed in a future release. Some areas of the docs still use Project Reunion when referring to an existing asset or a specified earlier release.

0.8 RC

We're getting close to releasing the stable version of 0.8, and have a release candidate available to try! 🎊 This release candidate does not contain experimental features, as it is an early candidate for the final release. This release candidate contains several new bug fixes compared to the previous 0.8 Preview. This RC is NOT published on NuGet.org, you can find the packages and VSIX attached at the bottom.

What's new

These are all of the new changes in Project Reunion since the release of Project Reunion 0.5.

• The Pivot control has been added back in and can now be used in any WinUI 3 app.

• All bug fixes from Project Reunion v0.5.5, v0.5.6, and v0.5.7 are included with this release.

• New bug fixes, including:

  • Mouse right-click in TextBox crashes the application
  • NavigationView causes crash in UWP, Reunion 0.5 Preview
  • ProgressBar doesn't show difference between Paused and Error option
  • Crash in RichEditBox when copying/pasting/changing text style
  • Window caption buttons are misplaced when SetTitleBar is not set or null

  To see the full list of bugs fixed, see the bugs fixed section below.

• The ColorHelper.ToDisplayName API is no longer available.

• The following types have been removed:

  • Microsoft.Graphics.IGeometrySource2D
  • Microsoft.Graphics.IGeometrySource2DInterop

  Please use Windows.Graphics.IGeometrySource2D and Windows.Graphics.IGeometrySource2DInterop instead.

• All types in the Microsoft.System namespace have been moved to the Microsoft.UI.Dispatching namespace, including the DispatcherQueue class.

• The AcrylicBrush.BackgroundSource property has been removed, since HostBackdrop is not supported as a BackgroundSource in WinUI 3.

Experimental features

This release does not include experimental features. If you'd like to continue using experimental features in your app, feel free to continue using the latest Project Reunion 0.8 Preview.

Known issues

Please keep in mind that the Project Reunion 0.8 release candidate is still a pre-release product, and has a number of known issues and limitations that our team continues to work on:

• WinUI 3 tooling such as Live Visual Tree, Live Property Explorer, and Hot Reload are currently not supported for the 0.8 release candidate. You can expect to see support for these features in Visual Studio 2019 16.11 Preview 3.
• Apps currently using WinUI 3 and Project Reunion 0.8 RC will not be able to use class libraries that are using Project Reunion 0.5. Please update the class libraries to use Project Reunion 0.8 RC.

Known issues carried over from previous releases...

• No support for Any CPU build configuration: Project Reunion is written in native code and thus does not support Any CPU build configurations. The WinUI project templates only allow architecture-specific builds. When adding Project Reunion to an existing .NET application or component that supports Any CPU, you must specify the desired architecture: x86, x64 or arm64.
• #921: .NET apps must target build 18362 or higher: Your TFM must be set to net5.0-windows10.0.18362 or higher, and your packaging project's must be set to 18362 or higher. For more info, see #921
• #922: Cannot build class library using Project Reunion, AnyCPU error. See #922 for workaround.
• microsoft/microsoft-ui-xaml#4926: NullReferenceException in ABI.Microsoft.UI.Xaml.Data.ICustomProperty

Bugs fixed in 0.8 RC

This is the list of all bugs fixed since the 0.8 Preview. For a list of bugs previously fixed in the Project Reunion 0.8 Preview, see this list.

• #923: Building class library with XAML controls in Release config fails
• Fix tooltip to get the current pointer position rather than using the last seen pointer ID
• microsoft/microsoft-ui-xaml#4197: Change in Appearance of AppBarButton with Flyout on CommandBar in WinUI3
• Crash in shadows code when device goes on low-battery
• microsoft/microsoft-ui-xaml#3001: EffectiveViewport does not work in certain cases for WinUI desktop apps
• microsoft/microsoft-ui-xaml#3658: Rotation in Manipulation events is wrong
• Crash in RichEditBox when copying/pasting/changing text style
• microsoft/microsoft-ui-xaml#4536: Padding of Minimize/Maximize/Close Buttons is Not Consistent When Using ExtendsContentIntoTitleBar

Get started

This release candidate is NOT published on NuGet.org or the Visual Studio Marketplace. You'll need to download the assets attached below. Here's two quick key things to note...

• This RC requires dev mode (sideloading) enabled on PCs your app runs on (the stable release won't). But you probably already have dev mode enabled anyways since it's required to deploy your locally built WinUI 3 packaged apps 😉
• This RC requires .NET SDK version 5.0.300 or later if using VS 16.10, or .NET SDK version 5.0.204 or later if using VS 16.9

Upgrading an existing 0.8 Preview app

To upgrade from 0.8 Preview, simply update to use the attached NuGet packages!

1. Download and unzip the attached NuGet packages to a folder of your choice (like the Downloads folder).
2. Open your project in Visual Studio.
3. Open the NuGet Package Manager in Visual Studio, and configure a NuGet package source to point to the folder you unzipped the NuGet packages in (near the top right where it says "Package source", click the settings icon and add a new package source pointing to your folder, then after saving that, be sure to select that package source).
4. Go to the Updates tab, check the "Include prerelease" option, and you should see the 0.8.0-rc Project Reunion NuGet packages as an available update, install those updates to all three packages. You're now on 0.8.0-rc! Be sure to update all projects in your solution (don't mix and match versions in a single solution).
5. If your initial build fails, you may need to clean your solution first and then try building again.

Upgrading an existing 0.5 app

Follow the instructions above for updating a 0.8 Preview app, and additionally move the <AssetTargetFallback> property in the packaging project to be below the <TargetPlatformMinVersion> property. Your packaging project should look like this...

...
    <TargetPlatformVersion>10.0.19041.0</TargetPlatformVersion>
    <TargetPlatformMinVersion>10.0.17763.0</TargetPlatformMinVersion>
    <AssetTargetFallback>net5.0-windows$(TargetPlatformVersion);$(AssetTargetFallback)</AssetTargetFallback>
...

Building a new app with 0.8 RC

1. Be using latest stable VS 16.10 with all typical Project Reunion prerequisites installed.
2. Download and install the attached VSIX below (if you have the previous Project Reunion non-Preview VSIX installed, this will replace it).
3. Open VS and create a new "Blank App, Packaged (WinUI 3 in Desktop)" app.
4. Download and unzip the attached NuGet packages to a folder of your choice (like the Downloads folder).
5. Open the NuGet Package Manager in Visual Studio, and configure a NuGet package source to point to the folder you downloaded the NuGet (near the top right where it says "Package source", click the settings icon and add a new package source pointing to your folder.
6. Build and run your app!

There are some more detailed getting started instructions here, although those instructions are for the 0.5 release and you will have to tweak things slightly as described above.

To keep up with progress being made on Project Reunion, please see our feature roadmap which gets updated regularly.

0.8 Preview

We've just released our preview of the 0.8 release of Project Reunion! This is the first release of Project Reunion that includes unpackaged app support for DWrite Core, App Lifecycle, and MRT Core. This release consists of stabilization improvements, critical bug fixes, and some new functionality. This is an opportunity for our customers to try this out and provide feedback.

If you're building an app with Project Reunion for the first time, follow the getting started instructions here.

Full release notes here.

Attached are the Project Reunion Installer and MSIX packages needed to test deployment of unpackaged apps. This preview is not intended for production apps.

To keep up with progress being made on Project Reunion, please see our feature roadmap which gets updated regularly.

0.5.7

Project Reunion 0.5.7 is a new servicing release that continues to fix a couple of critical bugs from Project Reunion 0.5.

If you're building an app with Project Reunion for the first time, follow the installation instructions here.

If you have an app that's already using any version of Project Reunion 0.5, you can update to the latest release by following the instructions here.

Bugs fixed in Project Reunion 0.5.7

• Crash in ListView when scrolling with pen

• Padding of Minimize/Maximize/Close Buttons is Not Consistent When Using ExtendsContentIntoTitleBar

• WinUI 3 Desktop apps always show focus rects on launch, even if the app was launched via mouse/touch/pen

• UIA isn't properly handling display scale value

v0.5.8 is now available!

v0.5.8 is now available!

Version 0.5.8 is a new servicing release that includes a security fix for Project Reunion 0.5.

For more details, see CVE-2021-34489.

0.5.6 Servicing Release is now LIVE!

Project Reunion 0.5.6 is now available

Project Reunion 0.5.6 is a small, stable servicing update that fixes a few more critical bugs.
If you're building an app with Project Reunion for the first time, follow the installation instructions here.
If you have an app that's already using any version of Project Reunion 0.5, you can update to the latest release by following the instructions here.

Bugs fixed in Project Reunion 0.5.6:

• Metadata is missing from attributes. The bug fixed can be found here.
• Crashes caused by XamlCompiler determining all types are not a part of WinUI framework. The bug fixed can be found here.

0.5.5

Project Reunion 0.5.5 is a stable servicing release that fixes a few critical bugs.

If you're building an app with Project Reunion for the first time, follow the installation instructions here.

If you have an app that's already using Project Reunion 0.5, you can update to the latest release by following the instructions here.

Bugs fixed in Project Reunion 0.5.5:

• Memory leaks caused by subscribing to some framework element events and page navigation due to a C#/WinRT issue

• Alt+F4 does not close desktop apps

• Drag and drop does not work with touch or pen due to an issue with StartDragAsync()

• Black flash on WebView2 when setting Visibility to Collapsed

• Microsoft.ProjectReunion.Foundation is breaking WPF compilations

• Installing the Project Reunion 0.5 NuGet package results in build failures in projects that target AnyCPU

• Crash when panel containing SwapChainPanel is opened multiple times

• Acrylic brush renders transparent

• A few bugs having to do with GC/ObjectDisposedExceptions, marshaling value and nullable types (TimeSpan, IReference, etc) in C#/WinRT are now fixed. In order to get these GC fixes, you must use the latest .NET 5.0.6 SDK which will be available in May. See our update instructions for how you can explicitly reference the latest 5.0.6 SDK.