diff --git a/docs/beta-onboarding.md b/docs/beta-onboarding.md index dcb8228..8dcbc4d 100644 --- a/docs/beta-onboarding.md +++ b/docs/beta-onboarding.md @@ -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: diff --git a/tools/publish_beta_build.sh b/tools/publish_beta_build.sh index 899d213..b8c7732 100755 --- a/tools/publish_beta_build.sh +++ b/tools/publish_beta_build.sh @@ -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