Sideload-Installation und Update-Hinweis
ID: APP-002 · Status: 🟢 aktiv · Use Case: UC-APP-002
Die App wird nicht über den Play Store, sondern per Sideloading verteilt (selbst signierte APK, kein Google-Developer-Account nötig). Da damit kein automatisches Store-Update existiert, prüft die App selbst periodisch, ob eine neuere Version verfügbar ist, und zeigt bei Bedarf einen nicht-blockierenden Hinweis mit Download-Link.
Touchpoint
trading-companion-app
Verteilung
| Feld | Wert |
|---|---|
| Hosting | APK unter z.B. https://matus-toolbox.com/downloads/app-latest.apk |
| Signierung | Lokal generierter Release-Keystore, kein Google-Signing |
| Installation | Einmalig "Installation aus unbekannten Quellen" für den Browser/ Dateimanager erlauben, danach normale APK-Installation |
Versionierung
| Feld | Wert |
|---|---|
| Quelle | Statische JSON-Datei, z.B. https://matus-toolbox.com/downloads/version.json mit |
| Wichtige Voraussetzung | version.json UND die APK-Datei müssen ohne Cloudflare-Access-Login öffentlich erreichbar sein – sonst schlägt der Update-Check bzw. der Download für nicht angemeldete Browser-Sessions fehl. Muss beim Cloudflare-Access-Regelwerk explizit ausgenommen werden. |
Update Check
| Feld | Wert |
|---|---|
| Zeitpunkt | Beim App-Start, höchstens 1× pro Tag (kein Polling im Hintergrund) |
| Vergleich | Lokaler versionCode (AndroidManifest) vs. version.json |
| Bei Neuerer Version | Dezenter, nicht-blockierender Hinweis/Banner mit Link zum Download. Kein Zwang, kein Auto-Download, keine Auto-Installation – Android verlangt bei sideloaded APKs ohnehin eine explizite Nutzerbestätigung für die Installation. |
Abnahmekriterien
- [ ] App lässt sich ohne Play Store per Sideloading installieren
- [ ] Beim Start wird höchstens 1× pro Tag ein Versionscheck durchgeführt
- [ ] Bei verfügbarer neuerer Version erscheint ein nicht-blockierender Hinweis mit Download-Link
- [ ] Es findet kein automatischer Download oder keine automatische Installation statt
- [ ] version.json und die APK sind ohne Cloudflare-Access-Login erreichbar
- [ ] Fehlschlagender Versionscheck (z.B. offline) führt zu keinem Fehler, nur zu keinem Hinweis
Changelog
Eintrag 1
Version: 1.0
Changes: Initiale Version – Sideload-Installation und Update-Hinweis