158 lines
5.5 KiB
Markdown
158 lines
5.5 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.
|
|||
|
|
|
|||
|
|
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
|
|||
|
|
|
|||
|
|
`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.
|
|||
|
|
|
|||
|
|
## 8. 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`.
|