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

29 lines
848 B
Markdown

# 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:
```bash
make build-debug
```