Skip to content

Android ​

The Android host is a .NET for Android app that packages your game as an APK. Godot's own Activity owns the screen, render loop, input, and lifecycle. The host registers the .NET runtime before Godot starts.

Experimental

The host supports only android-arm64 and android-x64.

Set It Up ​

bash
dnx 2dog add --android

This creates MyGame.android/ next to project.godot, with the project file, an Application that calls AndroidHost.Register, and a launcher activity. It also adds an Android export preset. Set ApplicationId in the project file to your own package name.

You also need the .NET android workload (the tool offers to install it), an Android SDK, and JDK 17.

2dog new, add, update, and doctor look for the SDK in these places:

If the SDK is missing, they show a warning. See Android SDK setup to install the required components.

Build and Install ​

bash
dotnet publish MyGame.android -r android-arm64
adb install MyGame.android/bin/Release/net10.0-android/android-arm64/publish/*-Signed.apk

dotnet publish builds the game, exports its pack with the Android preset, and packages a signed APK named after the ApplicationId. For an x64 emulator, use -r android-x64. Start the emulator with -gpu swangle or -gpu host.

See Android Configuration for build settings and signing.

Host Code ​

Do not call Engine.Start(), because Godot runs the loop. To access the scene from host code, register a listener with TwoDogActivity.addMainLoopStartedListener. The listener runs on Godot's thread when the main scene is ready.

GDExtensions ​

Extensions need an Android library for each ABI, listed under android.arm64 and android.x86_64 keys in their .gdextension file. Publishing packages them into the APK. Every listed library must exist, because the pack export copies them.

Trimming and AOT ​

Like any .NET for Android app, Release builds are trimmed and AOT-compiled. See Trimming and Mono AOT and the experimental Native AOT option.

Limitations ​

  • Input, pause/resume, and process restarts are not tested yet.

2dog is Free and Libre Open Source under the MIT License.
2dog is not affiliated with or endorsed by the Godot Foundation.
Godot is licensed under the MIT License; the Godot logo is by Andrea Calabró under CC BY 4.0. @icons made by Voxy under the MIT License.
Continuous Integration compute graciously supported by Blacksmith.