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
190 lines
7 KiB
Markdown
190 lines
7 KiB
Markdown
# Beta-Onboarding (geschlossene Beta)
|
||
|
||
Ablauf für Test-Builds: Besucher fragen per Mail an, du antwortest mit einem
|
||
direkten Link, der Tester installiert und gibt Feedback. Kein Formular, kein
|
||
Login, keine Datenbank.
|
||
|
||
## 1. Website
|
||
|
||
`rinkplanner.programmschmiede.de` zeigt keine Download-Buttons mehr, sondern
|
||
**„Beta-Zugang anfragen“**. Der Button öffnet eine vorbereitete Mail an
|
||
`kontakt@programmschmiede.de` – pro Plattform mit passendem Betreff und
|
||
Plattform-Zeile im Text. Die direkten Build-URLs stehen nicht auf der Seite.
|
||
|
||
## 2. Build veröffentlichen
|
||
|
||
Nach dem Bauen:
|
||
|
||
```bash
|
||
./tools/export_macos_installer.sh # build/macos/rinkplanner-setup.dmg
|
||
./tools/export_windows_installer.sh # build/windows/rinkplanner-setup.exe
|
||
./tools/export_android.sh debug # build/android/rinkplanner-debug.apk
|
||
```
|
||
|
||
Dann:
|
||
|
||
```bash
|
||
./tools/publish_beta_build.sh # Beta + Update-Kopien hochladen
|
||
```
|
||
|
||
Das Script:
|
||
|
||
- liest die Version aus `rinkplanner/project.godot`,
|
||
- lädt die vorhandenen Builds nach `rinkplanner/beta/<version>/`,
|
||
- lädt macOS/Windows zusätzlich nach `rinkplanner/download/` (dort zeigt
|
||
`version.json` hin, damit der In-App-Updater weiter funktioniert),
|
||
- gibt die Links aus und schreibt sie nach `build/beta-links.txt`.
|
||
|
||
Fehlt `build/macos/rinkplanner-setup.dmg`, übernimmt das Script die
|
||
veröffentlichte DMG **derselben Version** aus `/rinkplanner/download/` und
|
||
prüft die SHA-256. So ist der macOS-Link auch ohne Mac vollständig. Auf einem
|
||
Mac baut `--build-macos` das DMG vorher neu:
|
||
|
||
```bash
|
||
./tools/publish_beta_build.sh --beta-only --build-macos
|
||
```
|
||
|
||
Mit `--no-live-macos` wird die Übernahme abgeschaltet; dann wird nur
|
||
veröffentlicht, was lokal gebaut wurde.
|
||
|
||
Der Beta-Ordner ist **deterministisch**:
|
||
|
||
```
|
||
https://programmschmiede.de/rinkplanner/beta/0.4.0/rinkplanner-setup.dmg
|
||
https://programmschmiede.de/rinkplanner/beta/0.4.0/rinkplanner-setup.exe
|
||
https://programmschmiede.de/rinkplanner/beta/0.4.0/rinkplanner-debug.apk
|
||
```
|
||
|
||
Kein FTP-Client, kein Suchen nach dem neuesten Zufallsordner. Die Version
|
||
steht in `project.godot`; bei einem neuen Build die Version erhöhen, dann
|
||
stimmt der Ordner.
|
||
|
||
### Nur Links anzeigen
|
||
|
||
```bash
|
||
./tools/publish_beta_build.sh --no-upload
|
||
```
|
||
|
||
### Nur den Beta-Ordner hochladen
|
||
|
||
```bash
|
||
./tools/publish_beta_build.sh --beta-only
|
||
```
|
||
|
||
Damit bleiben die öffentlichen Update-Dateien unter `/download/` unangetastet.
|
||
|
||
## 3. Antwort-Mail
|
||
|
||
```bash
|
||
./tools/publish_beta_build.sh --mail macos
|
||
```
|
||
|
||
Gibt eine komplette Mailvorlage mit Link und Installationshinweisen aus.
|
||
Analog `--mail windows`, `--mail android` oder `--mail all`.
|
||
|
||
Wenn eine Datei lokal fehlt, markiert das Script den Link als
|
||
„(nicht gebaut)“ und warnt bei `--mail`. Dann keinen toten Link verschicken.
|
||
|
||
## 4. Tester-Liste
|
||
|
||
Eine einfache Tabelle reicht, keine CRM-Software:
|
||
|
||
| Datum | Name | E-Mail | Plattform | Build | Beta-Hinweis zugesagt | Feedback |
|
||
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
||
| 2026-11-14 | … | … | macOS | 0.4.0 | ja | … |
|
||
|
||
Nach der Beta löschen. Keine Adressen ohne Einwilligung in einen Newsletter
|
||
übernehmen.
|
||
|
||
## 5. Was die Mail zusagt
|
||
|
||
- Testversion, keine Gewähr, Küren vorher sichern.
|
||
- macOS ad-hoc signiert, nicht notarisiert (Rechtsklick → Öffnen).
|
||
- Windows unsigniert (SmartScreen → „Weitere Informationen“ → „Trotzdem
|
||
ausführen“).
|
||
- Android Debug-Signatur (Sideloading erlauben).
|
||
- Feedback per Mail; optional Einladung in den Kür-Hub.
|
||
|
||
## 6. Android-APK installieren (Tester)
|
||
|
||
Weder Play Store noch Entwickleroptionen sind nötig. Der Tester lädt die APK
|
||
und erlaubt einmalig „Unbekannte Apps“ für den Browser bzw. Dateimanager.
|
||
|
||
1. Link in Chrome öffnen und die APK herunterladen (ca. 33 MB).
|
||
2. Download-Benachrichtigung antippen oder Chrome → Downloads → APK.
|
||
3. Falls Android blockt: „Einstellungen“ im Dialog → „Unbekannte Apps
|
||
installieren“ → Chrome (oder „Dateien“) erlauben → zurück → Installieren.
|
||
4. Play Protect: „Weitere Details“ → „Trotzdem installieren“.
|
||
5. Installieren → Öffnen.
|
||
|
||
Auf Samsung (Galaxy Tab S9+): Einstellungen → Apps → Spezieller Zugriff →
|
||
Unbekannte Apps installieren → Chrome/Dateien → zulassen. Der Dialog beim
|
||
Öffnen der APK führt meist direkt dorthin.
|
||
|
||
Entwickleroptionen und USB-Debugging braucht nur, wer die APK per
|
||
`adb install` vom Rechner aus installiert. Für den Link im Browser ist das
|
||
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; 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. 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
|
||
würde Updates mit HTTP 401 abbrechen. Der geschützte Teil ist die
|
||
**Onboarding-Mail**, nicht die Update-URL.
|
||
|
||
Der Beta-Ordner `/rinkplanner/beta/` ist nicht verlinkt, aber auch nicht
|
||
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.
|
||
|
||
## 9. Aufräumen
|
||
|
||
Alte Beta-Ordner nach einigen Releases löschen:
|
||
|
||
```
|
||
rinkplanner/beta/0.4.0/
|
||
rinkplanner/beta/0.5.0/
|
||
```
|
||
|
||
Die jeweils aktuelle Version steht in `project.godot` und in
|
||
`build/beta-links.txt`.
|