Cara Mengatasi Error Upload AAB di Google Play Console

Momen paling menyebalkan buat developer Android pemula biasanya bukan saat menulis kode, melainkan saat menekan tombol unggah App Bundle di Google Play Console lalu disambut pesan error berwarna merah. Berkas .aab yang tadinya terasa sudah beres tiba-tiba ditolak dengan alasan yang kadang terdengar teknis dan membingungkan. Kabar baiknya, sebagian besar error upload AAB itu sudah sangat umum, punya penyebab yang jelas, dan bisa diselesaikan dalam hitungan menit begitu Anda tahu akar masalahnya. Artikel ini merangkum error yang paling sering muncul beserta langkah perbaikannya satu per satu.

Kenapa harus AAB, bukan APK?

Sejak beberapa tahun terakhir Google mewajibkan format Android App Bundle (.aab) untuk aplikasi baru yang diunggah ke Play Store, menggantikan APK. AAB memungkinkan Google membuatkan APK yang teroptimasi per perangkat sehingga ukuran unduhan pengguna lebih kecil. Karena itu, kalau Anda masih mencoba mengunggah APK untuk aplikasi baru, Play Console akan menolaknya dan meminta App Bundle. Pastikan proses build Anda menghasilkan berkas berekstensi .aab, bukan .apk, sebelum masuk ke daftar error di bawah.

Error version code already used

Ini juara bertahan error paling sering. Pesannya kira-kira berbunyi bahwa version code tertentu sudah pernah digunakan dan Anda harus memakai angka yang lebih tinggi. Penyebabnya sederhana: setiap kali Anda mengunggah berkas ke track mana pun (internal, closed, open, maupun production), versionCode harus lebih besar dari unggahan sebelumnya. Play Console tidak akan pernah menerima versionCode yang sama atau lebih rendah, meski isi aplikasinya berbeda.

Solusinya, buka konfigurasi build aplikasi Anda dan naikkan nilai versionCode menjadi angka bulat yang lebih tinggi, misalnya dari 1 menjadi 2. Perlu diingat versionCode berbeda dari versionName. versionName adalah label yang dilihat pengguna seperti 1.0.3, sedangkan versionCode adalah bilangan bulat internal yang wajib naik tiap unggahan. Setelah menaikkannya, build ulang AAB lalu unggah kembali.

Error you need to use a different package name

Package name atau application ID adalah identitas unik aplikasi Anda di seluruh Play Store, misalnya com.namaperusahaan.namaaplikasi. Setelah sebuah aplikasi dibuat dengan package name tertentu, nama itu terkunci selamanya dan tidak bisa diubah. Error ini muncul karena package name yang Anda pakai sudah dipakai aplikasi lain, atau tidak cocok dengan yang terdaftar di entri aplikasi Play Console.

1. Pastikan applicationId di konfigurasi build sama persis dengan package name yang terdaftar di halaman aplikasi Play Console.
2. Kalau package name sudah dipakai global oleh aplikasi lain, Anda harus memilih package name baru yang unik lalu membuat entri aplikasi baru.
3. Hindari nama generik seperti com.example.myapp karena rawan bentrok dan tidak profesional.

Error upload key atau certificate mismatch

Pesan ini muncul kalau AAB ditandatangani dengan kunci (keystore) yang berbeda dari kunci upload yang terdaftar untuk aplikasi tersebut. Play App Signing memisahkan antara upload key yang Anda pegang dengan app signing key yang disimpan Google. Kalau Anda mengganti komputer, kehilangan keystore, atau tidak sengaja membuat keystore baru, sidik jari sertifikatnya tidak akan cocok dan unggahan ditolak.

Untuk memperbaikinya, gunakan kembali keystore yang sama seperti unggahan pertama. Kalau keystore hilang total, buka menu App integrity atau App signing di Play Console dan minta reset upload key. Google akan meminta Anda mengunggah sertifikat baru untuk didaftarkan sebagai upload key pengganti. Setelah disetujui, tanda tangani AAB dengan keystore baru itu dan coba unggah lagi. Selalu simpan keystore beserta passwordnya di tempat aman dan cadangkan.

AAB tidak ditandatangani atau target API kurang

Ada beberapa error lain yang penyebabnya berbeda tapi sama-sama menghalangi unggahan. Berikut ringkasan cepatnya beserta cara mengatasinya.

• AAB tidak ditandatangani: build Anda menghasilkan berkas debug atau unsigned. Pastikan Anda membuat build rilis yang ditandatangani, bukan varian debug, sebelum mengunggah.
• Target API level kurang: Google mewajibkan aplikasi baru menargetkan level API Android yang relatif baru. Naikkan targetSdkVersion ke level yang diminta lalu build ulang dan uji agar tidak ada fungsi yang rusak.
• android:debuggable bernilai true: aplikasi yang masih dalam mode debuggable ditolak untuk rilis. Pastikan flag debuggable tidak aktif pada build rilis, biasanya cukup memakai varian release yang benar.
• Ukuran AAB terlalu besar: kurangi aset yang tidak perlu, aktifkan pengecilan kode dan resource, kompres gambar, dan pertimbangkan memindahkan aset besar ke unduhan tambahan.

Ringkasan dan langkah pencegahan

Sebagian besar error upload AAB berakar pada tiga hal: penomoran versi yang tidak naik, identitas aplikasi yang tidak cocok (package name atau keystore), dan konfigurasi build yang belum siap rilis. Biasakan menaikkan versionCode tiap build, menyimpan keystore dengan aman, serta selalu memakai varian rilis yang ditandatangani dan menargetkan API level terbaru. Dengan kebiasaan itu, proses unggah akan jauh lebih mulus.

Setelah AAB berhasil terunggah, tantangan berikutnya biasanya justru bukan teknis, melainkan memenuhi syarat closed testing: 12 tester aktif selama 14 hari berturut-turut. Kalau Anda kesulitan mengumpulkan penguji nyata untuk tahap itu, layanan kami menyediakan 12 tester lebih di perangkat sungguhan yang opt-in resmi lewat link Anda dan diuji harian, dengan garansi sampai memenuhi syarat. Silakan hubungi kami bila butuh bantuan melewati tahap tersebut.