Skip to content

MAUI Configuration ​

Set properties in MyGame.maui.csproj. It references 2dog.engine and 2dog.maui at $(TwoDogVersion), and Microsoft.Maui.Controls at $(TwoDogMauiVersion) from the generated root Directory.Build.props.

Platform Properties ​

PropertyDefaultPurpose
TargetFrameworksnet10.0-android, plus net10.0-windows10.0.19041.0 on WindowsSupported MAUI targets; build with -f
GodotProjectDir..Game project used for resource import and pack export
RuntimeIdentifierwin-x64 on Windows, android-arm64 on AndroidNative architecture; Android also supports android-x64
TwoDogVariantdebug in Debug, release otherwiseNative engine variant; build the MAUI host in Debug or Release
WindowsPackageTypeNoneUnpackaged Windows application
WindowsAppSDKSelfContainedtrue on WindowsCarry the Windows App SDK runtime
PublishSelfContainedtrue on WindowsCarry the .NET runtime in published Windows output
TwoDogAndroidGameAssemblyGame assembly nameAssembly extracted before Android engine startup
AndroidPackageFormatsapkSideloadable Android package; choose aab for store distribution

The Android target references 2dog.android and the native meta package for the selected RID, exact-pinned to $(TwoDogNativesVersion). It uses the same game pack export, signing, and trimming targets as the Android host. Native AOT is not supported by this MAUI host. Android Release uses Mono AOT.

View Properties ​

Set these before adding GodotView to a page:

PropertyDefaultPurpose
ProjectRequiredGame assembly name
ProjectPathnullWindows project directory; packaged games use their pack
ArgumentsEmptyExtra Godot startup arguments
PresentationModeAutoWindows GPU preference and CPU fallback policy
ActivePresentationModenull before startupRead the active GPU or CPU presentation mode

Android always uses Godot's native GPU surface. Windows GPU mode selects the Vulkan mobile renderer by default; additional Arguments can override engine options. A Compatibility renderer uses CPU presentation in Auto mode.

Publish ​

bash
dotnet publish MyGame.maui -f net10.0-windows10.0.19041.0 -c Release
dotnet publish MyGame.maui -f net10.0-android -c Release -r android-arm64

For workload setup, the view lifecycle, and thread-safe commands, see the MAUI host guide.