Przechodzenie z wersji 5 lub 6 do Biblioteki płatności w Google Play 7

Ten dokument opisuje, jak przejść z Biblioteki płatności w Google Play w wersji 5 lub 6 do Biblioteki płatności w Google Play 7 oraz jak przeprowadzić integrację z nowymi, opcjonalnymi funkcji związanych z subskrypcjami.

Pełną listę zmian wprowadzonych w wersji 7.0.0 znajdziesz w wersji notatki.

Omówienie

Biblioteka płatności 7 w Google Play usprawnia obsługę płatności dotychczasowych funkcji subskrypcji. Te opcjonalne ulepszenia dodać obsługę płatności na raty, obsługi oczekujących zakupów w ramach subskrypcji przedpłaconych.

Uaktualnienie Biblioteki płatności w Play o niezgodności wstecznej

Wszystkie nowe interfejsy API Biblioteki płatności 7 w Google Play są opcjonalne. nie muszą wprowadzać żadnych zmian w interfejsie API.

Aby przeprowadzić migrację, musisz zaktualizować odwołania do interfejsu API i usunąć określonych interfejsów API aplikacji zgodnie z informacjami o wersji oraz w dalszej części tego przewodnik po migracji.

Zmień wersję PBL z 5 na PBL 7

Poniższe sekcje opisują, jak przejść z PBL 5 na PBL 7.

Zaktualizuj Bibliotekę płatności w Google Play

Zaktualizuj wersję zależności Biblioteki płatności w Play build.gradle aplikacji.

dependencies {
    def billingVersion = 7.0.0

    implementation "com.android.billingclient:billing:$billingVersion"
}

Następnie zaktualizuj odwołania do interfejsu API w sposób opisany w sekcjach poniżej.

Zmienianie subskrypcji kupionych przez użytkownika

Używana Biblioteka płatności w Play w wersji 5 lub starszej ProrationMode aby wprowadzać zmiany w kupowanych przez użytkownika subskrypcjach, np. na wyższą wersję subskrypcji lub przejść na niższą wersję. Ten interfejs API został usunięty i zastąpiony przez ReplacementMode

Obsługa zmian cen subskrypcji

Wycofany wcześniej interfejs API launchPriceConfirmationFlow został usunięty. Alternatywy znajdziesz w artykule o zmianach cen .

Obsługuj zmiany w interfejsie API związane z subskrypcją

Wycofane wcześniej interfejsy API: setOldSkuPurchaseToken, setReplaceProrationMode, setReplaceSkusProrationMode zostali usunięci.

Postępowanie w przypadku błędów w Bibliotece płatności w Play

Nowy kod NETWORK_ERROR wskazuje problemy z połączeniem sieciowym między urządzeniem użytkownika a systemem Google Play.

Kody SERVICE_TIMEOUT i SERVICE_UNAVAILABLE również zostały zaktualizowane.

Więcej informacji: Obsługa kodów odpowiedzi BillingResult

Obsługa oczekujących transakcji

Biblioteka płatności w Play nie tworzy już identyfikatora zamówienia dla oczekujących zakupów. W przypadku tych zakupów identyfikator zamówienia jest wypełniany po przeniesieniu zakupu. do stanu PURCHASED. Upewnij się, że integracja oczekuje identyfikatora zamówienia dopiero po zakończeniu transakcji. Nadal możesz używać usługi token zakupu.

Więcej informacji o obsłudze oczekujących zakupów znajdziesz w Przewodnik po integracji Biblioteki płatności w Play oraz przewodnika po zarządzaniu cyklem życia zakupu.

Obsługa usuniętych interfejsów API rozliczeń alternatywnych

Usunięto: BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener, i AlternativeChoiceDetails. Deweloperzy powinni używać BillingClient.Builder.enableUserChoiceBilling() z UserChoiceBillingListener i UserChoiceDetails w wywołaniu zwrotnym detektora.

Ta aktualizacja polega na zmianie nazwy wycofanych interfejsów API bez zmian w ich działaniu.

Zmiany opcjonalne

PBL 7 zawiera 2 nowe opcjonalne interfejsy API.

Obsługa oczekujących zakupów w przypadku abonamentów przedpłaconych

Zapoznaj się z przewodnikiem Obsługa subskrypcji i transakcji oczekujących.

Wirtualne subskrypcje ratalne

Zapoznaj się z przewodnikiem Integracja subskrypcji ratalnych.

Przejdź z PBL 6 na PBL 7

Poniższe sekcje opisują, jak przejść z PBL 6 na PBL 7.

Zaktualizuj Bibliotekę płatności w Google Play

Zaktualizuj wersję zależności Biblioteki płatności w Play build.gradle aplikacji.

dependencies {
    def billingVersion = 7.0.0

    implementation "com.android.billingclient:billing:$billingVersion"
}

Następnie zaktualizuj odwołania do interfejsu API w sposób opisany w sekcjach poniżej.

Obsługuj zmiany w interfejsie API związane z subskrypcją

Wycofane wcześniej interfejsy API: setOldSkuPurchaseToken, setReplaceProrationMode, setReplaceSkusProrationMode zostali usunięci.

Obsługa usuniętych interfejsów API rozliczeń alternatywnych

Usunięto: BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener i AlternativeChoiceDetails. Deweloperzy powinni używać BillingClient.Builder.enableUserChoiceBilling() z UserChoiceBillingListener i UserChoiceDetails w wywołaniu zwrotnym detektora.

Zmiany opcjonalne

PBL 7 zawiera 2 nowe opcjonalne interfejsy API.

Obsługa oczekujących zakupów w przypadku abonamentów przedpłaconych

Zapoznaj się z przewodnikiem Obsługa subskrypcji i transakcji oczekujących.

Wirtualne subskrypcje ratalne

Zapoznaj się z przewodnikiem Integracja subskrypcji ratalnych dotycząca znajdziesz w nich informacje o tym, jak zintegrować te zmiany z aplikacją.