Pereiti prie pagrindinio turinio

Migrating from Xamarin to .NET MAUI: A Comprehensive Guide

The world of mobile application development is constantly evolving, and Microsoft’s .NET Multi-platform App UI (.NET MAUI) is at the forefront of this change. As an evolution of Xamarin.Forms, .NET MAUI offers developers a modern, cross-platform framework for building native device applications. This blog post will guide you through the process of migrating your existing Xamarin.Forms application to .NET MAUI.

Why Migrate to .NET MAUI?

Before we delve into the migration process, let’s understand why you might want to migrate your Xamarin.Forms application to .NET MAUI.

.NET MAUI not only provides all the capabilities of Xamarin.Forms but also adds new features and improvements:

  1. Single Project Structure: Unlike Xamarin.Forms, where you need to manage multiple projects for different platforms, .NET MAUI simplifies this with a single project structure. This means you can manage all your platforms together with single-click deployment.
  2. Improved Performance: .NET MAUI is designed to support high-performance apps and responsive UI. This means your app will run smoother and faster.
  3. Modern UI Trends: With .NET MAUI, you get access to new controls and layouts that meet modern UI requirements.
  4. End of Support for Xamarin: Microsoft has announced that support for all Xamarin SDKs will end on May 1, 2024. Android 13 and Xcode 14 SDKs (iOS and iPadOS 16, macOS 13) will be the final versions that Xamarin will target. Therefore, migrating to .NET MAUI ensures that your application continues to receive support and can leverage the latest platform features.


Before upgrading your Xamarin.Forms app to .NET MAUI, you should first update your Xamarin.Forms app to use Xamarin.Forms 5 and ensure that it still runs correctly. In addition, you should update the dependencies that your app uses to the latest versions. This will ensure that you are using .NET compatible versions of your dependencies if they exist.

Migration Steps

Migration from Xamarin.Forms to .NET MAUI is not a complicated process but it requires careful planning. Here are the detailed steps:

  1. Update Visual Studio: The first step is to ensure you’re using the latest version of Visual Studio. You can check for updates in Visual Studio by going to Help > Check for Updates.
  2. Install .NET MAUI: Next, download and install .NET MAUI from the official Microsoft website. Follow the installation guide provided there.
  3. Create New .NET MAUI App: Once you have installed .NET MAUI, start by creating a new .NET MAUI app which will serve as the target for migration. To do this, open Visual Studio and select File > New > Project. In the Create a new project window, select .NET MAUI App and then select Next. In the Configure your new project window, enter your project details and then select Create.
  4. Transfer Code: Now comes the main part of the migration – moving your Xamarin.Forms code to the .NET MAUI app. Start with transferring your Models, Views, and ViewModels to the new .NET MAUI project. Ensure that all your dependencies are compatible with .NET MAUI. If not, look for suitable alternatives.
  5. Update Namespaces: After transferring your code, you’ll need to update Xamarin.Forms namespaces in your code with their .NET MAUI counterparts. For example, replace Xamarin.Forms with Microsoft.Maui.Controls.

  1. Review XAML Files: Next, review your XAML files for any changes in syntax and update them accordingly. For example, replace ContentPage with Maui.ContentPage.
  2. Update Platform-Specific Code: If you have any platform-specific code in your Xamarin.Forms project, you’ll need to update this to work with .NET MAUI.
  3. Test Your App: Finally, run your app on different platforms to make sure it works as expected.

Using the .NET Upgrade Assistant

To simplify the migration process further, Microsoft provides a tool called the .NET Upgrade Assistant. This command-line tool can help you upgrade multi-project Xamarin.Forms apps to multi-project .NET Multi-platform App UI (.NET MAUI) apps. After running the tool, additional effort will be required to complete the migration. This may include updating dependencies, fixing any broken references, and thoroughly testing your app to ensure everything works as expected.

Here’s how you can use it:

  1. Install .NET Upgrade Assistant: Open Visual Studio and select the Extensions > Manage Extensions menu item. In the Manage Extensions dialog, search for and download the .NET Upgrade Assistant.
  1. Run .NET Upgrade Assistant: This tool helps you upgrade Xamarin.Forms projects to .NET MAUI by converting the solution’s project file and performing common code updates.
    1. Select one of the 2 options: In place project upgrade or Side-by-Side project upgrade. Recommended is the first option, since there will be less work referencing projects.
    2. Chose .NET 7 (or latest stable version)
    3. Select all components
    4. Upgrade
    5. Repeat with all projects
  1. Post-Upgrade Steps: After running the tool, additional effort will be required to complete the migration. This may include updating dependencies, fixing any broken references, and thoroughly testing your app to ensure everything works as expected.
    1. Try Clean Build
    2. Some errors may occur. Most common once:
      1. Path to Page is not found. Solution: Exclude and Include back to project
      2. 1>Views\FeedbackPage.xaml : error : Can’t load types from xmlns : Remove x:Class attribute
      3. Some Nuget packages might not be compatible with MAUI. You might check or request to upgrade 3rd party library owners to migrate to MAUI or to create/upgrade your own Binding Libraries.


While migration requires some effort, the benefits of moving to .NET MAUI are substantial. The single project structure simplifies development while performance improvements ensure your app runs smoothly on all platforms.

Populiariausi blog'ai

  • My experience on taking the eWPTXv2 exam

    So a few months ago I had the joy of passing the eWPTXv2 exam. Well, it does not sound intriguing until you translate it into human language. The eWPTXv2 is actually eLearnSecurity Web Penetration Testing Extreme second version. Everything sounds better than you put extreme into it. Well, this is not that case since the exam is actually a bit hard.

  • Socialinis intranetas „Simoona“ – dabar prieinamas kiekvienam!

    Šiame blog’o įraše papasakosime apie vidinės komunikacijos įrankį, mūsų kurtą socialinį tinklą „Simooną“. Tik prasidėjus kūrybos procesui mums rūpėjo tik viena – kaip kuo daugiau įmonės kultūros perkelti į skaitmeninę erdvę. Ir prieš aštuonerius metus, net neįsivaizdavome, kad šis vidinis intranetas, bus toks svarbus kuriant glaudžius ryšius tarp kolegų ir tikrai net negalėjome nutuokti, kokia svarbi „Simoona“ bus užklupus pasaulinei pandemijai.

  • ISTQB Certifiend Tester Foundation Level experience 2 -min

    Patirtis laikant For ISTQB Certified Tester Foundation Level 2018 sertifikatą

    Aš Ramūnas Norkus, jau beveik du metus Vismoje dirbu automatinio testavimo inžinieriumi „Inschool“ projekte. Kuris yra skirtas Norvergijos mokykloms ir, beje, yra didžiausias projektas Vismoje. Mano kasdienis darbas apima įvairias testavimo užduotis, susijusias su automatinių testų (frontend, performance, penetration) rašymu ir priežiūra bei rankiniu testavimu.

    Tad, tikriausiai nenustebsi, kad ir šis mano blog’as patirtį laikant vieną iš testavimo inžinieriaus sertifikatų. Įdomu? Skaityk toliau.