Skip to content
25 changes: 5 additions & 20 deletions docs/core/porting/upgrade-assistant-uwp-framework.md
Original file line number Diff line number Diff line change
@@ -1,27 +1,12 @@
---
title: Upgrade UWP apps to .NET 6
description: Use the .NET Upgrade Assistant to migrate a C# UWP app to a Windows UI Library (WinUI) 3 app that uses the Windows App SDK. The .NET Upgrade Assistant is a CLI tool.
title: Migrate from UWP to Windows App SDK with the .NET Upgrade Assistant
description: The .NET Upgrade Assistant is a Visual Studio extension (preferred), and a command-line tool, that's designed to assist with upgrading apps to the latest version of .NET.
author: adegeo
ms.date: 09/20/2022
ms.date: 06/02/2023
---

# Migrate UWP apps to Windows App SDK with the .NET Upgrade Assistant
# Migrate from UWP to the 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](upgrade-assistant-install-legacy.md).

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](/windows/apps/winui/) app that uses the Windows App SDK.
The .NET Upgrade Assistant is a Visual Studio extension (recommended), and a command-line tool, that can assist with migrating a C# Universal Windows Platform (UWP) app to a [Windows UI Library (WinUI) 3](/windows/apps/winui/) app that uses the Windows App SDK.

For full details, see [Migrate from UWP to the Windows App SDK with the .NET Upgrade Assistant](/windows/apps/windows-app-sdk/migrate-to-windows-app-sdk/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:

```console
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](/windows/apps/windows-app-sdk/migrate-to-windows-app-sdk/upgrade-assistant) for full details.