KappS Wissensdatenbank · Blog

Google Play Billing-Bibliothek im Jahr 2026

Blog Leitfaden

Jede Android-App, die etwas verkauft – ein Abo, eine einmalige Freischaltung, ein Coin-Paket –, enthält eine Kopie der Billing Library von Google Play. Diese Library ist nicht für immer: Google stellt jede Hauptversion nach einem festen Zwei-Jahres-Zyklus ein, und sobald Ihre Version eingestellt ist, läuft die App zwar weiter, aber Sie können keine Updates mehr ausliefern. Stand 31. August 2026 ist die minimal unterstützte Version Play Billing Library 8, und jedes Release, das noch auf Version 7 oder älter basiert, hat nur noch ein verbleibendes Zeitfenster: die Verlängerungsfrist vom 1. November 2026.

Dies ist die operative Version dieser Migration: was die Deprecation-Tabelle heute tatsächlich aussagt, wie Sie herausfinden, welche Version eine bestimmte APK trägt, die genauen API-Umbenennungen, die den Build brechen, wenn Sie von 7 auf 8 oder 9 springen, wo das Verlängerungsformular liegt und was Sie testen sollten, bevor Sie den Build ausliefern.

Vier Zahlen entscheiden über diese Migration: 2 Jahre – der Deprecation-Zyklus, der seit Google die Richtlinie auf der I/O 2019 angekündigt hat, für jede Hauptversion der Play Billing Library gilt. 31. August 2026 – das Datum, bis zu dem neue Apps und Updates Version 8 oder höher verwenden müssen (das ist die v7-Frist). 1. November 2026 – die Verlängerungsfrist für dieselbe Version. 8 – die niedrigste Version, die Google Play heute in einem neuen Release akzeptiert.

1. Wo die Frist heute tatsächlich steht

Der Banner auf der Seite von Google zur Deprecation der Play Billing Library-Version lautet: „Bis zum 31. August 2026 müssen alle neuen Apps und Updates bestehender Apps Billing Library Version 8 oder höher verwenden. Wenn Sie mehr Zeit für das Update Ihrer App benötigen, können Sie eine Verlängerung bis zum 1. November 2026 beantragen." Dieser Satz ist die ganze Regel, und er hat zwei Hälften, die oft verwechselt werden.

Die erste Hälfte ist eine Auslieferungsbeschränkung, keine Entfernung: Eine App, die noch eine eingestellte Version enthält, funktioniert für Nutzer, die sie bereits installiert haben, weiter, aber Play akzeptiert Ihr neues Release nicht. Die Deprecation-FAQ formuliert die Kehrseite klar – nicht gepflegte APKs müssen nicht aktualisiert werden, während neue Apps und Updates eine unterstützte Version verwenden müssen. Das Risikoprofil lautet also nicht „meine App verschwindet aus dem Store", sondern „ich kann den Fix, das neue Store-Eintrag-Experiment oder das Compliance-Update nicht ausliefern, bis das erledigt ist".

Die zweite Hälfte ist der Ausweg: die Verlängerung. Sie wird in der Play Console beantragt und gilt ebenfalls bis zu einem festen Kalenderdatum statt eines neuen Countdowns – die praktische Frage für alle, die Ende September 2026 noch auf v7 sind, ist also nicht, ob sie Zeit haben, sondern ob die Verlängerung bereits eingereicht wurde.

2. Die Deprecation-Uhr ist festgelegt und wird im Voraus veröffentlicht

Google hat die vollständige Deprecation-Tabelle veröffentlicht, und es lohnt sich, sie als Zeitplan statt als Warnung zu lesen. Jede Hauptversion erhält eine Frist für „neue Apps und Updates" von 31. August und eine Verlängerungsfrist von 1. November, zwei Jahre später:

  • Version 5 – neue Frist für Apps und Updates: 31. August 2024; Frist für Verlängerung: 1. November 2024.
  • Version 6 — 31. August 2025; Verlängerung 1. November 2025.
  • Version 7 — 31. August 2026; Verlängerung 1. November 2026.
  • Version 8 — 31. August 2027; Verlängerung 1. November 2027.
  • Version 9 — 31. August 2028; Verlängerung 1. November 2028.

Daraus folgen zwei Schlussfolgerungen. Erstens: Eine App, die 2025 bereits zwei Versionen hinterher war, ist jetzt drei hinterher, und der Aufwand ist heute derselbe wie damals. Zweitens: Dies ist ein dauerhafter Wartungsposten, kein einmaliges Projekt – welche Version Sie diesmal auch wählen, in weniger als zwei Jahren stehen Sie wieder hier. Die Anhebung mit Ihrem regulären Release-Zug zu planen ist günstiger, als auf eine Console-Warnung zu reagieren.

3. Schritt 1 — Finden Sie heraus, was Ihr Release tatsächlich ausliefert

Beginnen Sie mit build.gradle. Die Billing Library ist als Abhängigkeit von com.android.billingclient:billing deklariert, und ihr Versionsstring ist Ihre Antwort:

dependencies { def billingVersion = "8.3.0" implementation "com.android.billingclient:billing:$billingVersion" }

Die Deprecation-FAQ ergänzt ein wichtiges Detail: Diese Abhängigkeiten erscheinen nur in APKs, die die Berechtigung com.android.vending.BILLING erfordern. In einem Multi-Modul-Projekt oder einem Portfolio, in dem einige Apps ein älteres gemeinsames Modul nutzen, ist der problematische Build derjenige, der Billing deklariert – nicht unbedingt die App, an die Sie denken. Prüfen Sie jedes Bundle, das Billing ausliefert, nicht nur die, für die Sie sich erinnern, Zahlungscode geschrieben zu haben.

Es gibt außerdem eine Prüfung auf Platz zwei, die eine hartnäckige Warnung erklärt. Play ermittelt die Bibliotheksversion aus dem Attribut com.google.android.play.billingclient.version in der zusammengeführten AndroidManifest.xml. Wenn Sie die Abhängigkeit bereits aktualisiert haben und die Console weiterhin eine veraltete Version meldet, lautet die offizielle Empfehlung, zu bestätigen, dass dieses Attribut vorhanden ist – das Zusammenführen des Manifests ist der übliche Grund, warum es fehlt.

4. Schritt 2 — Ziel wählen: Version 8 oder Version 9

Die Anforderung lautet „Version 8 oder höher", was bedeutet, dass sowohl 8.x als auch 9.x sie erfüllen. Der Zielkonflikt ist real, also treffen Sie die Entscheidung bewusst.

  • Version 8 — veröffentlicht am 30. Juni 2025; die 8.x-Reihe endete mit 8.3.0 am 23. Dezember 2025. Es ist der kleinere Diff, und wenn Ihr Code auf v7 läuft, sind die Kompilierungsfehler wenige und mechanisch.
  • Version 9 – 9.0.0 veröffentlicht am 19. Mai 2026 und 9.1.0 veröffentlicht am 18. Juni 2026. Neueste APIs, und es aktualisiert targetSdkVersion auf 35, was Sie gegen die API-Level-Anforderung abwägen sollten, die Sie bereits für die Play-Richtlinie zum Ziel-API-Level erfüllen.

Wenn Sie dies auch lesen, um den nächsten Zyklus zu planen: Die eigene Frist von v8 ist der 31. August 2027 mit Verlängerung bis zum 1. November 2027. Wer heute auf 9.1.0 migriert, gewinnt den längsten Vorlauf, und der v9-Migrationsleitfaden ist für Teams geschrieben, die direkt von 7 oder 8 kommen.

5. Schritt 3 — die Migration von v7 auf v8 selbst

Laut dem offiziellen Migrationsleitfaden für Play Billing Library 8 besteht das Upgrade aus drei Schritten plus optionaler Arbeit.

Schritt eins: Abhängigkeit aktualisieren. Setzen Sie com.android.billingclient:billing auf 8.0.0 oder höher (verwenden Sie den neuesten Patch der Reihe, nicht das .0-Release, sofern Sie keinen Grund dazu haben).

Schritt zwei: die umbenannten Abo-APIs behandeln. Das sind die Aufrufe, die die Kompilierung brechen, wenn Sie von PBL 6 kommen; die Alternativen sind reine Umbenennungen:

  • setOldSkuPurchaseToken → setOldPurchaseToken
  • setReplaceProrationMode → setSubscriptionReplacementMode
  • setReplaceSkusProrationMode → setSubscriptionReplacementMode

Schritt drei: queryProductDetailsAsync korrigieren. In ProductDetailsResponseListener.onProductDetailsResponse gibt es eine Signaturänderung, die Codeänderungen in Ihrer Implementierung erfordert. Die Verhaltensänderung dahinter ist wichtiger als die Signatur: Vor 8.0.0 wurden Produkte, die nicht abgerufen werden konnten, einfach nicht zurückgegeben; mit PBL 8 kommen sie mit einem neuen produktbezogenen Statuscode zurück, der erklärt, warum — Produkt nicht gefunden oder keine für diesen Nutzer verfügbaren Angebote. Wenn Ihre UI bisher aus dem Schweigen abgeleitet hat, „dieser Nutzer ist nicht berechtigt", muss sie jetzt den Status lesen statt zu raten.

Ebenfalls in PBL 8 entfernt, falls Ihr Code noch einen davon aufruft: queryPurchaseHistoryAsync (nutzen Sie die Alternativen unter „Kaufhistorie abfragen“), querySkuDetailsAsync (nutzen Sie queryProductDetailsAsync), das parameterlose enablePendingPurchases() (nutzen Sie enablePendingPurchases(PendingPurchaseParams)) und die alte Überladung queryPurchasesAsync(String skuType, PurchasesResponseListener). Leser auf v6 oder älter, die direkt auf v8 stoßen, müssen zudem von enableAlternativeBilling / AlternativeBillingListener / AlternativeChoiceDetails weg, ersetzt durch enableUserChoiceBilling / UserChoiceBillingListener / UserChoiceDetails.

Optional, aber empfehlenswert: BillingClient.Builder.enableAutoServiceReconnection() ermöglicht es der Bibliothek, die Verbindung zum Play-Billing-Dienst selbstständig wiederherzustellen, statt dass Sie nach einer Trennung erneut startConnection() aufrufen müssen – die häufigste Ursache für Meldungen wie „Kauf-Button reagiert nicht" auf Android. Dasselbe Release ergänzt die Unterstützung ausstehender Käufe für Prepaid-Pläne und virtuelle Ratenzahlungs-Abos.

6. Schritt 4 — oder gleich bis 9.1.0 gehen

Der Migrationsleitfaden für Play Billing Library 9 richtet sich an Teams, die von Version 7 oder 8 kommen. Neben der Aktualisierung der Abhängigkeit auf 9.1.0 ist das wiederkehrende Thema, dass das alte SKU-Vokabular endgültig verschwindet (BillingClient.SkuType → ProductType, SkuDetails → ProductDetails, SkuDetailsParams → QueryProductDetailsParams, SkuDetailsResponseListener → ProductDetailsResponseListener, getSkuDetailsList/setSkuDetailsList → setProductDetailsParamsList), und eine Änderung wirkt sich direkt auf die Logik der Abo-Umsätze aus:

Wenn Sie queryPurchaseHistoryAsync verwendet haben, um zu entscheiden, ob ein Nutzer für eine kostenlose Testphase infrage kommt, empfiehlt der Leitfaden, ProductDetails.getSubscriptionOfferDetails() zu nutzen, um zu ermitteln, für welche Angebote ein Nutzer berechtigt ist.

Drei kleinere Änderungen in v9 sind leicht zu übersehen. Die Behandlung eines blockierten Play Store hat die Antwortcodes geändert: Wenn die Play-Store-App selbst blockiert ist (etwa durch OEM-Kindermodi), wechselte der Ergebniscode von ERROR zu BILLING_UNAVAILABLE mit der Debug-Meldung „Play Store is blocked", und dies erfordert androidx.core Version 1.9 oder höher, um korrekt zu funktionieren. DeveloperProvidedBillingDetails.getLinkUri() ist jetzt @Nullable, sodass jeder Code, der diese URI ohne Prüfung auf null und leere Zeichenfolge aufruft, ein akuter Absturz ist. Und 9.0.0 fügt In-App-Messaging für Opt-in-Preiserhöhungen hinzu, das Nutzern die ausstehende Erhöhung zeigt, ohne die App zu verlassen – begrenzt auf eine Nachricht alle sieben Tage.

7. Schritt 5 – das Verlängerungsformular, falls Sie es benötigen

Wenn Ihre App noch eine nicht unterstützte Version ausliefert, zeigt die Play Console eine Verwarnung an. Die Verlängerung wird auf der Detailseite der Verwarnung beantragt: Öffnen Sie Richtlinienstatus, öffnen Sie die Verwarnung und nutzen Sie das dort verlinkte Verlängerungsformular. Offiziell ist dies der einzige Weg – es gibt keine Anfrage per E-Mail und keine zweite Verlängerung über das veröffentlichte Datum 1. November für die betreffende Version hinaus.

Betrachten Sie es als Puffer für die Veröffentlichung innerhalb einer ohnehin festen Frist, nicht als zusätzlichen Spielraum. Wenn Sie die Verlängerung beantragen, muss die Arbeit dennoch vor dem 1. November 2026 erledigt sein, und nach diesem Datum werden neue Releases auf v7 nicht mehr akzeptiert — einschließlich des Compliance-Releases, auf den Sie vielleicht wegen einer völlig anderen Richtlinie warten.

8. Schritt 6 – prüfen Sie, bevor Sie veröffentlichen

Abrechnungsregressionen zeigen sich nicht als Abstürze; sie zeigen sich als zahlende Nutzer, die nicht kaufen können. Bevor das Release in Produktion geht:

  • Führen Sie einen echten Kauf, ein Abo-Upgrade oder -Downgrade und eine Wiederherstellung mit Lizenztestern auf einem Gerät durch, auf dem der Play Store tatsächlich installiert ist — Emulatoren ohne Play Store testen nicht die Verbindungslogik, die Sie gerade geändert haben.
  • Bestätigen Sie, dass der Aufruf der Produktdetails jetzt die nicht abgerufenen Produkte mit ihren Statuscodes zurückgibt und dass die UI die richtige Meldung für „nicht gefunden" gegenüber „kein Angebot für diesen Nutzer verfügbar" anzeigt.
  • Prüfen Sie, dass die Deprecation-Warnung in der Play Console nach dem Release verschwindet und dass das Attribut com.google.android.play.billingclient.version im zusammengeführten Manifest vorhanden ist.
  • Führen Sie die Veröffentlichung schrittweise durch, damit eine Abrechnungsregression nur einen Bruchteil der Nutzer erreicht statt alle, und halten Sie einen höheren Versionscode bereit, um sie zu ersetzen.

9. Was die neueren Versionen auf der Umsatzseite zurückbringen

Die Migration ist abrechenbare Arbeit, daher ist es fair zu benennen, was die neuere Bibliothek ermöglicht. PBL 8.0.0 benannte „In-App-Artikel“ in Einmalkäufe um und ergänzte mehrere Kaufoptionen und Angebote dafür, was die Zahl der separaten Produkte reduziert, die Sie anlegen müssen, um dasselbe zu unterschiedlichen Preisstufen zu verkaufen. Außerdem wurden Sub-Response-Codes zu launchBillingFlow() hinzugefügt: PAYMENT_DECLINED_DUE_TO_INSUFFICIENT_FUNDS, USER_INELIGIBLE (der Nutzer erfüllt die konfigurierten Berechtigungsanforderungen für ein Abo-Angebot nicht) und der Standard NO_APPLICABLE_SUB_RESPONSE_CODE – der Unterschied zwischen einem vagen „Etwas ist schiefgelaufen“ und einem Bildschirm, der dem Nutzer sagt, er solle seine Karte aufladen.

Die Releases 8.2.x und 8.3.0 (Dezember 2025) haben die APIs für externe Inhaltslinks, externe Angebote und externe Zahlungen ergänzt, und 9.1.0 hat die Billing-Choice-APIs hinzugefügt. Wenn Ihre Roadmap eines dieser Programme enthält, ist der Versionssprung die Voraussetzung und kein separates Projekt — das ist das praktische Argument dafür, gleich auf 9.1.0 zu gehen, während Sie ohnehin in diesem Code sind.


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