{"id":47062,"date":"2023-08-29T10:00:00","date_gmt":"2023-08-29T17:00:00","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/dotnet\/?p=47062"},"modified":"2025-05-20T08:20:35","modified_gmt":"2025-05-20T15:20:35","slug":"upgrade-assistant-august-2023-update","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/dotnet\/upgrade-assistant-august-2023-update\/","title":{"rendered":"New .NET Upgrade Assistant version with feature updates and .NET MAUI improvements!"},"content":{"rendered":"

<\/i>UPDATED: Upgrade Assistance with GitHub Copilot<\/strong><\/p>Please visit https:\/\/devblogs.microsoft.com\/dotnet\/github-copilot-upgrade-dotnet\/<\/a> to learn more about the very latest updates leveraging GitHub Copilot to accelerate your upgrades for .NET!<\/div><\/p>\n

We are happy to announce that we have released a new version of .NET Upgrade Assistant<\/a> in Visual Studio that adds the ability to update features of your projects without changing the target framework and has lots of improvements for migrating to .NET MAUI!<\/p>\n

The .NET Upgrade Assistant is a tool that helps you upgrade your application to the latest .NET and migrate from older platforms such as Xamarin Forms and UWP to newer offerings. With this new version of the tool you can also upgrade project features without changing the .NET version.<\/p>\n

What’s new in this version<\/h2>\n

Upgrading project features<\/h3>\n

We have received feedback that in some cases you wanted to decouple .NET version upgrades from other types of upgrades, for example a very popular request was to enable conversion of the old style project file to the new SDK-style project file without changing the .NET framework version, so you can take an iterative approach in modernizing your applications. Now on the first page of Upgrade Assistant, if there are any projects features upgrades available for your project, you will see two options:\nUpgrade project to a newer .NET version<\/strong> and Upgrade project features<\/strong>.<\/p>\n

\"Upgrade<\/p>\n

While the first option leads you to the same experience you’ve seen in the previous versions of Upgrade Assistant that will help you upgrade your .NET version, the second introduces the new functionality we’ve added in this release. Once you click on Upgrade project features<\/strong> you’ll see upgrades available for your project.<\/p>\n

\"Upgrade<\/p>\n

Currently there is only one type available – upgrade to SDK-style project file, but we are planning on adding more types here in the future, so do let us know what kind of upgrades you need for your apps (see the section Give us feedback!<\/strong> below).<\/p>\n

Note that if your project file is already SDK-style, the first page with two options won’t be shown to you, and only the .NET version upgrade scenario will be offered.<\/p>\n

When you click Next<\/strong>, the Upgrade Assistant will convert your project file to the new style while the target framework for your project will remain unchanged.<\/p>\n

\"Result<\/p>\n

You can see the project file before and after the upgrade.<\/p>\n

\"Project<\/p>\n

Updates in .NET MAUI migration<\/h3>\n

We have added many improvements into the .NET MAUI area!<\/p>\n

First of all, now you can upgrade your apps on macOS as well using the CLI version<\/a> of the .NET Upgrade Assistant.<\/p>\n

If you prefer to upgrade your Xamarin.Forms to .NET MAUI manually, we have added automatic code fixers to help you update your code. Now you can paste your Xamarin.Forms files into a .NET MAUI project and our new Upgrade Assistant C# analyzer will offer to fix your code to make it compatible with .NET MAUI. You can see a light bulb near Xamarin namespaces that offers to fix the entire document or optionally project or solution.<\/p>\n

\"Upgrade<\/p>\n

Besides these two big features we have added numerous bug fixes and infrastrucrure improvements to make the upgrades to .NET MAUI even better. And we will continue work in this area.<\/p>\n

What\u2019s next<\/h2>\n

We will continue working on improving the quality of upgrades, adding more feature upgrades, improving migration for .NET MAUI and addressing your feedback.<\/p>\n

Learn how to upgrade<\/h2>\n

We have lots of materials to help you with your upgrade process:<\/p>\n