docs: Beta-Mail nur mit den Hinweisen der eigenen Plattform

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
This commit is contained in:
torsten 2026-11-15 18:57:27 +01:00
parent 44c63ee3fa
commit aa17e2a4fb
2 changed files with 50 additions and 11 deletions

View file

@ -79,8 +79,10 @@ Damit bleiben die öffentlichen Update-Dateien unter `/download/` unangetastet.
./tools/publish_beta_build.sh --mail macos
```
Gibt eine komplette Mailvorlage mit Link und Installationshinweisen aus.
Analog `--mail windows`, `--mail android` oder `--mail all`.
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.

View file

@ -97,6 +97,15 @@ platform_label() {
esac
}
## Kurzform ohne Zusatz, für den Mailbetreff.
platform_short() {
case "$1" in
macos) echo "macOS" ;;
windows) echo "Windows" ;;
android) echo "Android" ;;
esac
}
platform_local() {
case "$1" in
macos) echo "$MACOS" ;;
@ -157,24 +166,52 @@ fetch_live_macos() {
echo "Lokales macOS-DMG fehlt; veröffentlichte Version $VERSION übernommen (SHA-256 geprüft)."
}
## Installationshinweise je Plattform. Die Mail bekommt nur die Hinweise der
## Plattform, deren Build verlinkt ist – drei fremde Plattformen im Text
## verwirren mehr, als sie helfen.
install_hint() {
case "$1" in
macos)
cat <<'EOF'
- DMG öffnen und Rinkplanner.app in „Programme“ ziehen.
- Erster Start: Rechtsklick → Öffnen (ad-hoc signiert, nicht notarisiert),
danach genügt ein Doppelklick.
EOF
;;
windows)
cat <<'EOF'
- Setup ausführen und den Anweisungen folgen (per-user, ohne Adminrechte).
- Falls SmartScreen warnt: „Weitere Informationen“ → „Trotzdem ausführen“
(unsigniert).
EOF
;;
android)
cat <<'EOF'
- APK in Chrome oder im Dateimanager öffnen; „Unbekannte Apps
installieren“ für die App einmalig erlauben.
- Play Protect: „Weitere Details“ → „Trotzdem installieren“
(Debug-Signatur).
EOF
;;
esac
}
print_mail() {
local platform="$1"
local link="$2"
local label
label="$(platform_label "$platform")"
cat <<EOF
Betreff: Rinkplanner Beta – dein Zugang
Betreff: Rinkplanner Beta – dein Zugang: $(platform_short "$platform")
Hallo …,
danke für dein Interesse. Hier ist der Test-Build für $platform:
danke für dein Interesse. Hier ist der Test-Build für $label:
$link
Kurz zum Start:
- macOS: DMG öffnen, App in „Programme“ ziehen. Beim ersten Start
Rechtsklick → Öffnen (ad-hoc signiert, nicht notarisiert).
- Windows: Setup ausführen. SmartScreen → „Weitere Informationen“ →
„Trotzdem ausführen“ (unsigniert).
- Android: APK installieren, Sideloading erlauben (Debug-Signatur).
$(install_hint "$platform")
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 –
@ -268,14 +305,14 @@ if [[ -n "$MAIL_PLATFORM" ]]; then
echo
if [[ "$MAIL_PLATFORM" == "all" ]]; then
for platform in macos windows android; do
print_mail "$(platform_label "$platform")" "$BETA_URL/$(platform_name "$platform")"
print_mail "$platform" "$BETA_URL/$(platform_name "$platform")"
echo
done
elif [[ "$MAIL_PLATFORM" == "macos" || "$MAIL_PLATFORM" == "windows" || "$MAIL_PLATFORM" == "android" ]]; then
if [[ ! -f "$(platform_local "$MAIL_PLATFORM")" ]]; then
echo "Achtung: $(platform_local "$MAIL_PLATFORM") fehlt lokal – der Link ist eventuell noch nicht live." >&2
fi
print_mail "$(platform_label "$MAIL_PLATFORM")" "$BETA_URL/$(platform_name "$MAIL_PLATFORM")"
print_mail "$MAIL_PLATFORM" "$BETA_URL/$(platform_name "$MAIL_PLATFORM")"
else
echo "Unbekannte Plattform: $MAIL_PLATFORM (macos|windows|android|all)." >&2
exit 1