5 Operator Play Publishing Runbook
Forgejo Actions edited this page 2026-11-15 20:16:09 +00:00
This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Runbook: Memories Android auf Google Play veröffentlichen

Zuständigkeits-Split: CI baut und signiert (android-vX.Y.Z-Tag → APK + AAB am Forgejo-Release); die Play-Consoles-Schritte sind manuell. Der technische Schlüssel-Teil ist seit 0.9.4 dauerhaft eingerichtet (Release-Keystore, Play App Signing, siehe ADR-Historie/PR #1317/#1318).

1. Release bauen lassen (CI)

# 1. versionName in apps/android/app/build.gradle.kts bumpen
# 2. apps/android/CHANGELOG.md: Abschnitt "## [X.Y.Z] - YYYY-MM-DD"
#    (wird 1:1 zu den Release-Notes; fehlt er, generiert CI aus dem Git-Log).
#    Stil: kompakte en-US-Einzeiler (~160 Zeichen max, PR-Referenz je
#    Bullet, keine deutschen UI-Begriffe — Details: Checkliste Abschnitt 6).
# 3. PR auf main, CI grün, mergen
# 4. Tag auf dem Merge-Commit:
git fetch origin main
git tag -a android-v0.9.X -m "Memories Android 0.9.X" origin/main
git push origin android-v0.9.X
# 5. Warten auf Workflow "Android Release" (buildet APK + AAB, gate auf
#    Fingerprint 53e9…ec13), Assets erscheinen am Forgejo-Release:
#    memories-android-0.9.X.apk + memories-android-0.9.X.aab

R8 note (since 0.10.22): Release builds are minified and obfuscated with R8 plus resource-shrunk (apps/android/app/build.gradle.kts, isMinifyEnabled/isShrinkResources), so crash traces from release builds need deobfuscation. Play Console handles this automatically from the uploaded AAB — the mapping file is embedded in the bundle. For sideloaded APKs or local retrace, download memories-android-X.Y.Z-mapping.txt from the Forgejo release and deobfuscate with the Android build-tools retrace tool. Keep apps/android/app/proguard-rules.pro empty unless R8's output actually demands a rule.

2. Release-Keystore (nicht einrichten — nur referenzieren)

  • Datei: ~/.config/memories/memories-android-release.keystore (alias memories, PKCS12, SHA-256 53e94001…ec13), Doku + Passwort in ~/.config/memories/SECRETS.txt, Attachment im Bitwarden.
  • Forgejo-Secrets (existieren): ANDROID_RELEASE_KEYSTORE_BASE64, ANDROID_RELEASE_KEYSTORE_PASSWORD.
  • Verlust-Szenario: Google Play signiert die Store-APKs mit genau diesem Schlüssel (Play App Signing, per PEPK hochgeladen). Keystore weg = nur noch Key-Upgrade mit Zwangs-Neuinstallation für alle Play-Nutzer.
  • Debug-Kanal (rolling android-ci APKs) nutzt weiter den Debug-Key (ANDROID_DEBUG_KEYSTORE_BASE64) — bewusst getrennt.

3. Update auf Play hochladen (manuell, ~10 Minuten)

  1. memories-android-0.9.X.aab vom Forgejo-Release herunterladen.
  2. Play Console → Testing → Closed testing (oder nach Production-Unlock: Production) → Create new release.
  3. AAB hochladen, Release-Name 0.9.X (900X), kurze Notes (aus dem CHANGELOG-Abschnitt übernehmen).
  4. Review einsenden. Closed-Testing-Releases: Review Stunden bis ~2 Tage.

4. Closed-Testing-Pflicht (nur beim ersten Production-Unlock)

Gilt für private Entwicklerkonten ab Nov. 2023: ≥ 12 fortlaufend opted-in Tester über 14 Tage, danach Production-Access-Antrag (Fragen zum Test). Internal Testing zählt NICHT. Einmal Production Access → keine erneute Pflicht für Updates.

  • Tester: E-Mail-Liste mit 14–15 Einträgen (Puffer), Google-Konten.
  • Länder des Tracks: Wohnländer der Tester.
  • Opt-in-Link an Tester; Opt-in zählt ab Klick, nicht ab Listeneintrag.

5. Store-Setup (einmalig)

Alle Play-Console-Texte (Store listing, Release notes, Deklarationen) werden auf Englisch (en-US) eingepflegt — auch wenn das Produkt teilweise Deutsch spricht; en-US ist die Console- und Review-Lingua franca und vermeidet Sprach-Mismatch-Ablehnungen.

Siehe docs/play-store-listing.md (Texte + Data-Safety/Content-Rating-Spiegel, enthält DE- und EN-Fassungen der Listing-Texte) und docs/wiki/user/privacy-policy.md (öffentliche URL dem Play-Listing hinterlegen).

6. Checkliste pro Release

  • versionName gebumpt, CHANGELOG-Abschnitt geschrieben
  • PR gemerged, Tag gepusht, Android-Release-Workflow grün
  • AAB vom Forgejo-Release geladen
  • Play-Release erstellt, Review durch
  • Play-Release-Notes: en-US only, im Format <en-US> ...notes... </en-US> (Play verlangt den Locale-Wrapper; ohne ihn wird das Feld abgelehnt).
  • Changelog-/Release-Notes-Stil (seit 2026-11-15, PR #1526 + Backfill aller historischen android-v*-Releases): kompakte en-US-Einzeiler, ~160 Zeichen max, PR-Referenz je Bullet, ### Fixed/Added/Changed. Der Forgejo-Release-Text ist der CHANGELOG-Abschnitt 1:1 — also en-US, nicht Deutsch, auch nicht lang-form. Keine deutschen UI-Begriffe in en-US-Notes: Tab-Labels werden übersetzt ("More tab", nicht "MEHR"). Play-Notes = derselbe Inhalt im <en-US>-Wrapper.
  • Store listing: alle Felder en-US (App name, short/full description)
  • (nur nötig im Ausnahmefall) Fingerprint-Abweichung Play vs. 53e9…ec13? → PEPK-/Keystore-Historie prüfen, NICHT selbst „reparieren"