2026-11-15 18:51:17 +01:00
|
|
|
|
# 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
|
|
|
|
|
|
```
|
|
|
|
|
|
|
2026-11-15 18:57:27 +01:00
|
|
|
|
Gibt eine komplette Mailvorlage mit Link und Installationshinweisen aus –
|
|
|
|
|
|
nur für die gewählte Plattform, damit der Tester keine fremden
|
|
|
|
|
|
Installationsschritte liest. Der Betreff nennt die Plattform. Analog
|
|
|
|
|
|
`--mail windows`, `--mail android` oder `--mail all` (drei getrennte Mails).
|
2026-11-15 18:51:17 +01:00
|
|
|
|
|
|
|
|
|
|
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).
|
2026-11-15 18:56:38 +01:00
|
|
|
|
Für eine längere Beta ist ein eigener Release-Keystore sinnvoll; den Ablauf
|
|
|
|
|
|
für den Wechsel beschreibt Abschnitt 7.
|
2026-11-15 18:51:17 +01:00
|
|
|
|
|
|
|
|
|
|
Der Play Store ist nicht zwingend. „Internal Testing“ wäre der komfortablere,
|
|
|
|
|
|
aber aufwändigere Weg: Play-Console-Konto, AAB, Signierung und Richtlinien.
|
|
|
|
|
|
|
2026-11-15 18:56:38 +01:00
|
|
|
|
## 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
|
2026-11-15 18:51:17 +01:00
|
|
|
|
|
|
|
|
|
|
`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.
|
|
|
|
|
|
|
2026-11-15 18:56:38 +01:00
|
|
|
|
## 9. Aufräumen
|
2026-11-15 18:51:17 +01:00
|
|
|
|
|
|
|
|
|
|
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`.
|