Die Mailvorlage listete macOS-, Windows- und Android-Schritte in jeder Mail, auch wenn nur eine APK oder ein Installer verlinkt war. - print_mail bekommt die Plattform als Schlüssel und setzt Installationshinweise über install_hint() zusammen - Betreff nennt die Plattform (Kurzform ohne „(APK)“) - --mail all erzeugt weiterhin drei getrennte Mails - docs/beta-onboarding.md beschreibt das Verhalten
7.1 KiB
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:
./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:
./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 zeigtversion.jsonhin, 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:
./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
./tools/publish_beta_build.sh --no-upload
Nur den Beta-Ordner hochladen
./tools/publish_beta_build.sh --beta-only
Damit bleiben die öffentlichen Update-Dateien unter /download/ unangetastet.
3. Antwort-Mail
./tools/publish_beta_build.sh --mail macos
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).
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 | 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.
- Link in Chrome öffnen und die APK herunterladen (ca. 33 MB).
- Download-Benachrichtigung antippen oder Chrome → Downloads → APK.
- Falls Android blockt: „Einstellungen“ im Dialog → „Unbekannte Apps installieren“ → Chrome (oder „Dateien“) erlauben → zurück → Installieren.
- Play Protect: „Weitere Details“ → „Trotzdem installieren“.
- 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):
- Kür speichern, nicht nur im Autosave lassen, dann „Sync“ drücken.
- Im Ergebnis prüfen, dass die Kür unter den hochgeladenen Dateien steht und nichts unter „Fehler“.
- Cloud-Anbieter (Dropbox oder Google Drive) und Ordnernamen notieren.
Nach der Neuinstallation:
- Sync-Einstellungen öffnen: gleicher Anbieter, gleicher Ordner.
- Konto neu verbinden – das OAuth-Token liegt in
user://sync.cfgund ist mit der App gelöscht. - „Sync“ drücken; Küren und Musikdateien werden aus der Cloud geladen
(
SyncPlanlä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.