docs: Sichern und Umstieg auf Release-Signatur beschreiben

Deinstallieren löscht user://, also auch user://routines. Wer vorher
synchronisiert hat, bekommt die Küren beim ersten Sync zurück – der Sync
selbst ist aber manuell.

- neuer Abschnitt 7: Ablauf vor und nach dem Wechsel Debug → Release
- was der Sync abdeckt (JSON, Legacy-tres, Musik) und was nicht
  (Einstellungen, Kalibrierung, Hub-Token, Autosave)
- Abschnitte 7/8 zu 8/9 umnummeriert, Querverweis aus Abschnitt 6
- Mailvorlage in publish_beta_build.sh erklärt das Sichern per Sync
This commit is contained in:
torsten 2026-11-15 18:56:38 +01:00
parent c34898ddad
commit 44c63ee3fa
2 changed files with 42 additions and 3 deletions

View file

@ -127,12 +127,45 @@ nicht nötig.
Die APK ist debug-signiert. Updates müssen mit demselben Debug-Keystore
gebaut werden, sonst verlangt Android eine Neuinstallation (Datenverlust).
Für eine längere Beta ist ein eigener Release-Keystore sinnvoll.
Für eine längere Beta ist ein eigener Release-Keystore sinnvoll; den Ablauf
für den Wechsel beschreibt Abschnitt 7.
Der Play Store ist nicht zwingend. „Internal Testing“ wäre der komfortablere,
aber aufwändigere Weg: Play-Console-Konto, AAB, Signierung und Richtlinien.
## 7. Wichtig: Update-Kanal nicht schützen
## 7. Umstieg auf Release-Signatur
Sobald die Beta mit einem eigenen Release-Keystore signiert wird, verlangt
Android eine Neuinstallation: Eine APK mit anderer Signatur kann die
installierte Debug-App nicht überschreiben. Deinstallieren löscht `user://`,
also auch `user://routines`. Was vorher synchronisiert wurde, holt der erste
Sync zurück – alles andere ist weg.
**Vor dem Deinstallieren (Tester):**
1. Kür speichern, nicht nur im Autosave lassen, dann „Sync“ drücken.
2. Im Ergebnis prüfen, dass die Kür unter den hochgeladenen Dateien steht
und nichts unter „Fehler“.
3. Cloud-Anbieter (Dropbox oder Google Drive) und Ordnernamen notieren.
**Nach der Neuinstallation:**
1. Sync-Einstellungen öffnen: gleicher Anbieter, gleicher Ordner.
2. Konto neu verbinden – das OAuth-Token liegt in `user://sync.cfg` und ist
mit der App gelöscht.
3. „Sync“ drücken; Küren und Musikdateien werden aus der Cloud geladen
(`SyncPlan` lädt bei leerem Sync-Stand alles, was nur auf dem Server
liegt).
Der Sync deckt `user://routines` ab: `.json`, Legacy `.tres` und Musik
(`.mp3`, `.ogg`, `.wav`). Nicht in der Cloud: Einstellungen
(`user://app.cfg`), Kalibrierung, Hub-Token, Autosave. Ein lokal gelöschter
Eintrag wird beim Sync nicht in der Cloud gelöscht, sondern übersprungen.
Der Sync ist manuell. Wer seit der letzten Änderung nicht synchronisiert hat,
verliert genau diesen Stand bei der Neuinstallation.
## 8. Wichtig: Update-Kanal nicht schützen
`version.json` und `/rinkplanner/download/` bleiben öffentlich. Der
In-App-Updater kann keine Zugangsdaten eingeben; Basic Auth auf diesem Pfad
@ -144,7 +177,7 @@ zugangsgeschützt. Wenn ein Link weitergegeben wird: neuen Build mit neuer
Version bauen, neuen Ordner veröffentlichen, alten Ordner löschen. Für eine
geschlossene Beta mit persönlicher Einladung ist das ausreichend.
## 8. Aufräumen
## 9. Aufräumen
Alte Beta-Ordner nach einigen Releases löschen:

View file

@ -180,6 +180,12 @@ Das ist eine Testversion: Bitte vorher Küren sichern, keine Gewähr,
Feedback ist willkommen. Wenn du magst, lade ich dich in den Kür-Hub ein –
dann können wir Küren teilen.
Wichtig zum Sichern: Rinkplanner synchronisiert Küren und Musik nur, wenn du
„Sync“ drückst (Dropbox oder Google Drive). Vor einem neuen Build also Kür
speichern und synchronisieren. Nach einer Neuinstallation einmal den
Cloud-Ordner neu verbinden und erneut synchronisieren – dann sind alle
Küren wieder da. Einstellungen und Kalibrierung werden nicht mitgesichert.
Viele Grüße
Torsten
EOF