.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 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.
.NET 8 Preview 7
Blazor Hybrid applications do not respond to clicks and/or cause JavaScript errors such as No interop methods are registered for renderer.
Follow these instructions for a workaround: https://github.com/dotnet/maui/issues/16609#issuecomment-1672166849
A fix for this issue will ship in the subsequent pre-release.
General Info
- How to Contribute
- Handler Property PR Guidelines
- Official Documentation
- Roadmap
- FAQs
- Nightly Builds
- Releases