KappS Wissensdatenbank · Blog

Google Play App Signing 2026: Upload-Schlüssel, Reset verlorener Schlüssel und Schlüssel-Upgrades

Blog Leitfaden

Jede App auf Google Play wird zweimal signiert: einmal von Ihnen vor dem Upload und einmal von Google, bevor die Datei das Gerät eines Nutzers erreicht. Der Schlüssel hinter dieser zweiten Signatur – der App-Signierungsschlüssel – ist das eine Element einer App, das nicht durch erneutes Hochladen eines Bundles ersetzt werden kann, und seit 2026 liegt ein großer Teil davon in der eigenen Schlüsselinfrastruktur von Google. Dieser Leitfaden behandelt, was Play App Signing tut, wie sich die drei Schlüsseltypen unterscheiden, wie neue und bestehende Apps sich registrieren, welche Fingerabdrücke Ihre API-Anbieter tatsächlich benötigen, was zu tun ist, wenn ein Upload-Schlüssel verloren geht, und wie Upgrades des App-Signierungsschlüssels über Android-Versionen hinweg durchgesetzt werden.


Warum der Signaturschlüssel wichtiger ist als das Konto

Entwicklerkonten lassen sich umbenennen, erneut verifizieren, zwischen Inhabern übertragen und in Organisationen migrieren. Signaturschlüssel nicht. Android entscheidet, ob ein Update legitim ist, indem geprüft wird, ob das neue APK mit demselben Schlüssel signiert ist wie das installierte – bricht diese Kette, bleibt als einzige Möglichkeit, eine „neue Version" zu veröffentlichen, eine andere App zu publizieren und Nutzer zu bitten, sie erneut zu installieren. Das kostet Installationen, Bewertungen und Historie.

Genau diese eine Tatsache ist der Grund, warum es Play App Signing gibt. Seit August 2021 wird von neuen Apps auf Google Play erwartet, dass sie es verwenden, und heute ist es der Standardweg: Google hält den Schlüssel, der die Distributions-APKs signiert, sodass ein verlorener Laptop, ein gestohlener Keystore oder ein ausscheidender Entwickler das Leben einer App nicht mehr beenden können. Was Sie behalten – und was die meisten noch immer „den Keystore“ nennen –, ist der Upload-Schlüssel, und dieser lässt sich zurücksetzen.


Drei Schlüsseltypen, drei sehr unterschiedliche Aufgaben

Die Dokumentation von Play selbst unterscheidet die Schlüssel danach, wer sie hält und was sie signieren. Diese Zuordnung richtig hinzubekommen, verhindert sowohl Authentifizierungsfehler (falscher Fingerabdruck bei einer API registriert) als auch Panik (die Annahme, ein verlorener Keystore sei fatal).

  • Upload-Schlüssel – von Ihnen verwahrt. Gespeichert in einem Java-Keystore (.jks oder .keystore) und muss ein RSA-Schlüssel mit 2048 Bit oder mehr sein. Sie signieren damit das App-Bundle vor dem Upload; Google prüft damit, dass der Upload von Ihnen stammt. Bei Verlust oder Kompromittierung kann Google ihn zurücksetzen.
  • App-Signaturschlüssel — gehalten von Google Play. Verknüpft mit einem öffentlichen Zertifikat (.der oder .pem). Von Google generierte Schlüssel sind RSA 4096 Bit; selbst bereitgestellte Schlüssel müssen RSA 2048 Bit oder höher sein. Dieser Schlüssel signiert die optimierten APKs, die an Nutzer ausgeliefert werden. Sie können ihn von Google generieren lassen oder Ihren eigenen bereitstellen.
  • Quantensichere Hybrid-Schlüssel – bereitgestellt von Google Play. Eine hybride Signatur, die einen klassischen RSA-Schlüssel mit 4096 Bit mit einem post-quanten ML-DSA-65-Schlüssel kombiniert. Android 17 und höher verifiziert Apps mit dem APK-Signaturschema v3.2; ältere Geräte verifizieren weiterhin über den klassischen Signaturblock. Weil Google für den Pfad vor Android 17 einen separaten klassischen Schlüssel erzeugt, kann eine App am Ende drei verschiedene Schlüssel gleichzeitig verwenden.

Der eigene Hinweis von Google zum Design: Für maximale Sicherheit sollten Ihr Upload-Schlüssel und Ihr App-Signaturschlüssel unterschiedliche Schlüssel sein.

Wenn Google Ihre APKs signiert, versieht es das Manifest zusätzlich mit com.android.stamp.source und com.android.stamp.type, sodass ein ausgeliefertes APK bis zum ursprünglichen Signierer nachverfolgbar bleibt. Änderungen auf dieser Seite erfordern Admin-Berechtigung im Konto – weshalb die Person mit Admin-Rechten faktisch die Zukunft der App kontrolliert, nicht nur ihre Einstellungen.


Was die Anmeldung freischaltet

Play App Signing ist nicht nur ein Dienst zur Schlüsselverwahrung. Wenn Google die aus Ihren Bundles erzeugten optimierten APKs signiert, ermöglicht das den automatischen Schutz und die automatische Übersetzung von Strings (unterstützt durch Gemini-Modelle), und bei Spielen schaltet es Dienste wie Play Games Sidekick, Play-as-you-download und kostenlose Testversionen für kostenpflichtige Titel frei. Eine App, die ihre Signaturschlüssel außerhalb von Play App Signing selbst verwaltet, erhält diese Vorteile schlicht nicht.


Eine neue App anmelden

  1. Erstellen Sie die App. Eine neu erstellte App wird automatisch für die quantensichere hybride Signierung mit Google-generierten Schlüsseln registriert; Google generiert außerdem einen separaten klassischen Schlüssel für Signaturblöcke, die auf Android 16 und niedriger erkannt werden.
  2. Erstellen Sie einen Upload-Schlüssel. Generieren Sie einen Keystore zum Signieren Ihres Release-Bundles – entweder in Android Studio oder über das Java-Dienstprogramm keytool in der Kommandozeile. Bewahren Sie diese Datei und ihre Passwörter so auf, dass Sie in zwei Jahren noch darauf zugreifen können.
  3. Laden Sie das App-Bundle hoch. Ein Release vorzubereiten und die .aab hochzuladen, schließt die automatische Registrierung ab.
  4. Optional den App-Signaturschlüssel ändern. Fortgeschrittene Entwickler, die ihren eigenen Schlüssel verwalten möchten, können dies tun, bevor ein Release in den Tracks „Offener Test" oder „Produktion" veröffentlicht wurde: Gehen Sie zu Protected with Play > Play Store distribution > Go to Play app signing und klicken Sie auf Change the app signing key. Sie können entweder denselben Schlüssel wie für eine andere App im Entwicklerkonto wiederverwenden oder eine Kopie Ihres eigenen App-Signaturschlüssels bereitstellen.

Migration einer bestehenden App

Wenn Sie Ihre Schlüssel noch selbst verwalten und APKs hochladen, können Sie auf Play App Signing umsteigen und erhalten App-Bundles sowie die übrigen Play-Verbesserungen:

  1. Gehen Sie in der Play Console zu Geschützt durch Play > Play-Store-Bereitstellung > Zu Play App Signing wechseln.
  2. Akzeptieren Sie die Nutzungsbedingungen, falls noch nicht geschehen.
  3. Übertragen Sie eine Kopie Ihres ursprünglichen Signaturschlüssels. Laden Sie das PEPK-Tool herunter und folgen Sie den Schritt-für-Schritt-Anleitungen von Google, um Ihren bestehenden Schlüssel aus welchem Repository auch immer zu verschlüsseln und hochzuladen. Das erhält den Update-Pfad für bereits installierte Nutzer.
  4. Neuen Upload-Schlüssel erstellen (empfohlen). Erzeugen Sie einen frischen Schlüssel in Android Studio und registrieren Sie dessen Zertifikat in der Console, damit der Schlüssel für Ihre täglichen Uploads nicht mehr der Schlüssel ist, der für die Nutzer signiert.

Registrieren Sie die richtigen Fingerprints bei Ihren API-Anbietern

Dies ist der Schritt, der Apps nach der Anmeldung zum Scheitern bringt. Dienste wie Google Maps, OAuth oder Facebook Login authentifizieren Ihre App über den Fingerabdruck des App-Signaturschlüssels. Da Google nun die endgültige APK signiert, ist der Fingerabdruck, der die Nutzer erreicht, der von Google verwaltete – Sie müssen daher den Google-verwalteten Fingerabdruck des App-Signaturschlüssels bei jedem Anbieter registrieren, nicht nur den Fingerabdruck des lokalen Upload-Schlüssels.

  • Öffnen Sie Geschützt mit Play > Play Store-Verteilung > Zu Play App Signing wechseln und scrollen Sie zum Abschnitt App-Signaturschlüssel.
  • Kopieren Sie die vom Anbieter geforderten SHA-1- oder SHA-256-Fingerabdrücke und fügen Sie sie in die Konsole dieses Anbieters ein (zum Beispiel Google Cloud Console für Maps und OAuth).
  • Wenn Ihre App quantensichere Hybrid-Signierung verwendet, kopieren und registrieren Sie die Fingerabdrücke von drei Schlüsseln: dem neuen klassischen Schlüssel und dem Post-Quanten-Schlüssel für neuere Geräte sowie dem klassischen Schlüssel für ältere Geräte.
  • Wenn Sie Android App Links verwenden, aktualisieren Sie assetlinks.json mit denselben Fingerabdrücken.

Wenn der Upload-Schlüssel verloren geht oder kompromittiert wird

Der Verlust eines Upload-Schlüssels sperrt Sie nicht aus Ihrer App aus. Der Wiederherstellungsweg ist dokumentiert und Routine:

  1. Erstellen Sie einen neuen Upload-Schlüssel in Android Studio.
  2. Exportieren Sie das Zertifikat ins PEM-Format:
keytool -export -rfc -keystore upload-keystore.jks -alias upload -file upload_certificate.pem
  1. Gehen Sie in der Play Console zu Geschützt durch Play > Play-Store-Schutz > Play App Signing verwalten.
  2. Klicken Sie im Abschnitt Upload-Key-Zertifikat auf Upload-Key-Reset anfordern.
  3. Geben Sie den Grund für die Zurücksetzung ein, laden Sie die Datei upload_certificate.pem hoch und klicken Sie auf Anfordern.

Bis der Reset verarbeitet ist, können Sie keine neuen Releases hochladen, planen Sie die Wiederherstellung also vor einer Frist, nicht danach. Beachten Sie die Asymmetrie: Der Upload-Schlüssel ist zurücksetzbar, der App-Signaturschlüssel ist nichts, was Sie einfach bei Google auf Anfrage ersetzen lassen können.


Upgrade des App-Signaturschlüssels

Wenn ein App-Signaturschlüssel kompromittiert wird oder Sie einen kryptografisch stärkeren benötigen, unterstützt Play ein jährliches Schlüssel-Upgrade, das für Installationen auf Android 17 (API-Level 37) und höher gilt. Die Durchsetzung unterscheidet sich je nach Plattformversion:

  • Android 17 (API 37) und höher: Die Plattform setzt den aufgerüsteten quantensicheren Hybridschlüssel strikt durch, verifiziert über das APK-Signaturschema v3.2.
  • Android 13 (API 33) bis Android 16 (API 36): Die Plattform setzt Ihren neuesten klassischen Schlüssel gemäß APK-Signaturschema v3.1 strikt durch.
  • Android 7 (API 24) bis Android 12 (API 32): Die Plattform selbst erzwingt den aktualisierten Schlüssel nicht und erkennt weiterhin den neuesten klassischen Schlüssel an. Google Play Protect ergänzt eine Validierung, indem geprüft wird, ob Updates mit Ihrem neuesten klassischen Schlüssel signiert sind — es sei denn, der Nutzer hat das deaktiviert.

Eine Konsequenz wird leicht übersehen: Da die Plattform den aufgerüsteten Schlüssel auf Android 12 und niedriger nicht durchsetzt, erkennen Apps, die denselben Signaturschlüssel über mehrere Apps hinweg teilen, um Daten zu teilen, auf diesen älteren Versionen für Funktionen wie die gemeinsame Nutzung benutzerdefinierter Berechtigungen nur den alten Schlüssel an.

So führen Sie das Upgrade durch: Öffnen Sie Protected with Play > Play Store distribution > Go to Play app signing, klicken Sie im Abschnitt App signing key auf Upgrade key, wählen Sie einen Weg – lassen Sie Google Play einen neuen Schlüssel generieren (empfohlen), verwenden Sie den App-Signaturschlüssel einer anderen App im Konto erneut, oder stellen Sie eine Kopie Ihres eigenen bereit – und klicken Sie auf Save. Registrieren Sie anschließend die neuen Fingerabdrücke bei Ihren API-Anbietern. Bei quantensicherer hybriden Signierung bedeutet das zwei neue Schlüssel: den neuen klassischen Schlüssel und den neuen Post-Quanten-Schlüssel.


Veröffentlichung außerhalb von Google Play

Wenn Sie dieselbe App über andere Android Stores vertreiben und überall eine einheitliche Signaturidentität wollen, haben Sie zwei Optionen:

  • Lassen Sie Google den App-Signaturschlüssel generieren, laden Sie dann ein signiertes universelles APK aus der Play Console herunter (Testen & veröffentlichen > Aktuelle Releases und Bundles, Bundle auswählen, Tab Downloads öffnen) oder über die Play Developer API, und verteilen Sie diese Datei anderweitig.
  • Generieren Sie den App-Signaturschlüssel selbst und übertragen Sie eine Kopie davon an Google, wenn Sie Play App Signing konfigurieren, damit derselbe Schlüssel in allen Stores verwendet wird.

Play App Signing wendet für berechtigte Apps außerdem automatisch das APK-Signaturschema v4 an, um die optimierte Verteilung auf Android 11 und höher zu unterstützen — kein Handlungsbedarf. Ausnahme sind Apps mit quantensicherer Hybrid-Signierung, die noch nicht mit der v4-Signierung kompatibel ist.


Die Fallstricke, die echten Apps echte Installationen kosten

  • Den Upload-Keystore als Wegwerfartikel behandeln. Google kann einen Upload-Schlüssel zurücksetzen, aber Sie können trotzdem nichts hochladen, bis der Reset verarbeitet ist. Sichern Sie die Keystore-Datei und ihre Passwörter außerhalb der Build-Maschine.
  • Es wird nur Ihr lokaler Fingerprint registriert. Nach der Registrierung trägt das ausgelieferte APK den Fingerprint des App-Signierungsschlüssels von Google. Karten, OAuth- und Login-Anbieter, die nur Ihren alten Fingerprint kennen, schlagen fehl.
  • assetlinks.json vergessen. Android Die App-Links-Verifizierung hängt von denselben Fingerabdrücken ab.
  • Änderung des Signaturschlüssels nach der Veröffentlichung. Der Standard-Signaturschlüssel für Apps kann nur geändert werden, bevor etwas für den Offenen Test oder die Produktion ausgerollt wurde – danach nicht mehr. Treffen Sie Schlüsselentscheidungen bei der Erstellung der App, nicht beim ersten Update.
  • Den alten Android-Pfad beim hybriden Signieren ignorieren. Apps mit quantensicherer Signierung haben drei Schlüssel, und Anbieter benötigen alle relevanten Fingerabdrücke, nicht nur den neuesten.
  • Annehmen, dass Updates auf jeder Android-Version gleich funktionieren. Die Durchsetzung aufgewerteter Schlüssel endet bei Android 12, wo Play Protect — nicht die Plattform — die Prüfung übernimmt.
  • Selbst-Hosting des Schlüssels in Ihrem eigenen Cloud-Projekt. Google unterstützt die Registrierung über ein selbst gehostetes Google Cloud-Projekt für sehr spezifische Anforderungen, dokumentiert dies jedoch als nicht standardmäßig und nicht empfohlen: Sie übernehmen die volle Verantwortung für Signiervorgänge, verlieren die Disaster Recovery und können erweiterte Optimierungen, bestimmte Play-Verbesserungen und Funktionen wie quantensicheres hybrides Signieren verlieren. Google kann in diesem Setup ein bestehendes Release nicht neu generieren oder reparieren; die Lösung ist ein neues Release.
  • Schwache Zugriffskontrolle. Auf der Seite für die App-Signierung ist alles auf Admin-Ebene. Erzwingen Sie die 2-Schritt-Verifizierung für jeden Nutzer im Konto.

Das Ein-Zeilen-Modell: Ihr Upload-Schlüssel beweist, wer Sie sind, und kann jederzeit zurückgesetzt werden; der App-Signaturschlüssel beweist die Identität Ihrer App gegenüber jedem installierten Gerät und ist das Asset, das Sie niemals verlieren oder preisgeben dürfen. Melden Sie sich für Play App Signing an, registrieren Sie die von Play verwahrten Fingerprints überall dort, wo Ihre App authentifiziert, und behandeln Sie den Keystore in Ihrer Build-Pipeline als Produktionsinfrastruktur – gesichert, zugriffsbeschränkt und nur bewusst ersetzt.


Sie verwalten Entwicklerkonten im großen Stil? Wir übernehmen die operative Seite.

Klicken Sie, um eine Datei auszuwählen · Rechtsklick → Einfügen oder Ctrl/⌘+V drücken, um einen Screenshot einzufügen

Sie können eine Datei auch auf dieses Feld ziehen.

Wir antworten an die von Ihnen angegebene E-Mail-Adresse. Ihre Daten bleiben bei KappS.

✔ Eingereicht

Wir haben Ihre Nachricht erhalten und antworten innerhalb von 24 Stunden.


← Zurück zum Bearbeiten