Table of contents
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(aliasmemories, PKCS12, SHA-25653e94001…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)
memories-android-0.9.X.aabvom Forgejo-Release herunterladen.- Play Console → Testing → Closed testing (oder nach Production-Unlock: Production) → Create new release.
- AAB hochladen, Release-Name
0.9.X (900X), kurze Notes (aus dem CHANGELOG-Abschnitt übernehmen). - 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"
Memories Wiki
Using Memories
- Accounts, the Library Hub, and Data Export
- Albums and Automatic Suggestions
- Explore and Discovery Domains
- The Media Viewer
- People and Faces
- Places and Map
- Plants (In Development)
- Datenschutzerklärung (Privacy Policy)
- Fast, Progressive Image Loading
- Search
- Sharing and Households
- Timeline and Photos
- Uploading and Import
Self-Hosting
- Backup and Restore
- CLI Password Reset
- Deployment Architecture
- Known Issues and Operator Diagnostics
- Map Tiles and Place Data Privacy
- Storage Layout
- Upgrades and Versioning
- Workers
Reference