.NET 6.0.0 Mobile Samples

This is an early preview of Mobile (iOS/Android) in .NET 6 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 repo requires a specific build of .NET 6:

• Windows: dotnet-sdk-6.0.100-preview.1.21103.13-win-x64.exe
• macOS: dotnet-sdk-6.0.100-preview.1.21103.13-osx-x64.pkg

You will also need to install builds of the iOS and Android workloads:

Android:

• Windows: Microsoft.NET.Workload.Android.11.0.200.85.msi
• macOS: Microsoft.NET.Workload.Android-11.0.200-ci.master.85.pkg

iOS:

• Windows: Microsoft.NET.Workload.iOS.14.3.100-ci.main.1079.msi
• macOS: Microsoft.iOS.Bundle.14.3.100-ci.main.1079.pkg

NOTE: newer builds of .NET may work, but your mileage may vary. The workload installers enable a feature flag file via sdk/6.0.100-preview.1.21103.13/EnableWorkloadResolver.sentinel, which would need to be created manually for other .NET 6 versions. You can find the full list of builds at the dotnet/installer repo.

Projects:

• HelloAndroid - a native Android application
• HelloiOS - a native iOS application
• HelloForms - a multi-targeted Xamarin.Forms application for iOS and Android (will migrate to MAUI in a later preview)

Android

Prerequisites:

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

Xamarin.Forms / MAUI

In later previews, this sample will be migrated to use MAUI

To launch the Forms project, you will need to specify a $(TargetFramework) via the -f switch:

dotnet build HelloForms -t:Run -f net6.0-android
dotnet build HelloForms -t:Run -f net6.0-ios

NOTE: You may need to add the --no-restore switch until dotnet#15485 is resolved.

Using IDEs

Currently, you can use Visual Studio 2019 16.9 Preview 4 on Windows (with the Xamarin workload) with a few manual steps.

Open an Administrator command prompt to enable the EnableWorkloadResolver.sentinel feature flag:

> cd "%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Preview\MSBuild\Current\Bin\SdkResolvers\Microsoft.DotNet.MSBuildSdkResolver"
> echo > EnableWorkloadResolver.sentinel

Or in an Administrator powershell prompt:

> cd "${env:ProgramFiles(x86)}\Microsoft Visual Studio\2019\Preview\MSBuild\Current\Bin\SdkResolvers\Microsoft.DotNet.MSBuildSdkResolver"
> '' > EnableWorkloadResolver.sentinel

NOTE: your path to Visual Studio may vary, depending on where you selected to install it. Preview is the default folder for Visual Studio Preview versions.

This command creates an empty file that enables .NET workload support. Restart Visual Studio after making this change.

Visual Studio for Mac support will be coming in a future release.

Workarounds

These are notes for things we had to workaround for these samples to work.

NuGet

Currently, NuGet is not able to restore existing Xamarin.Android/iOS packages for a .NET 6 project. We tried $(AssetTargetFallback), however, this option does not work in combination with transitive dependencies. The Xamarin.AndroidX.* set of NuGet packages has a complex dependency tree.

Additionally, we had some problems with the Xamarin.Forms NuGet package listing the same assembly in both:

• lib\netstandard2.0\Xamarin.Forms.Platform.dll
• lib\MonoAndroid10.0\Xamarin.Forms.Platform.dll

For now we added workarounds in xamarin-android, see xamarin-android#4663.