andres-gimenez/net6-mobile-samples

Xamarin .NET 6 *early* preview. Not for production use.

.NET 6 Client App Samples for Android, iOS, macOS, and Windows

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.

Installing with .NET MAUI Check Tool

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.7.3

Run: maui-check

This will evaluate your environment and in most cases optionally install / configure missing components for you, such as:

• OpenJDK / Android SDK
• .NET 6 Preview SDK
• .NET MAUI / iOS / Android workloads
• Currently does not install SDKs for WinUI3 (Install UWP Workload from Visual Studio 2022)

For more information and source code, visit redth/dotnet-maui-check

.NET 6 Preview Installers

Download the .NET 6 SDK at:

https://dotnet.microsoft.com/download/dotnet/6.0

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.

dotnet workload install Command

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:

• maui
• maui-android
• maui-ios
• maui-maccatalyst
• maui-windows
• android
• ios
• maccatalyst
• macos
• tvos

NOTE: using maui-check is the preferred method for installing workloads, because it will check your system for other software.

Projects

• 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.

Android

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 to Tools > Android > Android SDK Manager from 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

iOS

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

WinUI3

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.

  • https://marketplace.visualstudio.com/items?itemName=ProjectReunion.MicrosoftSingleProjectMSIXPackagingToolsDev17

.NET MAUI

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

Using IDEs

IDE integration into Visual Studio, Visual Studio for Mac, and Visual Studio Code are a work in progress.

Visual Studio

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

Visual Studio for Mac is not supported at this time, but will be coming in a future release.

iOS from Visual Studio

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).

Mac Catalyst from Visual Studio for Mac

Running and debugging apps from Visual Studio for Mac is not supported at this time..

Known Issues - Visual Studio & Visual Studio for Mac

• 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.

Visual Studio Code

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.