ntp-android/project-docs/runbooks/gitea-apk-builds.md
WayfinderAK bfb027fcd2
Some checks failed
android-apk / debug-apk (push) Has been cancelled
Initialize Android NTP app framework
2026-07-09 15:44:22 -08:00

848 B

Gitea APK Build Runbook

Can Gitea build the APK automatically?

Yes. Gitea Actions can build Android APKs automatically on push or manual dispatch if an Actions runner is available with Docker or enough tooling to install Android commandline tools.

Debug APKs

Debug APKs are straightforward and do not need signing secrets. The workflow in .gitea/workflows/android-apk.yml builds app/build/outputs/apk/debug/app-debug.apk and uploads it as an artifact.

Release APKs

Release APKs should be added later after creating secrets:

  • ANDROID_KEYSTORE_BASE64
  • ANDROID_KEYSTORE_PASSWORD
  • ANDROID_KEY_ALIAS
  • ANDROID_KEY_PASSWORD

Never commit keystores or passwords.

Local fallback

If the runner cannot install Android SDK components or dependency downloads are blocked, build locally with:

make build-debug