These apps are based on previews of Mobile (iOS/Android) and Desktop (macOS/Windows) in .NET 6 which are not for production use. Expect breaking changes as this is still in development for .NET 6.
If you are looking for the absolute newest download links, see the develop branch.
This is a community supported, open source, global dotnet tool intended to help evaluation your development environment and help you install / configure everything you need to build a .NET MAUI application.
Install: dotnet tool update -g redth.net.maui.check --version 0.6.1
Run: maui-check
This will evaluate your environment and in most cases optionally install / configure missing components for you, such as:
- OpenJdk / AndroidSDK
- .NET 6 Preview SDK
- .NET MAUI / iOS / Android workloads
- Currently does not install SDK's for WinUI3 (Install UWP Workload from Visual Studio 2022)
For more information and source code, visit redth/dotnet-maui-check
If you prefer to install everything manually, you can find all of the official installer links below:
- Windows: dotnet-sdk-6.0.100-preview.6.21355.2-win-x64.exe
- macOS: dotnet-sdk-6.0.100-preview.6.21355.2-osx-x64.pkg
NOTE: newer builds of .NET may work, but your mileage may vary. You can find the full list of builds at the dotnet/installer repo.
A new dotnet workload install command is available for installing
the mobile workloads.
On Windows, in an Administrator command prompt:
> dotnet workload install maui
On macOS, you'd need to use sudo:
$ sudo dotnet workload install maui
The workload ID for each platform is:
mauimaui-androidmaui-iosmaui-maccatalystmaui-windowsmicrosoft-android-sdk-full(changing toandroidin a future release)microsoft-ios-sdk-full(changing toiosin a future release)microsoft-maccatalyst-sdk-full(changing tomaccatalystin a future release)microsoft-macos-sdk-full(changing tomacosin a future release)microsoft-tvos-sdk-full(changing totvosin a future release)
NOTE: using
maui-checkis the preferred method for installing workloads, because it will check your system for other software.
- HelloMaui - a multi-targeted .NET MAUI Single Project for iOS and Android
- HelloAndroid - a native Android application
- HelloiOS - a native iOS application
- HelloMacCatalyst - a native Mac Catalyst application
- HelloWinUI3 - .NET MAUI WinUI3 application. WinUI3 requires build and deploy with the latest preview of Visual Studio 2022 17.0.
Prerequisites:
- Starting in .NET 6 Preview 4, Microsoft OpenJDK 11 is recommended.
- You will need the Android SDK installed as well as
Android SDK Platform 30. Simplest way to get this is to install the current Xamarin workload and go toTools > Android > Android SDK Managerfrom within Visual Studio.
For example, to build the Android project:
dotnet build HelloAndroid
You can launch the Android project to an attached emulator or device via:
dotnet build HelloAndroid -t:Run
Prerequisites:
- Xcode 13.0 beta 2. Earlier versions won't work.
To build the iOS project:
dotnet build HelloiOS
To launch the iOS project on a simulator:
dotnet build HelloiOS -t:Run
Currently WinUI3 requires build and deploy. You will need to open the HelloWinUI3.sln with the latest preview of Visual Studio 2022 17.0.
-
Windows: Get started with Project Reunion
-
Install the following Preview VSIX. .NET MAUI currently only works with 0.8+ Stable.
To launch the .NET MAUI project, you will need to specify a $(TargetFramework) via the -f switch:
dotnet build HelloMaui -t:Run -f net6.0-android
dotnet build HelloMaui -t:Run -f net6.0-ios
dotnet build HelloMaui -t:Run -f net6.0-maccatalyst
IDE integration into Visual Studio, Visual Studio for Mac, and Visual Studio Code are a work in progress.
Currently, you can use Visual Studio 2022 17.0 on Windows (with the Xamarin workload installed). .NET 6 Preview 6 requires MSBuild 17.0, so .NET 6 projects will not be able to load in older versions of Visual Studio.
Visual Studio for Mac is not supported at this time, but will be coming in a future release.
To build and debug .NET 6 iOS applications from Visual Studio 2019 you must manually install the .NET 6 SDK and iOS workloads on both Windows and macOS (Mac build host).
If while connecting Visual Studio to your Mac through XMA you are prompted to install a different version of the SDK, you can ignore that since it refers to the legacy one.
Note: currently only the iOS simulator is supported (not the remote simulator).
Running and debugging apps from Visual Studio for Mac is not supported at this time..
- There are no project property pages available for both iOS and Android
- Editors (i.e. Manifest editor, Entitlements editor, etc.) will fail to open, so as a workaround please open those files with the XML editor.
Support has been added to allow debugging of Android based apps in Visual Studio Code. Open the net6-mobile-samples.code-workspace in Visual Studio Code.
> code net6-mobile-samples.code-workspace
To build your application use open the Command Pallette and select Run Build Task. Select Build and then the Target you want to run. Available targets are:
Build: Builds the Project.Install: Installs the Application on a Device or Emulator.Clean: Clean the Project.
You can then select the Project and then the Configuration (Debug or Release) you want to Build.
To Debug goto the Run Tab and make sure Debug is selected. Click the Run button. You will be prompted on which project you wish to run, then asked which TargetFramework you want to target. For now only net6.0-android is supported. You will then be asked if you want to attach the debugger. Finally you will be asked which configuration you wish to use Debug or Release. After this the application should deploy and run, breakpoints should behave as normal.