keepassgo/APK.md

Android Build

Build the APK with:

make apk

Environment:

• ANDROID_SDK_ROOT defaults to /opt/android-sdk.
• ANDROID_NDK_ROOT defaults to /opt/android-ndk.
• JAVA_HOME defaults to /usr/lib/jvm/java-25-openjdk.
• APP_ID overrides the Android application id.
• APK_OUT overrides the output path.
• APK_VERSION overrides the packaged app version.
• ANDROID_MIN_SDK overrides the minimum supported Android SDK.
• ANDROID_TARGET_SDK overrides the target Android SDK.

Installed machine prerequisites expected by this repo:

• android-sdk-cmdline-tools-latest
• android-sdk-build-tools
• android-platform-35
• android-sdk-platform-tools
• a working JDK install

The repo tracks gogio as a Go tool, so the build runs through:

go tool gogio -target android ...

The Android build uses the branded icon asset at:

• assets/keepassgo-icon.png

Note:

• Gio's Android doc currently references Java 1.8, but the Android build-tools installed on this machine (d8 from build-tools 37) do not run on Java 8.
• In this environment, KeePassGO's APK build requires a newer JDK runtime on PATH, which is why the repo defaults JAVA_HOME to /usr/lib/jvm/java-25-openjdk.
• Android runtime testing on the KeepassGoAPI35 emulator showed a black-screen regression with gioui.org v0.9.0 while a stock Gio example and KeePassGO both rendered correctly with gioui.org v0.8.0 on the same emulator and SDK/JDK pipeline. KeePassGO is pinned to the working Gio line until that regression is understood upstream.