For Android you need the Android SDK with the NDK bundle installed. Gio currently requires SDK versions >= 31.

Point the ANDROID_SDK_ROOT to the SDK root directory. To install the NDK bundle use the sdkmanager command that comes with the SDK:

sdkmanager ndk-bundle

To run Gio programs on the emulator, you may need to enable OpenGL ES 3.

You will also need OpenJDK 1.8, as part of the Android build toolchain requires it. More recent versions of Java will break the build.


Install gogio, if you already haven’t:

go install

All of the following example commands assume you’re working from a clone of the gio-example repo. Run this once to make a local clone:

git clone
cd gio-example

To build an Android .apk file from the kitchen example:

gogio -target android

The apk can be installed to a running emulator or attached device with adb:

adb install kitchen.apk

The gogio tool passes command line arguments to os.Args at runtime:

gogio -target android -token <github token>


To build a Gio program as an .aar package, use the -buildmode=archive flag. For example,

gogio -target android -buildmode archive

produces kitchen.aar, ready to include in an Android project.

To display the Gio Android Activity, declare it in your AndroidManifest.xml:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="">
	<uses-sdk android:minSdkVersion="16" android:targetSdkVersion="28" />
	<uses-feature android:glEsVersion="0x00030000"/>
	<application android:label="Gio">
		<activity android:name="org.gioui.GioActivity"

and launch it from another Activity with

startActivity(new Intent(this, GioActivity.class));