Installation

To create .NET Multi-platform App UI (.NET MAUI) apps, you need the latest preview versions of Visual Studio 2022 and .NET 6.

Important

The documentation for .NET Multi-app Platform UI (.NET MAUI) is under construction.

Visual Studio

To create .NET MAUI apps, you'll need Visual Studio 2022 Preview 4 or later. Either install Visual Studio, or modify your installation, and install the following workloads:

  • Mobile development with .NET

  • Universal Windows Platform development

  • ASP.NET and web development (required for .NET MAUI Blazor apps)

    Visual Studio workloads for .NET MAUI.

In the Installation details > Mobile development with .NET section of the installation window, check the .NET MAUI (Preview) optional workload:

Visual Studio installer enabling the .NET MAUI optional workload.

Android

.NET MAUI requires the Android 12 (API 31) SDK for development. Install the following items:

  • Microsoft Build of OpenJDK

    While Visual Studio installs a version of Microsoft OpenJDK, you need to install Microsoft OpenJDK 11, available from the OpenJDK page. When installing OpenJDK 11, use the default installation configuration settings. After installing OpenJDK 11, Visual Studio should automatically consume it. However, if it doesn't, set the path to the OpenJDK install in the Tools > Options > Xamarin > Android Settings > Java Development Kit Location field.

  • Android 12 (API 31) SDK

    The Android 12 SDK must be installed so that Visual Studio can create a .NET MAUI app. This can be accomplished through Visual Studio:

    1. Open Visual Studio.

    2. If the Open Recent/Get Started window opens, choose Continue without code.

    3. In the main Visual Studio window, use the menu to choose Tools > Options.... The options window is displayed.

    4. In the search bar, type android. Select the Xamarin > Android Settings category.

    5. The Android SDK Location field should point to a default of C:\Program Files (x86)\Android\android-sdk. It probably has a red X indicating it's not configured correctly. This is normal.

    6. Select the OK button to close the window.

      Visual Studio android settings for .NET MAUI.

    7. Visual Studio will now attempt to load the Android SDKs. This may involve accepting the Android SDK License:

      Visual Studio android SDK license.

      If you lack a previous Android install, Visual Studio will download the Android tooling required for you to proceed.

    Visual Studio should now be able to load the Android SDK Manager. The next step is to install the Android 12 SDK:

    1. In the main Visual Studio window, choose the Tools > Android > Android SDK Manager... menu item.

    2. In the Android SDK Manager, check the Android 12.0 API Level 31 item and click the Apply Changes button.

      Visual Studio android SDK manager window for .NET MAUI.

    Visual Studio will then install the Android 12 SDK.

Windows (WinUI 3)

To create apps that target Windows UI Library (WinUI) 3, install the following Visual Studio extension:

Important

You must uncomment the Windows TargetFrameworks from your .csproj file in order to enable windows development.

Next steps

To learn how to create and run your first .NET MAUI app, continue to build your first app.