Konfigurasi Android Sandbox Testing

Menguji in-app purchase butuh konfigurasi yang tepat di Google Play Console. Panduan ini akan memandu Anda menyiapkan sandbox testing untuk aplikasi Android Anda.

Gunakan build yang tepat untuk kebutuhan

Sebelum memulai, pisahkan ketiga tipe build Android ini:

• Build debug/dev lokal: Cocok untuk mengecek UI dan integrasi native di perangkat Anda.
• AAB release bertanda (signed) yang di-upload ke Play Console: Wajib untuk pengujian Google Play billing yang realistis.
• Build pengujian via Play Store: Build yang diinstal tester dari track internal atau closed. Gunakan ini untuk QA pembelian.

Jika Anda hanya melakukan sideload APK dari Android Studio atau adb, Google Play Billing mungkin tidak berperilaku sama seperti di produksi. Untuk validasi langganan dan in-app purchase, selalu test dengan build yang diinstal dari Google Play.

Prerequisites

• Akun developer Google Play Console. Jika belum punya, mulai di Pendaftaran Play Console.
• Record aplikasi di Play Console dengan nama package Android final Anda
• Produk in-app atau langganan yang sudah dibuat di Play Console
• Akun Gmail tester untuk ditambahkan ke license testing
• Signed release build yang siap untuk di-upload

Sebelum meluangkan waktu untuk pengaturan penagihan, buatlah aplikasi di Play Console dan tentukan apakah aplikasi tersebut akan menjadi gratis atau berbayar. Google mengizinkan aplikasi berbayar diubah ke gratis nanti, tapi jika sudah pernah gratis, tidak bisa diubah ke berbayar.

Gunakan Android App Bundle (.aab) untuk aplikasi Play Store baru:

bunx cap sync android
cd android
./gradlew bundleRelease

Pastikan signing rilis Android Anda sudah dikonfigurasi sebelum menjalankan perintah ini bundleRelease. Jika keystore, signing config, atau password rilis Anda belum diatur, buat signed bundle dari Android Studio dengan Build > Generate Signed App Bundle / APK, yang akan meminta nilai-nilai tersebut.

Proses Setup

1. Tambah Akun Testing

   Di Play Console, buka Pengaturan > Pengujian lisensi dan tambahkan akun Google utama yang digunakan pada perangkat Android testing Anda.

   Ini memastikan pembelian menampilkan alur Play sandbox, bukan mencoba melakukan transaksi asli.

   

2. Pilih Testing Track

   Buka Uji coba dan rilis > Pengujian dan pilih salah satu track berikut:

   • Pengujian internal: Jalur tercepat untuk QA dan smoke test billing. Bundle baru biasanya tersedia dalam hitungan menit.
   • Pengujian tertutup: Lebih baik untuk testing yang lebih luas, dan wajib sebelum produksi untuk akun developer pribadi yang dibuat setelah 13 November 2023.

   Untuk rilis pertama, Play mungkin menampilkan nama aplikasi dan info listing sementara ke internal tester selama hingga 48 jam.

   

3. Buat daftar tester

   Setelah membuka track Anda, buat daftar tester dan tambahkan akun Google yang akan menerima build tersebut.

   Jika Anda sedang mengupayakan akses produksi pada akun personal yang baru dibuat, pastikan Anda menggunakan pengujian tertutup dan pastikan minimal 12 tester tetap terdaftar selama 14 hari berturut-turut.

   

4. Upload build release yang sudah di-sign

   Buat rilis baru di track pengujian yang dipilih dan upload build yang sudah di-sign .aab.

   Aplikasi Google Play baru sebaiknya menggunakan Android App Bundle daripada APK. Setelah upload, simpan rilis, perbaiki kendala kebijakan atau store listing yang ditandai Play, lalu publikasikan rilis ke track pengujian.

   

5. Gabung ke program pengujian

   Buka URL opt-in dari perangkat uji Anda dan klik tombol “Jadi penguji” untuk mendaftar.

   Instal aplikasi dari listing Play Store yang dibuat melalui alur opt-in tersebut, bukan dari APK hasil ekspor lokal.

   

6. Build dan Test

   Jalankan build yang diinstal dari Play Store di perangkat uji dan coba lakukan pembelian. Anda akan melihat pesan seperti:

   “Ini adalah pesanan uji; Anda tidak akan dikenai biaya.”

   

Catatan Penting

• Untuk QA billing, hapus semua salinan aplikasi hasil sideload sebelum menginstal build pengujian dari Play Store.
• Internal testing bagus untuk smoke test cepat, tapi closed testing adalah jalur utama untuk mendapatkan akses produksi akun personal baru.
• Akun tester tidak akan dikenakan biaya untuk pembelian
• Pembelian test menggunakan flow yang sama dengan pembelian produksi
• Anda bisa mengetes semua fitur langganan termasuk trial dan penawaran perkenalan
• Langganan test memiliki periode perpanjangan yang dipercepat untuk testing lebih cepat
• Gunakan Google account yang sama untuk ketiga hal ini: Play Store di perangkat, flow opt-in tester, dan License testing

Pemecahan Masalah

Produk tidak muncul di mode test:

• Pastikan app Anda sudah di-upload ke testing track
• Verifikasi akun tester sudah ditambahkan ke License testing
• Cek apakah produk sudah aktif di Google Play Console
• Pastikan build diinstal dari Google Play, bukan di-sideload secara lokal

Error “Item not available”:

• Tunggu 2-3 jam setelah membuat produk agar produk tersedia
• Pastikan package name aplikasi sesuai dengan yang ada di Play Console
• Pastikan Anda sudah login dengan akun testing
• Pastikan Anda mengunggah signed release build yang mengarah ke package name dan katalog produk yang sama

Pembelian testing muncul sebagai tagihan asli:

• Cek kembali apakah akun sudah ditambahkan ke License testing
• Pastikan Anda menggunakan build dari testing track
• Pastikan banner testing muncul saat pembelian

Sumber daya tambahan

• Tes pembelian dengan Google Play Billing
• Siapkan pengujian terbuka, tertutup, atau internal
• Syarat pengujian untuk akun developer personal baru

Lanjutkan dari Konfigurasi Android Sandbox Testing

Jika Anda menggunakan Konfigurasi Android Sandbox Testing untuk merencanakan persetujuan store dan distribusi, hubungkan dengan Menggunakan @capgo/native-purchases untuk kemampuan native saat menggunakan @capgo/native-purchases, @capgo/capacitor-in-app-review untuk detail implementasi di @capgo/capacitor-in-app-review, Menggunakan @capgo/capacitor-in-app-review untuk kapabilitas native di bagian Menggunakan @capgo/capacitor-in-app-review, @capgo/capacitor-native-market untuk detail implementasi di @capgo/capacitor-native-market, dan Menggunakan @capgo/capacitor-native-market untuk kemampuan native di Menggunakan @capgo/capacitor-native-market.