[Android] Implemented UseMaterial3 build property and provided basic M3 styles

[NirmalKumarYuvaraj]

Description of Change

This pull request introduces the foundation for Material Design 3 (M3) support in .NET MAUI for Android. The changes allow developers to opt into Material Design 3 via a new MSBuild property, provide runtime detection of the Material version, and add the necessary Android resources and styles for M3. By default, apps continue to use Material Design 2 to maintain backward compatibility.

Material Design 3 opt-in and configuration:

• Added a new MSBuild property UseMaterial3 (default: false) to allow developers to opt into Material Design 3 for Android. Internal build properties are set based on this value, and a build log message informs developers which Material version is active. (Microsoft.Maui.Controls.Common.targets) [1] [2]
• The Material Design version is now surfaced as a runtime feature switch (Microsoft.Maui.RuntimeFeature.IsMaterial3Enabled), which is set during the build process if UseMaterial3 is specified. (Microsoft.Maui.Controls.targets, RuntimeFeature.cs) [1] [2] [3]

Runtime and theming support:

• Introduced MaterialDesignHelper for runtime detection of Material Design 3 enablement, with caching for performance and a method to retrieve the current Material version. (MaterialDesignHelper.cs)
• Updated MauiMaterialContextThemeWrapper to dynamically select the correct base theme (Material 2 or Material 3) at runtime using the new helper. (MauiMaterialContextThemeWrapper.cs)

Android resource additions for Material Design 3:

• Added comprehensive Material Design 3 color definitions for both light and dark themes, including compatibility colors for legacy components. (colors-material3.xml)
• Added Material Design 3 style definitions, including base theme, no action bar variant, action mode, and splash theme. (styles-material3.xml)

Issues Fixed

Fixes #33073

Output

Material 2	Material 3

[github-actions]

🚀 Dogfood this PR with:

⚠️ WARNING: Do not do this without first carefully reviewing the code of this PR to satisfy yourself it is safe.

curl -fsSL https://raw.githubusercontent.com/dotnet/maui/main/eng/scripts/get-maui-pr.sh | bash -s -- 33074

Or

• Run remotely in PowerShell:

iex "& { $(irm https://raw.githubusercontent.com/dotnet/maui/main/eng/scripts/get-maui-pr.ps1) } 33074"

[Copilot]

Pull request overview

This PR introduces foundational support for Material Design 3 (M3) on Android in .NET MAUI. It adds a new MSBuild property UseMaterial3 to allow opt-in to M3, implements a runtime feature switch for detecting M3 enablement, and provides comprehensive M3 Android resources (colors and styles). The default behavior remains Material Design 2 for backward compatibility.

Key Changes:

• Adds IsMaterial3Enabled runtime feature switch with MSBuild integration
• Dynamically selects Material 2 or Material 3 themes at runtime in MauiMaterialContextThemeWrapper
• Provides complete M3 color tokens and style definitions for light/dark themes

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
src/Core/src/RuntimeFeature.cs	Adds IsMaterial3Enabled property to expose M3 feature state at runtime
src/Core/src/Platform/Android/MauiMaterialContextThemeWrapper.cs	Updates constructor to conditionally use M3 or M2 base theme based on feature flag
src/Controls/src/Build.Tasks/nuget/buildTransitive/netstandard2.0/Microsoft.Maui.Controls.targets	Integrates UseMaterial3 MSBuild property with runtime feature switch configuration
src/Core/src/Platform/Android/Resources/values/styles-material3.xml	Defines M3 theme hierarchy including base theme, no action bar variant, action mode, and splash theme
src/Core/src/Platform/Android/Resources/values/colors-material3.xml	Provides comprehensive M3 color tokens for light/dark themes including primary, secondary, tertiary, surface, and state overlay colors

[Copilot]

The comment "optout" should be "opt out" (two words). This matches the correct spelling used in the original Material 2 styles file (styles.xml line 6).

Suggested change

	<!-- For .NET 9 we optout of edge to edge enforcement by default -->
	<!-- For .NET 9 we opt out of edge to edge enforcement by default -->

[sheiksyedm]

/rebase

[PureWeen]

Should we load the material3 theme here if the property is set?

https://github.com/dotnet/maui/blob/main/src/Core/src/Platform/Android/MauiAppCompatActivity.cs#L21-L26

[NirmalKumarYuvaraj]

Should we load the material3 theme here if the property is set?

https://github.com/dotnet/maui/blob/main/src/Core/src/Platform/Android/MauiAppCompatActivity.cs#L21-L26

@PureWeen , Updated the app theme based on the material3 flag.

[PureWeen]

• failing tests unrelated