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 install -g redth.net.maui.check
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 and packs
- .NET MAUI Templates
- Workload Resolver .sentinel files for dotnet and Visual Studio Windows/Mac
- Currently does not install workloads required for WinUI3
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.5.21302.13-win-x64.exe
- macOS: dotnet-sdk-6.0.100-preview.5.21302.13-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 microsoft-android-sdk-full
On macOS, you'd need to use sudo:
$ sudo dotnet workload install microsoft-android-sdk-full
The workload ID for each platform is:
microsoft-android-sdk-fullmicrosoft-ios-sdk-fullmicrosoft-maccatalyst-sdk-fullmicrosoft-macos-sdk-fullmicrosoft-tvos-sdk-full
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 2019 16.11. .NET MAUI WinUI currently does not work with Visual Studio 2022
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 12.5. 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 2019 16.11. WinUI currently does not work with Visual Studio 2022
- Windows: Get started with Project Reunion
- Install the following 0.8 Preview Reunion VSIXs. .NET MAUI currently only works with 0.8 Reunion Preview and will not work with 0.8 Reunion Stable.
- Uninstall any WinUI extensions that you may have previously installed
- https://marketplace.visualstudio.com/items?itemName=ProjectReunion.MicrosoftProjectReunionPreview
- https://marketplace.visualstudio.com/items?itemName=ProjectReunion.MicrosoftSingleProjectMSIXPackagingTools
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 2019 16.11 on Windows (with the Xamarin workload installed). .NET 6 Preview 5 requires MSBuild 16.11, 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 intall 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 remoted 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.