Deploy Containers Close to Your Users

This Engineering Education (EngEd) Program is supported by Section.

Instantly deploy containers globally. Section is affordable, simple and powerful.

Get Started for Free.

Getting Started With .Net MAUI For Cross Platform Applications

December 17, 2021

.NET MAUI is a cross-platform framework that is used to create native desktop and mobile applications. It is the most productive way to create, performant Android, iOS, macOS, and Windows Apps, all from a single code base.

It is an evolution of Xamarin.Forms, and extended from desktop scenarios with UI controls.

The advantage of .NET MAUI is that you can have your cross-platform native UI built in .NET with XAML and C#, and run the same code base on all platforms, i.e:

  • On Windows using the WINUI3.
  • On macOS using the MAC Catalyst Apps
  • iOS and Android for your phone.

Setting up Visual Studio

To create multi-platform applications using .NET MAUI, you will need to download the preview version of Microsoft Visual Studio 2022 here.

Downloading workloads

To get started, you will need to set up your Microsoft Visual Studio so it can run the .NET MAUI framework. To do this, on the installation window, check the boxes for the following five workloads:

  • Mobile Development with .NET
  • ASP.NET and Web Development
  • .NET Desktop development
  • Universal Windows Platform development
  • Desktop development with C++.

Getting started with visual studio

Setting up windows platform

In order to run your applications on Windows desktops, you will download Single-Project MSIX Packaging Tools Visual Studio 2022 here.

Setting up the android platform

Since this is a multi-platform development, .NET MAUI will require Android 31 SDK to run your applications on android. Download the openJDK 11 from this site.

The next thing is to install Android 31 SDK. To do that, follow the steps below:

  1. Open Visual Studio
  2. Click on continue without code
  3. Use the menu to choose tools and then select options
  4. Type Android in the search bar and select Xamarin, Android Settings
  5. Locate the location of Android SDK in your file folder, select it and click Ok.

The next thing is prompting the Android SDK manager under Tools > Android > Android SDK manager.

Check the latest android item i.e. Android 12.0-S API level 31 > Android SDK platform 31 and click Apply changes

Creating a new .NET MAUI project

To create a new project, launch Microsoft Visual Studio and select New project.

On the next screen, search for MAUI and select .NET MAUI app(Preview), then click Next.

New project

After creating your project, there are a number of files that are generated. One of them has an extension of csproj which has the platforms that are being targeted by the project.

In this file, you specify which platforms you want your application to run on. You can target all the platforms or just a few platforms that you are interested in.

Once you have written your code for the application, choose the platform that you want to run your application. Next to Any CPU, there is a drop-down window, click on it and go to My frameworks where you will choose whether to run it from Windows, Android, iOS, or macOS.

Solution explorer

The solution explorer has some important files and folders that are important to look at to have a better understanding of where relevant files need to be put. i.e:

Xaml file

This is where you write your UI code for your project. Xaml file contains the logic for your project.

Platforms folder

This folder contains and specifies the platforms that your application will run from. The default platforms are:

  • Android
  • iOS
  • macOS
  • WIndows

This folder keeps the specific code for each platform, if you want to write platform specific code.

For example, if you want to write code for Android, you will write it in the Android platform file.

Resources folder

This folder is used to keep the resources for your application. This folder enables you to share everything for your project across all platforms.

The resources in this folder are images, fonts, app icons. All the images use the .svg file extension so that they can be displayed on all the platforms.


From this article, you realize that using .NET MAUI, you can build applications targeting different platforms using the same code base.

The same images can be used on different platforms provided they are saved with the .svg file format. This reduces the storage space used for saving images and other files in your application.


.NET MAUI is an improvement of Xamarin.Forms. The main idea of the invention of the .NET MAUI framework was basically to reduce the amount of time used in the development process.

Saving the amount of storage space used in application is also an idea since only single files are used and the codebase is deployed on different platforms.

Peer Review Contributions by: Peter Kayere