Dokumen ini menjelaskan cara bermigrasi dari Google Play Billing Library 5 atau 6 ke Google Play Billing Library 7 dan cara mengintegrasikan dengan kemampuan langganan opsional baru.
Untuk daftar lengkap perubahan pada versi 7.0.0, lihat catatan rilis.
Ringkasan
Google Play Billing Library 7 meningkatkan penanganan pembayaran untuk fitur langganan yang ada. Peningkatan opsional ini menambahkan dukungan untuk pembayaran dengan paket cicilan serta dukungan untuk pembelian tertunda untuk langganan prabayar.
Upgrade Play Billing Library yang kompatibel dengan versi lama
Semua API Google Play Billing Library 7 baru bersifat opsional, dan developer tidak perlu menerapkan perubahan API apa pun untuk melakukan update.
Untuk bermigrasi, Anda perlu mengupdate referensi API dan menghapus API tertentu dari aplikasi seperti yang dijelaskan dalam catatan rilis dan nanti dalam panduan migrasi ini.
Mengupgrade dari PBL 5 ke PBL 7
Bagian berikut menjelaskan cara mengupgrade dari PBL 5 ke PBL 7.
Mengupdate Library Layanan Penagihan Google Play
Update versi dependensi Play Billing Library di
file build.gradle aplikasi Anda.
dependencies {
def billingVersion = 7.0.0
implementation "com.android.billingclient:billing:$billingVersion"
}
Selanjutnya, perbarui referensi API Anda seperti yang dijelaskan di bagian berikut.
Mengubah pembelian langganan pengguna
Play Billing Library 5 dan yang lebih lama menggunakan ProrationMode untuk menerapkan perubahan pada pembelian langganan pengguna, seperti upgrade atau downgrade. API ini telah dihapus dan diganti dengan
ReplacementMode.
Menangani perubahan harga langganan
launchPriceConfirmationFlow API yang sebelumnya tidak digunakan lagi telah dihapus.
Untuk alternatifnya, lihat panduan perubahan harga.
Menangani perubahan API terkait langganan
API setOldSkuPurchaseToken, setReplaceProrationMode, setReplaceSkusProrationMode yang sebelumnya tidak digunakan lagi telah dihapus.
- Perbarui
setOldSkuPurchaseTokenkesetOldPurchaseToken. - Perbarui
setReplaceProrationModekesetSubscriptionReplacementMode. - Perbarui
setReplaceSkusProrationModekesetSubscriptionReplacementMode.
Menangani error Play Billing Library
Kode NETWORK_ERROR baru menunjukkan masalah dengan koneksi jaringan
antara perangkat pengguna dan sistem Google Play.
Kode SERVICE_TIMEOUT dan SERVICE_UNAVAILABLE juga diperbarui.
Untuk mengetahui informasi selengkapnya, lihat Menangani kode respons BillingResult.
Menangani transaksi yang tertunda
Play Billing Library tidak lagi membuat ID Pesanan untuk pembelian tertunda.
Untuk pembelian ini, ID pesanan diisi setelah pembelian dipindahkan
ke status PURCHASED. Pastikan integrasi Anda mengharapkan
ID pesanan hanya setelah transaksi selesai sepenuhnya. Anda tetap dapat menggunakan token pembelian untuk data Anda.
Untuk mengetahui informasi selengkapnya tentang cara menangani pembelian yang tertunda, lihat panduan integrasi dan panduan pengelolaan siklus proses pembelian Play Billing Library.
Menangani API penagihan alternatif yang dihapus
Menghapus
BillingClient.Builder.enableAlternativeBilling,
AlternativeBillingListener, dan
AlternativeChoiceDetails. Gunakan
BillingClient.Builder.enableUserChoiceBilling()
dengan UserChoiceBillingListener dan
UserChoiceDetails dalam callback pemroses.
Update ini adalah penggantian nama API yang tidak digunakan lagi tanpa perubahan perilaku.
Perubahan opsional
PBL 7 menyertakan dua API opsional baru.
Mendukung pembelian tertunda untuk paket prabayar
Lihat panduan Menangani Langganan dan Transaksi Tertunda.
Langganan cicilan virtual
Lihat panduan Integrasi Langganan Cicilan.
Mengupgrade dari PBL 6 ke PBL 7
Bagian berikut menjelaskan cara mengupgrade dari PBL 6 ke PBL 7.
Mengupdate Library Layanan Penagihan Google Play
Update versi dependensi Play Billing Library di
file build.gradle aplikasi Anda.
dependencies {
def billingVersion = 7.0.0
implementation "com.android.billingclient:billing:$billingVersion"
}
Selanjutnya, perbarui referensi API Anda seperti yang dijelaskan di bagian berikut.
Menangani perubahan API terkait langganan
API setOldSkuPurchaseToken, setReplaceProrationMode, setReplaceSkusProrationMode yang sebelumnya tidak digunakan lagi telah dihapus.
- Perbarui
setOldSkuPurchaseTokenkesetOldPurchaseToken. - Perbarui
setReplaceProrationModekesetSubscriptionReplacementMode. - Perbarui
setReplaceSkusProrationModekesetSubscriptionReplacementMode.
Menangani API penagihan alternatif yang dihapus
Menghapus
BillingClient.Builder.enableAlternativeBilling,
AlternativeBillingListener, dan
AlternativeChoiceDetails. Gunakan
BillingClient.Builder.enableUserChoiceBilling()
dengan UserChoiceBillingListener dan
UserChoiceDetails dalam callback pemroses.
Perubahan opsional
PBL 7 menyertakan dua API opsional baru.
Mendukung pembelian tertunda untuk paket prabayar
Lihat panduan Menangani Langganan dan Transaksi Tertunda.
Langganan cicilan virtual
Lihat panduan Integrasi Langganan Cicilan untuk mengetahui informasi tentang cara mengintegrasikan perubahan ini ke dalam aplikasi Anda.