버전 5 또는 6에서 Google Play 결제 라이브러리 7로 이전

이 문서에서는 Google Play 결제 라이브러리 5 또는 6에서 이전하는 방법을 설명합니다. 'Google Play 결제 라이브러리 7'에 대해 알아보고 새로운 선택사항인 구독 기능을 제공합니다

버전 7.0.0의 전체 변경사항 목록은 출시 버전 참고:

개요

Google Play 결제 라이브러리 7은 기존 정기 결제 기능 이러한 선택적 개선사항은 할부 요금제로 결제하기 위한 지원을 추가할 수 있습니다 선불 정기 결제의 대기 중인 구매 지원

이전 버전과 호환되는 Play 결제 라이브러리 업그레이드

모든 새로운 Google Play 결제 라이브러리 7 API는 선택사항입니다. 개발자가 업데이트를 위해 API 변경사항을 구현할 필요가 없습니다.

이전하려면 API 참조를 업데이트하고 삭제해야 합니다. 특정 API를 사용하는 것이 좋습니다. 이전 가이드를 참조하세요.

PBL 5에서 PBL 7로 업그레이드

다음 섹션에서는 PBL 5에서 PBL 7로 업그레이드하는 방법을 설명합니다.

Google Play 결제 라이브러리 업데이트

Play 결제 라이브러리 종속 항목 버전 업데이트 앱의 build.gradle 파일

dependencies {
    def billingVersion = 7.0.0

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

그런 다음 아래 섹션의 설명에 따라 API 참조를 업데이트합니다.

사용자의 정기 결제 구매 변경

Play 결제 라이브러리 5 이하 버전에서는 ProrationMode를 사용했습니다. 사용자의 정기 결제 구매에 업그레이드와 같은 변경사항 적용 변경할 수 있습니다 이 API는 삭제되고 다음 API로 대체되었습니다. ReplacementMode

정기 결제 가격 변경 처리

이전에 지원 중단된 launchPriceConfirmationFlow API가 삭제되었습니다. 대안을 확인하려면 가격 변경 가이드를 참고하세요.

정기 결제 관련 API 변경사항 처리

이전에 지원 중단된 API setOldSkuPurchaseToken, setReplaceProrationMode, setReplaceSkusProrationMode님이 삭제되었습니다.

Play 결제 라이브러리 오류 처리

새 NETWORK_ERROR 코드는 네트워크 연결 문제를 나타냅니다. Google Play 시스템 간에 연결을 유지합니다.

SERVICE_TIMEOUT 및 SERVICE_UNAVAILABLE 코드도 업데이트되었습니다.

자세한 내용은 BillingResult 응답 코드를 처리합니다.

대기 중인 거래 처리

Play 결제 라이브러리에서 더 이상 대기 중인 구매에 대한 주문 ID를 생성하지 않습니다. 이러한 구매의 경우 주문이 이동된 후에 주문 ID가 채워집니다. PURCHASED 상태로 전환됩니다. 통합이 거래가 완전히 완료된 후에만 주문 ID 여전히 확인하시기 바랍니다.

대기 중인 구매 처리에 대한 자세한 내용은 다음을 참조하세요. Play 결제 라이브러리 통합 가이드 및 구매 수명 주기 관리 가이드를 참고하세요.

삭제된 개발자 제공 결제 API 처리

BillingClient.Builder.enableAlternativeBilling 삭제됨, AlternativeBillingListener, 및 AlternativeChoiceDetails. 개발자는 BillingClient.Builder.enableUserChoiceBilling()를 UserChoiceBillingListener와 함께 사용해야 합니다. 및 UserChoiceDetails 를 대신 리스너 콜백에서 호출할 수 있습니다.

이번 업데이트는 지원 중단된 API의 이름 변경이며 동작 변경사항은 없습니다.

선택적 변경사항

PBL 7에는 두 개의 새로운 API(선택사항)가 포함되어 있습니다.

선불 요금제의 대기 중인 구매 지원

정기 결제 및 대기 중인 거래 처리 가이드를 참조하세요.

가상 할부 구독

할부 구독 통합 가이드를 참고하세요.

PBL 6에서 PBL 7로 업그레이드

다음 섹션에서는 PBL 6에서 PBL 7로 업그레이드하는 방법을 설명합니다.

Google Play 결제 라이브러리 업데이트

Play 결제 라이브러리 종속 항목 버전 업데이트 앱의 build.gradle 파일

dependencies {
    def billingVersion = 7.0.0

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

그런 다음 아래 섹션의 설명에 따라 API 참조를 업데이트합니다.

정기 결제 관련 API 변경사항 처리

이전에 지원 중단된 API setOldSkuPurchaseToken, setReplaceProrationMode, setReplaceSkusProrationMode님이 삭제되었습니다.

삭제된 개발자 제공 결제 API 처리

BillingClient.Builder.enableAlternativeBilling 삭제됨, AlternativeBillingListener 및 AlternativeChoiceDetails. 개발자는 BillingClient.Builder.enableUserChoiceBilling()를 UserChoiceBillingListener와 함께 사용해야 합니다. 및 UserChoiceDetails 를 대신 리스너 콜백에서 호출할 수 있습니다.

선택적 변경사항

PBL 7에는 두 개의 새로운 API(선택사항)가 포함되어 있습니다.

선불 요금제의 대기 중인 구매 지원

정기 결제 및 대기 중인 거래 처리 가이드를 참조하세요.

가상 할부 구독

할부 구독 통합 가이드에서 다음을 참고하세요. 이 변경사항을 앱에 통합하는 방법에 관한 정보를 참고하세요.