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

Important

This article was written before the release of the Upgrade Assistant extension for Visual Studio and it uses the legacy CLI tool. For more information, see Use the legacy .NET Upgrade Assistant.

The .NET Upgrade Assistantis 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.

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.