Konfigurasi Android Sandbox Testing
Salin prompt setup yang berisi langkah install dan panduan markdown lengkap untuk plugin ini.
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
Bagian berjudul “Gunakan build yang tepat untuk tugasnya”Sebelum memulai, pisahkan ketiga tipe build Android ini:
- Build debug/dev lokal: Cocok untuk mengecek UI dan integrasi native di perangkat Anda.
- AAB release yang sudah di-sign dan di-upload ke Play Console: Wajib untuk pengujian Google Play billing yang realistis.
- Build testing yang diinstal dari Play: 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 bisa jadi tidak berperilaku sama seperti di produksi. Untuk validasi langganan dan in-app purchase, selalu test dengan build yang diinstal dari Google Play.
Prerequisites
Bagian berjudul “Prasyarat”- Akun developer Google Play Console. Jika belum dibuat, mulai dari Pendaftaran Play Console.
- Rekam aplikasi yang dibuat di Play Console dengan nama paket Android final Anda
- Produk in-app atau langganan Anda yang dibuat di Play Console
- Akun Gmail pengujian yang dapat Anda tambahkan ke pengujian lisensi
- Build rilis yang sudah ditandatangani dan siap di-upload
Sebelum menghabiskan waktu untuk setup billing, buat aplikasi di Play Console dan tentukan apakah akan menjadi gratis atau berbayar. Google memungkinkan Anda mengubah aplikasi berbayar menjadi gratis nanti, tetapi setelah aplikasi ditawarkan secara gratis, tidak dapat diubah menjadi berbayar.
Gunakan Android App Bundle (.aab) untuk aplikasi Play Store baru:
bunx cap sync androidcd android./gradlew bundleReleasePastikan 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
Bagian berjudul “Proses Setup”-
Tambah Akun Testing
Di Play Console, buka Pengaturan > Pengujian lisensi dan tambahkan akun Google utama yang digunakan di perangkat uji Android Anda.
Hal ini memastikan pembelian menampilkan alur sandbox Play, bukan mencoba melakukan pengisian sungguhan.

-
Pilih Jalur Pengujian
Buka Uji dan rilis > Pengujian dan pilih salah satu jalur berikut:
- Pengujian internal: Jalur tercepat untuk QA dan uji smoke billing. Bundle baru biasanya tersedia dalam hitungan menit.
- Pengujian tertutup: Lebih baik untuk pengujian 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 informasi listing sementara kepada pengujian internal selama maksimal 48 jam.

-
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.

-
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.

-
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.

-
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
Bagian berjudul “Catatan Penting”- Untuk QA billing, hapus semua salinan aplikasi hasil sideload sebelum menginstal build pengujian dari Play Store.
- Internal testing cocok untuk smoke test cepat, tapi closed testing adalah jalur yang penting untuk akses produksi akun pribadi baru.
- Akun test tidak akan dikenakan biaya untuk pembelian
- Pembelian test menggunakan alur yang sama dengan pembelian produksi
- Anda bisa menguji semua fitur langganan termasuk trial dan penawaran intro
- Langganan test memiliki periode perpanjangan yang dipercepat untuk pengujian lebih cepat
- Gunakan akun Google yang sama di ketiga tempat: Play Store di perangkat, alur opt-in tester, dan License testing
Pemecahan Masalah
Bagian berjudul “Troubleshooting”Produk tidak muncul di mode test:
- Pastikan aplikasi Anda di-upload ke track testing
- Verifikasi bahwa akun test sudah ditambahkan ke License testing
- Pastikan produk 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
Bagian berjudul “Sumber daya tambahan”- Uji pembelian dengan Google Play Billing
- Siapkan pengujian terbuka, tertutup, atau internal
- Persyaratan pengujian untuk akun developer pribadi baru
Lanjutkan dari Konfigurasi Android Sandbox Testing
Bagian berjudul “Lanjutkan dari Konfigurasi Pengujian Sandbox Android”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.