Migrate UWP apps to Windows App SDK with the .NET Upgrade Assistant

The .NET Upgrade Assistant is a command-line tool that can assist with migrating a C# Universal Windows Platform (UWP) app to a Windows UI Library (WinUI) 3 app that uses the Windows App SDK.

For full details, see Migrate from UWP to the Windows App SDK with the .NET Upgrade Assistant in the Windows App SDK migration documentation.

You can also visit the Upgrade Assistant GitHub repository.

Running the tool

To use the .NET Upgrade Assistant to migrate a C# UWP app to a WinUI 3 app, you issue the command upgrade-assistant upgrade, and pass in the name of the project or solution you want to migrate. For example:

upgrade-assistant upgrade PhotoLab.sln

As it runs, the tool lists out the steps and stages in the migration process that it will carry out. It also provides migration guidance in the form of warning messages within the tool's output, and Task List TODOs in the form of comments within your project's source code. And as the developer, you're always in control of the migration process.

Next, visit Migrate from UWP to the Windows App SDK with the .NET Upgrade Assistant for full details.