Dependencies
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.
Building
Install gogio, if you already haven’t:
go install gioui.org/cmd/gogio@latest
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 https://git.sr.ht/~eliasnaur/gio-example
cd gio-example
To build an Android .apk file from the kitchen example:
gogio -target android gioui.org/example/kitchen
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 gioui.org/example/gophers -token <github token>
Integrate
To build a Gio program as an .aar package, use the -buildmode=archive flag. For example,
gogio -target android -buildmode archive gioui.org/example/kitchen
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="http://schemas.android.com/apk/res/android">
...
<uses-sdk android:minSdkVersion="16" android:targetSdkVersion="28" />
<uses-feature android:glEsVersion="0x00030000"/>
...
<application android:label="Gio">
<activity android:name="org.gioui.GioActivity"
android:theme="@style/Theme.GioApp"
android:configChanges="orientation|keyboardHidden"
android:windowSoftInputMode="adjustResize">
</activity>
</application>
...
</manifest>
and launch it from another Activity with
startActivity(new Intent(this, GioActivity.class));