Steps to upgrade my Xamarin Forms app to .net MAUI using MAC

Raghavendra G R 121 Reputation points


I'm trying to upgrade my Xamarin Forms app to .net MAUI using Mac, but i'm unable to add ".net upgrade assistant" into my nuget extension. Could someone please help me with the steps on how to upgrade using Mac system.

Thanks in advance.



A Microsoft open-source app platform for building Android and iOS apps with .NET and C#.
5,206 questions
A Microsoft open-source framework for building native device applications spanning mobile, tablet, and desktop.
2,174 questions
0 comments No comments
{count} votes

2 answers

Sort by: Most helpful
  1. Wenyan Zhang (Shanghai Wicresoft Co,.Ltd.) 23,306 Reputation points Microsoft Vendor


    For now, there is not the GUI and Visual Studio extension for macOS, you can upgrade your apps using the CLI version of the .NET Upgrade Assistant.

    Step by Step:

    1. Open Terminal and install the .NET Upgrade Assistant by the following command:
    dotnet tool install -g upgrade-assistant
    1. Go to the folder where your Xamarin project is located
    % cd XXX/yourproject
    1. Run the upgrade-assistant upgrade command:
    % upgrade-assistant upgrade
    1. (Optional) If you get an error "Cannot find a tool in the manifest file that has a command named 'upgrade-assistant", you need to add ~/.dotnet/tools to your PATH environment. Then run the upgrade-assistant upgrade command again.
    export PATH=$PATH:~/.dotnet/tools
    1. Select the project you want to upgrade as described in the Upgrade with the CLI tool doc. Pay attention to upgrading the Xmairn.iOS/Xamarin.Android project before Xamarin.Forms.
    2. Configure Android project and iOS project manually.
    3. (Optional) You might need to change some Namespace, color, layout manually, see Manually upgrade a Xamarin.Forms app to a multi-project .NET MAUI app - .NET MAUI | Microsoft Learn.

    Best Regards,

    Wenyan Zhang

    If the answer is the right solution, please click "Accept Answer" and kindly upvote it. If you have extra questions about this answer, please click "Comment".

    Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.

  2. Bruce ( 48,711 Reputation points

    be sure you read the Visual Studio for Mac retirement notice:

    to determine if you want to stay with Xarmin/Maui development environment rather than swift/swiftui

    0 comments No comments