try-convert

Disclaimer

As with all previous releases, this is not a supported Microsoft product. See here for more info: https://github.com/dotnet/try-convert#support-policy

Changelog

• Initial support for converting Xamarin.Forms --> .NET MAUI by @Sweekriti91

How To Install

0. Be on a Windows machine and have the latest .NET SDK (get it here)
1. Install the tool using the following command.

dotnet tool install -g try-convert

How to update

dotnet tool update -g try-convert

And in the future:

try-convert --update

How To Uninstall

You can uninstall the tool using the following command.

dotnet tool uninstall -g try-convert

Disclaimer

As with all previous releases, this is not a supported Microsoft product. See here for more info: https://github.com/dotnet/try-convert#support-policy

Changelog

• Add support for -u|--update switch to support easily updating the tool, by @Johnmancini30
• Bug fixes!

How To Install

0. Be on a Windows machine and have the latest .NET SDK (get it here)
1. Install the tool using the following command.

dotnet tool install -g try-convert

How to update

dotnet tool update -g try-convert

And in the future:

try-convert --update

How To Uninstall

You can uninstall the tool using the following command.

dotnet tool uninstall -g try-convert

Disclaimer

As with all previous releases, this is not a supported Microsoft product. See here for more info: https://github.com/dotnet/try-convert#support-policy

Changelog

• Update AddDesktopProperties to add desktop props for all project styles if they have desktop references, by @mjrousos

How To Install

0. Be on a Windows machine and have the latest .NET SDK (get it here)
1. Install the tool using the following command.

dotnet tool install -g try-convert

How to update

dotnet tool update -g try-convert

How To Uninstall

You can uninstall the tool using the following command.

dotnet tool uninstall -g try-convert

Disclaimer

As with all previous releases, this is not a supported Microsoft product. See here for more info: https://github.com/dotnet/try-convert#support-policy

Changelog

• Enhancements for VB.NET Windows Forms conversions
• Bug fixes

How To Install

0. Be on a Windows machine and have the latest .NET SDK (get it here)
1. Install the tool using the following command.

dotnet tool install -g try-convert

How to update

dotnet tool update -g try-convert

How To Uninstall

You can uninstall the tool using the following command.

dotnet tool uninstall -g try-convert

Disclaimer

As with all previous releases, this is not a supported Microsoft product. See here for more info: https://github.com/dotnet/try-convert#support-policy

Changelog

• Rename base branch to main
• Fix "Exception converting project 'Sequence contains more than one element'" by @ejohnson-dotnet
• Add support for VB WPF and Unit Test projects by @KSchlobohm

How To Install

0. Be on a Windows machine and have the latest .NET SDK (get it here)
1. Install the tool using the following command.

dotnet tool install -g try-convert

How to update

dotnet tool update -g try-convert

How To Uninstall

You can uninstall the tool using the following command.

dotnet tool uninstall -g try-convert

Disclaimer

As with all previous releases, this is not a supported Microsoft product. See here for more info: https://github.com/dotnet/try-convert#support-policy

Changelog

• Don't use web SDK for libraries still targeting .NET Framework by @mjrousos

How To Install

0. Be on a Windows machine and have the latest .NET SDK (get it here)
1. Install the tool using the following command.

dotnet tool install -g try-convert

How to update

dotnet tool update -g try-convert

How To Uninstall

You can uninstall the tool using the following command.

dotnet tool uninstall -g try-convert

Disclaimer

As with all previous releases, this is not a supported Microsoft product. See here for more info: https://github.com/dotnet/try-convert#support-policy

Changelog

• Fix some PCL-netstandard mappings by @mjrousos

How To Install

0. Be on a Windows machine and have the latest .NET SDK (get it here)
1. Install the tool using the following command.

dotnet tool install -g try-convert

How to update

dotnet tool update -g try-convert

How To Uninstall

You can uninstall the tool using the following command.

dotnet tool uninstall -g try-convert

Disclaimer

As with all previous releases, this is not a supported Microsoft product. See here for more info: https://github.com/dotnet/try-convert#support-policy

Changelog

• Add ImportWindowsDesktopTargets=true for desktop converted projects to support multi-targeting against net5.0-windows and .NET Framework by @twsouthwick
• Support converting a project even if it has custom imports by @mjrousos

How To Install

0. Be on a Windows machine and have the latest .NET SDK (get it here)
1. Install the tool using the following command.

dotnet tool install -g try-convert

How to update

dotnet tool update -g try-convert

How To Uninstall

You can uninstall the tool using the following command.

dotnet tool uninstall -g try-convert

Disclaimer

As with all previous releases, this is not a supported Microsoft product. See here for more info: https://github.com/dotnet/try-convert#support-policy

Changelog

• Preserve project reference aliases (affects some XAML projects), contributed by @icnocop
• Adjust logic for assigning a project type to be more friendly to older projects that may not specify imports in a "normal" way, contributed by @mjrousos

How To Install

0. Be on a Windows machine and have the latest .NET Core SDK (get it here)
1. Install the tool using the following command.

dotnet tool install -g try-convert

How to update

dotnet tool update -g try-convert

How To Uninstall

You can uninstall the tool using the following command.

dotnet tool uninstall -g try-convert

Disclaimer

As with all previous releases, this is not a supported Microsoft product. See here for more info: https://github.com/dotnet/try-convert#support-policy

Changelog

• Removes packages.config when --no-backup is specified
• Support for migrating F# projects
• Fixed issue with old-style web projects not getting loaded with --force-web specified

How To Install

0. Be on a Windows machine and have the latest .NET Core SDK (get it here)
1. Install the tool using the following command.

dotnet tool install -g try-convert

How To Uninstall

You can uninstall the tool using the following command.

dotnet tool uninstall -g try-convert

Disclaimer

As with all previous releases, this is not a supported Microsoft product. See here for more info: https://github.com/dotnet/try-convert#support-policy

Changelog

• Supporting converting ASP.NET web projects by @mjrousos
• Fix a logic bug in parsing DevelopmentDependency from packages.config by @ejohn54

How To Install

0. Be on a Windows machine and have the latest .NET Core SDK (get it here)
1. Install the tool using the following command.

dotnet tool install -g try-convert

How To Uninstall

You can uninstall the tool using the following command.

dotnet tool uninstall -g try-convert

Disclaimer

As with all previous releases, this is not a supported Microsoft product. See here for more info: https://github.com/dotnet/try-convert#support-policy

Changelog

• Require .NET 5 SDK to convert projects and fix issues related to loading and converting projects on .NET 5
• Bump minor version to 0.7

How To Install

0. Be on a Windows machine and have the latest .NET Core SDK (get it here)
1. Install the tool using the following command.

dotnet tool install -g try-convert

How To Uninstall

You can uninstall the tool using the following command.

dotnet tool uninstall -g try-convert

Disclaimer

As with all previous releases, this is not a supported Microsoft product. See here for more info: https://github.com/dotnet/try-convert#support-policy

Changelog

• Bump minor version to 0.6
• Support .NET 5 as a conversion target for supported app types
• Target highest-possible TFM based on installed SDK (-preview will choose latest preview TFM available)
• Target .NET Standard 2.0 for class libraries by default
• Print all unexpected Import declarations when they are found, and show the required ones
• Fix a bug where some duplicate PropertyGroup declarations could be made
• Notify users when we find a App.config and let them know that it needs to be rewritten

How To Install

0. Be on a Windows machine and have the latest .NET Core SDK (get it here)
1. Install the tool using the following command.

dotnet tool install -g try-convert

How To Uninstall

You can uninstall the tool using the following command.

dotnet tool uninstall -g try-convert

Disclaimer

As with all previous releases, this is not a supported Microsoft product. See here for more info: https://github.com/dotnet/try-convert#support-policy

Changelog

• Bump minor version to 0.5
• Overwrite any *.old project files to support people who may run the tool a lot
• Add support for --keep-current-tfms switch, which doesn't upgrade your TFM regardless of project type

How To Install

0. Be on a Windows machine and have the latest .NET Core SDK (get it here)
1. Install the tool using the following command.

dotnet tool install -g try-convert

How To Uninstall

You can uninstall the tool using the following command.

dotnet tool uninstall -g try-convert

Disclaimer

As with all previous releases, this is not a supported Microsoft product. See here for more info: https://github.com/dotnet/try-convert#support-policy

Changelog

• Bump minor version to 0.4
• Don't reject projects that reference System.Web, but do warn them about it

How To Install

0. Be on a Windows machine and have the latest .NET Core SDK (get it here)
1. Install the tool using the following command.

dotnet tool install -g try-convert

How To Uninstall

You can uninstall the tool using the following command.

dotnet tool uninstall -g try-convert

Disclaimer

As with all previous releases, this is not a supported Microsoft product. See here for more info: https://github.com/dotnet/try-convert#support-policy

Changelog

• Running try-convert with no arguments is now equivalent to try-convert -w .
• Any reference to System.Web now rejects the project
• Handle converting MSTest projects better (fixing #173) by @dotnokato
• Don't generate a backup file if --diff-only (fixing #108) by @dotnokato
• Build from source instructions improved by @tomaustin700
• Nullable Reference Types used in the codebase by @dotnokato
• Add the project path to the error when project conversion failes (fixing #273) by @dotnokato

How To Install

0. Be on a Windows machine and have the latest .NET Core SDK (get it here)
1. Install the tool using the following command.

dotnet tool install -g try-convert

How To Uninstall

You can uninstall the tool using the following command.

dotnet tool uninstall -g try-convert

Disclaimer

As with all previous releases, this is not a supported Microsoft product. See here for more info: https://github.com/dotnet/try-convert#support-policy

Changelog

• Support for $(Platform) and $(Configuration) conditions, contributed by @dotnokato
• Adds support for -tfm option, defaulting to the latest available TFM your environment supports
• Fixed: https://github.com/dotnet/try-convert/issues/169

How To Install

0. Be on a Windows machine and have the latest .NET Core SDK (get it here)
1. Install the tool using the following command.

dotnet tool install -g try-convert

How To Uninstall

You can uninstall the tool using the following command.

dotnet tool uninstall -g try-convert

Disclaimer

As with all previous releases, this is not a supported Microsoft product. See here for more info: https://github.com/dotnet/try-convert#support-policy

Changelog

• Fixes project url in package from https://github.com/dotnet/tryconvert to https://github.com/dotnet/try-convert

How To Install

0. Be on a Windows machine and have the .NET Core 3.0 SDK installed (get it here)
1. Install the tool using the following command.

dotnet tool install -g try-convert --version 0.2.105801

How To Uninstall

You can uninstall the tool using the following command.

dotnet tool uninstall -g try-convert

Disclaimer

As with all previous releases, this is not a supported Microsoft product. See here for more info: https://github.com/dotnet/try-convert#support-policy

Changelog

• Fixes #128 Referenze System.ComponentModel.DataAnnotations gets resolved with wrong NuGet Package
• Fixes #156 Unable to convert .NET Framework 4.8 Test Project

How To Install

0. Be on a Windows machine and have the .NET Core 3.0 SDK installed (get it here)
1. Download the try-convert.v0.2.105701.nupkg file included in this release
2. Install the tool using the following command.

dotnet tool install -g try-convert --version 0.2.105701 --add-source \\Path\To\Folder\With\Downloaded\Nuget\Package

How To Uninstall

You can uninstall the tool using the following command.

dotnet tool uninstall -g try-convert

Disclaimer

As with all previous releases, this is not a supported Microsoft product. See here for more info: https://github.com/dotnet/try-convert#support-policy

Changelog

• Fixed an issue with throwing exceptions in some cases
• Removes imports that come from NuGet packages

How To Install

0. Be on a Windows machine and have the .NET Core 3.0 SDK installed (get it here)
1. Download the try-convert.0.2.51601.nupkg file included in this release
2. Install the tool using the following command.

dotnet tool install -g try-convert --version 0.2.51601 --add-source \\Path\To\Folder\With\Downloaded\Nuget\Package

How To Uninstall

You can uninstall the tool using the following command.

dotnet tool uninstall -g try-convert