Known Issues

.NET MAUI Known Issues

You may encounter the following known issues in addition to verified issues. Each may include workarounds, mitigations, or expected resolution timeframes.

Related known issues:

• .NET for iOS
• .NET for Android

.NET 8 Preview 1

When installing .NET MAUI on win-arm64 machines, you might get the error:

Workload ID maui isn't supported on this platform.

To work around this, manually patch the WorkloadManifest.json files as mentioned here.

On macOS, if you encounter a build error related to mono-aot-cross:

An error occurred trying to start process '/usr/local/share/dotnet/packs/Microsoft.NETCore.App.Runtime.AOT.osx-x64.Cross.maccatalyst-x64/8.0.0-preview.1.23115.2/Sdk/../tools/mono-aot-cross'. Permission denied

To work around the issue, by making the file executable:

chmod +x /usr/local/share/dotnet/packs/Microsoft.NETCore.App.Runtime.AOT.osx-x64.Cross.maccatalyst-x64/8.0.0-preview.1.23115.2/tools/mono-aot-cross

This is tracked in dotnet/runtime#82201.

Some Platform Specifics are not available in .NET MAUI

Platform specifics are APIs built into .NET MAUI for exercising features specific to only one platform. Issue #5856 is tracking the known gaps compared to Xamarin.Forms including:

Android

• Button
  • UseDefaultPadding
  • UseDefaultShadow
• NavigationPage
  • BarHeight

iOS

• NavigationPage
  • HideNavigationBarSeparator
  • StatusBarTextColorMode
• Page
  • UseSafeArea
  • PrefersHomeIndicatorAutoHidden
  • PrefersStatusBarHidden
  • PreferredStatusBarUpdateAnimation
• VisualElement
  • BlurEffect
  • CanBecomeFirstResponder

Windows

• FlyoutPage
  • CollapseStyle
  • CollapsedPaneWidth
• Page
  • ToolbarPlacement
• TabbedPage
  • HeaderIconsEnabled
• WebView
  • ExecutionMode
  • IsJavaScriptAlertEnabled

Workaround

Use handlers to exercise these APIs at the platform level. See Customize .NET MAUI controls with handlers and Invoke platform code.