Initialize Android NTP app framework

2026-07-09 15:44:22 -08:00
commit bfb027fcd2
33 changed files with 1196 additions and 0 deletions
@@ -0,0 +1,28 @@
+# 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
+```