Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
102 changes: 101 additions & 1 deletion release-notes/10.0/preview/rc2/dotnetmaui.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,107 @@
# .NET MAUI in .NET 10 RC 2 - Release Notes

This RC 2 release does not contain new .NET MAUI feature additions.
Here's a summary of what's new in .NET MAUI in this RC 2 release:

- .NET MAUI
- [Microphone permission](#microphone-permission)
- [SafeAreaEdges](#safeareaedges)
- [XAML Source Generation](#xaml-source-generation)
- [.NET for Android](#net-for-android)
- [Android API 36.1](#android-api-36.1)
- [.NET for iOS, Mac Catalyst, macOS, tvOS](#net-for-ios-mac-catalyst-macos-tvos)
- [Xcode 26](#xcode-26)

## Feature

Feature summary

.NET MAUI updates in .NET 10:

- [What's new in .NET MAUI in .NET 10](https://learn.microsoft.com/dotnet/maui/whats-new/dotnet-10) documentation.

## .NET MAUI

This release has been focused on stabilizing the SDK.

### Microphone permission

We have added the Windows implementation for `Permissions.RequestAsync<Permissions.Microphone>()` to request and check access permission for the device microphone.

### SafeAreaEdges

Support for `SafeAreaEdges` has been added to Android for supporting edge-to-edge and managing content relative to keyboard and unsafe areas of the device display.

### XAML Source Generation

This release includes improvements to XAML source generation with notable improvements to debug time view inflation. To enable this in your project add the following to your project file.

```xml
<PropertyGroup>
<MauiXamlInflator>SourceGen</MauiXamlInflator>
</PropertyGroup>
```

## .NET for Android

This release includes continued integration with multiple .NET runtimes, and several bug fixes.

### Android API 36.1

Android API 36.1 bindings are now available thanks to the contribution and collaboration of the [Uno Platform](https://platform.uno/) team.

To try out the new APIs, you can opt your project into the new `net10.0-android36.1` target framework:

```xml
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net10.0-android36.1</TargetFramework>
<EnablePreviewFeatures>true</EnablePreviewFeatures>
<!-- Remainder of your .csproj -->
```

Note that if omitted, `net10.0-android` will default to API 36.0. `$(EnablePreviewFeatures)` will not be required in future .NET 10 releases.

To *use* an Android 36.1-only API you can use the `OperatingSystem` class to check the Android version at runtime:

```csharp
if (OperatingSystem.IsAndroidVersionAtLeast(36, 1))
{
// Call some Android 36.1 API here
}
else
{
// Fallback for older OS versions
ShowToast("Android 36.1+ is required for this feature");
}
```

For a full sample using Android 36.1 APIs, see our [Pdf Annotator sample on GitHub](https://github.com/dotnet/android-samples/tree/main/PdfAnnotator).

To install the Android 36.1 platform, you can go to **Tools** > **Android** > **Android SDK Manager**. Under the gear icon in the bottom right, change **Repository*** to **Full List**. This allows you to install `Android SDK Platform 36.1`.

### (Experimental) CoreCLR

We continue to work on enabling Android apps to run on the CoreCLR runtime (instead of Mono). To use it, add the following to your project file for Android builds:

```xml
<!-- Use CoreCLR on Android -->
<PropertyGroup Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'android'">
<UseMonoRuntime>false</UseMonoRuntime>
</PropertyGroup>
```

Please try this in your applications and report any issues; when filing feedback, state that you are using UseMonoRuntime=false. Expect that application size is currently larger than with Mono and that debugging and some runtime diagnostics are not fully functional yet; these areas are actively being improved. This is an experimental feature and not intended for production use.

A detailed list of Android changes can be found on the [dotnet/android GitHub releases](https://github.com/dotnet/android/releases/).

## .NET for iOS, Mac Catalyst, macOS, tvOS

This release includes continued integration with multiple .NET runtimes, and several bug fixes.

### Xcode 26

Xcode 26 bindings have been updated and are available now for both for targeting .NET 9 and .NET 10 RC2. This is compatible with Xcode 26.0 and 26.1.

## Contributors

Thank you contributors! ❤️