Atasi masalahTerbit: 2026-10-193 menit baca

Error adb install: Arti Kode INSTALL_FAILED dan Solusinya

Arti setiap error adb install dan solusinya, dari INSTALL_FAILED_VERSION_DOWNGRADE dan UPDATE_INCOMPATIBLE sampai NO_MATCHING_ABIS, USER_RESTRICTED, dan split APK.

adb install app.apk akan menampilkan Success atau Failure [KODE: pesan]. Kode itu memberi tahu dengan tepat apa yang salah. Berikut kode-kode yang paling sering muncul, artinya, dan cara mengatasi masing-masing.

Tabel ringkas

Kode	Arti	Solusi
`INSTALL_FAILED_ALREADY_EXISTS`	Aplikasi sudah terinstal	`adb install -r app.apk`
`INSTALL_FAILED_VERSION_DOWNGRADE`	Version code lebih rendah dari aplikasi yang terinstal	`adb install -r -d app.apk`, atau uninstall dulu
`INSTALL_FAILED_UPDATE_INCOMPATIBLE`	Paket sama, kunci tanda tangan berbeda	Uninstall aplikasi yang terinstal dulu
`INSTALL_PARSE_FAILED_NO_CERTIFICATES`	APK belum ditandatangani	Tandatangani, atau build APK debug/release yang sudah ditandatangani
`INSTALL_FAILED_NO_MATCHING_ABIS`	Kode native untuk jenis CPU yang salah	Pakai APK yang dibuat untuk ABI HP tersebut
`INSTALL_FAILED_OLDER_SDK`	Versi Android di HP terlalu lama	Pakai build dengan `minSdkVersion` lebih rendah
`INSTALL_FAILED_TEST_ONLY`	APK ditandai `testOnly`	`adb install -t app.apk`
`INSTALL_FAILED_INSUFFICIENT_STORAGE`	Ruang kosong tidak cukup	Kosongkan penyimpanan
`INSTALL_FAILED_USER_RESTRICTED`	HP memblokir instalasi	Izinkan instal lewat USB, konfirmasi di HP
`INSTALL_FAILED_MISSING_SPLIT`	Sebagian dari split APK tidak ada	Instal semua bagian sekaligus

Penjelasan error yang sering muncul

UPDATE_INCOMPATIBLE: tanda tangan tidak cocok

Aplikasi dengan nama paket yang sama sudah terinstal tetapi ditandatangani dengan kunci lain, misalnya versi Play Store dari aplikasi yang sedang Anda uji. Android tidak mau menggantinya, untuk melindungi datanya:

adb uninstall com.example.app
adb install app.apk

Uninstall akan menghapus data aplikasi itu di HP.

VERSION_DOWNGRADE

Anda menginstal build lama di atas build yang lebih baru. Izinkan dengan -d:

adb install -r -d app.apk

Di versi Android terbaru, cara ini hanya berlaku untuk build yang debuggable. Jika tidak, uninstall dulu.

NO_MATCHING_ABIS

APK berisi library native untuk prosesor yang tidak dipakai HP, misalnya build khusus x86_64 di HP ARM, atau build khusus arm64-v8a di HP atau TV yang menjalankan Android 32-bit. Cek apa yang didukung HP:

adb shell getprop ro.product.cpu.abilist

Lalu build atau unduh varian yang cocok, atau APK universal.

USER_RESTRICTED

HP menolak instalasi. Di Xiaomi, Redmi, dan POCO, aktifkan Instal melalui USB di Opsi pengembang dan ketuk Instal pada konfirmasi yang muncul di HP. Detailnya di USB debugging dan setelan keamanan Xiaomi. Profil kerja dan kontrol orang tua juga bisa memblokir instalasi.

Split APK dan app bundle

Aplikasi dari Android App Bundle datang sebagai beberapa file APK (base dan split). Instal semuanya sekaligus:

adb install-multiple base.apk split_config.arm64_v8a.apk split_config.en.apk

File .aab tidak bisa diinstal langsung. Buat APK dari file itu dengan bundletool terlebih dahulu.

Play Protect memblokir instalasi

Kadang instalasi berhenti karena Google Play Protect memberi peringatan tentang aplikasi yang tidak dikenal. Cek layar HP dan pilih tetap menginstal hanya jika Anda memercayai APK tersebut.

Instal APK dari browser

Panel Install APK di ADBKit menjalankan instalasi yang sama di HP dan menampilkan hasil yang persis, termasuk kode kegagalan dalam bahasa yang mudah dipahami. Centang Replace existing app untuk memperbarui aplikasi yang sudah terinstal, sama dengan -r. Fitur ini berjalan lewat USB atau lewat Wi-Fi dengan agent ADBKit, dan APK dikirim langsung dari komputer Anda ke HP.

Selengkapnya tentang instalasi di cara instal APK dengan ADB.