Lebihkan ke konten utama

Andorid

Master `adb install apk` for sideloading apps. This 2026 guide covers flags, common errors, and workflows for Capacitor/Ionic. Get started now!

Martin Donadieu

Pengembang Konten

Panduan Instal Aplikasi ADB 2026: Sideload Aplikasi Apapun ADB becomes the shortest path between a built APK and an actual phone. If you work with Capacitor or Ionic, this command stops being a convenience and starts becoming part of your normal feedback loop. It’s how you verify native plugins, permissions, splash behavior, deep links, WebView quirks, and everything else the browser can’t tell you.

Daftar Isi

Mengapa Adb Instalasi adalah Jalur Tercepat untuk Pengujian

Jika Anda membangun aplikasi Android selama waktu yang lama, Anda akan berhenti menganggap Toko Play sebagai jalur pengujian utama. Ini terlalu lambat untuk iterasi rutin, terutama ketika Anda memeriksa prompt izin, masalah jembatan plugin, atau bug tata letak yang hanya muncul pada satu perangkat.

ADB telah menjadi bagian dari Android sejak Android 1.0 pada tahun 2008dan itu masih cara standar untuk menginstal APK secara langsung ke perangkat Android. lebih dari 70% pada tahun 2024yang merupakan salah satu alasan mengapa alur kerja ini tetap menjadi pusat bagi tim mobile yang bekerja di berbagai perangkat, seperti yang disebutkan dalam dokumentasi resmi Android Debug Bridge Untuk pengembangan praktis, nilai sederhananya adalah:.

Kamu menghindari hambatan toko:

  • tidak ada antrian review, tidak ada penundaan jalur uji coba. Kamu menguji versi yang tepat yang kamu buat:
  • debug, kandidat rilis, atau versi cabang tunggal. Kamu mendapatkan feedback langsung:
  • instal, jalankan, inspeksi log, ulangi. Aturan praktis:

Android's global market share exceeded Jika pertanyaan adalah “apakah APK ini berfungsi pada perangkat Android fisik,” adb install biasanya harus jawaban pertamamu.

Hal ini lebih penting lagi dalam Capacitor dan Ionic bekerja. Jalankan browser akan menunjukkan apakah layer web Anda berfungsi. Namun, tidak akan menunjukkan apakah pengaturan izin Android berfungsi, apakah plugin inisialisasi dengan bersih, atau apakah aplikasi Anda diperbarui tanpa mengganggu data yang disimpan.

Perintah itu sendiri kecil:

adb install path/to/app.apk

Yang membuatnya berguna bukanlah sintaks. Melainkan kontrol. Anda dapat menginstal secara langsung, menginstal ulang atas aplikasi yang sudah ada, menguji versi lama, dan mendiagnosis gagalnya paket tanpa meninggalkan terminal. Itulah mengapa frasa ‘ADB install APK’ terus menerus muncul dalam alur kerja tim nyata setelah fase ‘membuat awal’ berlalu. Mengatur Lingkungan Anda untuk Adb

Masalah ADB pada awalnya tidak selalu masalah instalasi. Melainkan masalah pengaturan. Mesin tidak dapat menemukan

, perangkat tidak diotorisasi, atau OEM menambahkan toggle tambahan yang tidak Anda ketahui. adbPetunjuk Langkah 7 untuk mengatur lingkungan Bridge Debug Android untuk pengembang.

Instal Tools Platform pada Mesin Anda

Install ADB

Kamu tidak perlu menginstal Android Studio secara lengkap hanya untuk menjalankan ADB. Kamu memerlukan SDK Alat-Alat Platform, kemudian kamu perlu memastikan terminal kamu mengetahui lokasi mereka.

On Windows, macOS, dan Linux, konfigurasi yang paling bersih adalah sama:

  1. Unduh Alat-Alat Platform dari Google.
  2. Ekstrak arsip tersebut ke suatu lokasi yang stabil.
  3. Tambahkan folder tersebut ke PATH kamu sehingga adb berfungsi di jendela terminal mana pun.

Jika kamu sedang mengatur mesin Capacitor dari awal, langkah ini Petunjuk pengaturan Android untuk aplikasi Capacitor adalah panduan berguna untuk rantai alat yang lebih luas.

Pakai terminal untuk memastikan perintah tersedia:

adb version

Jika itu mengembalikan versi daripada “perintah tidak ditemukan,” Anda sudah dalam keadaan baik.

Beberapa kebiasaan spesifik platform membantu:

  • Windows: Masukkan Platform Tools ke dalam jalur yang tidak akan berubah, lalu tambahkan folder tersebut ke Variabel Lingkungan.
  • macOS: Tambahkan jalur folder ke profil shell Anda seperti .zshrc.
  • Linux: Tambahkan jalur yang sama ke konfigurasi shell Anda, lalu muat ulang shell.

Aktifkan Pengaturan yang Tepat pada Perangkat

Perangkat sisi perlu dianggap sama pentingnya. Prasyarat kritis adalah mengaktifkan Debugging USB melalui Pilihan Pengembang, yang Anda aktifkan dengan mengetuk Nomor Pembangunan tujuh kali. Pada perangkat Xiaomi dengan MIUI, Anda mungkin juga perlu mengaktifkan Pasang melalui USB, seperti yang dijelaskan dalam referensi pengaturan ADB di dev.to itu meninggalkan daftar periksa singkat:.

Pilih Pilihan Pengembang:

  • ADB setup reference on dev.to Tekan Nomor Versi Build tujuh kali.
  • Perbolehkan Debugging USB: Setting ini yang dibutuhkan oleh ADB.
  • Perhatikan tambahan OEM: Xiaomi adalah contoh klasik.
  • Hubungkan dengan kabel yang dapat diandalkan: Kabel pengisian daya saja akan menghabiskan waktu.

Prompt di ponsel juga penting sekaligus dengan kabel. Jika Anda melewatkan ‘Perbolehkan Debugging USB?’, komputer mungkin dapat melihat perangkat tetapi ADB masih tidak diizinkan untuk menggunakan perangkat tersebut.

Ketika Anda menghubungkan perangkat pertama kali, Android akan bertanya apakah Anda ingin mempercayai komputer. Terima permintaan tersebut, dan jika ini adalah mesin pengembangan Anda, izinkan secara permanen. Jika Anda melewatkan prompt tersebut, alur kerja selanjutnya akan gagal dan terlihat lebih misterius daripada yang sebenarnya.

Alur Kerja Dasar Instal Aplikasi ADB

Setelah setup selesai, jalur instalasi menjadi singkat. Salah satu kesalahan umum adalah melewatkan satu periksaan yang memberitahu mereka apakah perintah selanjutnya memiliki kemungkinan berhasil.

Foto laptop Dell yang menampilkan status koneksi perangkat ADB di terminal dengan smartphone Android yang terhubung di dekatnya.

Periksa Perangkat Sebelum Anda Menginstal

Jalankan Pertama-tama:

adb devices

Mau melihat nomor serial terhubung dengan status perangkat sehat. Jika perangkat tampak tidak diotorisasi, berhenti di sana dan perbaiki otorisasi sebelum Anda mencoba menginstal apa pun.

Untuk tim yang sibuk mengatur debug, QA, dan kandidat rilis, juga membantu untuk jelas tentang jenis build apa yang Anda dorong. Ringkasan ini tentang jenis build aplikasi seluler adalah referensi yang baik jika folder Anda penuh dengan APK yang bernama sama.

Jalankan Perintah Instalasi

Perintah dasar adalah sederhana:

adb install path/to/your-app.apk

Jika jalur berisi spasi, kutipnya di shell Anda. Jika Anda berada di folder yang sama dengan APK, perintah menjadi lebih singkat:

adb install app-debug.apk

Jalankan Instalasi yang Sehat

Instalasi yang sehat biasanya menampilkan pesan instalasi yang di-streaming dan kemudian pesan kesuksesan di terminal. Itu adalah output yang Anda inginkan karena itu mengkonfirmasi bahwa manajer paket menerima APK dan menyelesaikan instalasi.

Berikut adalah walkthrough jika Anda ingin melihat aliran dalam aksi:

Di balik layar, adb install melakukan lebih dari sekadar menyalin file. Secara internal, ia mengirim APK ke /data/local/tmpmengaktifkan pm installdan kemudian menghapus file sementara. Alur kerja streaming tercermin dalam output terminal seperti “Melakukan Instalasi Streaming” diikuti oleh “Sukses”berdasarkan detail implementasi yang disinggung dalam referensi setup sebelumnya.

Hal ini penting karena lebih bersih daripada kebiasaan dua langkah lama melakukan adb push dan kemudian mengaktifkan perintah manajer paket sendiri. Dalam praktek sehari-hari, instalasi streaming memiliki beberapa kelebihan:

  • Kurang manual pekerjaan: perintah tunggal menghandle transfer dan instalasi. Kurang manual pekerjaan: perintah tunggal menghandle transfer dan instalasi.
  • Lebih sedikit perangkat yang berantakan: artefak sementara dibersihkan secara otomatis.
  • Lebih sedikit kemungkinan untuk terjebak: anda tidak akan menekan file yang salah dan menginstal file lain secara tidak sengaja.

Jika Anda bisa menggunakan adb install, gunakanlah. Manual push plus shell install berguna untuk kasus-kasus di tepi, tetapi itu bukan jalur default untuk pengujian aplikasi normal.

Untuk alur kerja instalasi APK ADB, itu adalah loop inti: verifikasi perangkat, jalankan instalasi, konfirmasi kesuksesan, luncurkan aplikasi, ulangi setelah build berikutnya.

Menguasai Flag-Flag ADB untuk Alur Kerja yang Lebih Cepat

Perintah dasar mendapatkan APK ke ponsel. Flag-Flag tersebut menentukan apakah proses tersebut sesuai dengan pengembangan nyata atau terus-menerus berjuang.

Flag-Flag ADB Instalasi yang Umum dan Penggunaannya

Flag Penggunaan Kasus Penggunaan Umum
-r Menginstal ulang aplikasi yang sudah ada sambil menjaga data aplikasi ketika memungkinkan Mengulang pengembangan harian dengan debug
-d Mengizinkan penurunan versi Menguji skenario rollback atau versi lama
-g Mengizinkan izin waktu eksekusi pada saat instalasi Menghemat waktu tes untuk fitur kamera, penyimpanan, lokasi, dan fitur serupa

Bendera yang paling penting untuk pengembangan harian adalah -r.

Tidak ada bendera ini, maka mengupdate paket yang sudah terinstal sering gagal karena Android menganggap APK baru sebagai upaya instalasi yang bersaing daripada pengganti. Itulah mengapa banyak pengembang menjadikan adb install -r app-debug.apk muscle memory mereka secara default.

Yang Paling Penting dalam Pengembangan Harian

-r adalah bendera yang akan digunakan secara terus-menerus. Jika Anda tes aplikasi Capacitor dan membangun beberapa kali dalam satu jam, menghapus aplikasi setiap siklus akan lambat dan menghapus keadaan lokal yang berguna. Reinstall memungkinkan Anda untuk terus bergerak.

-d adalah lebih situasional, tetapi ketika Anda membutuhkannya, Anda benar-benar membutuhkannya. Ini berguna untuk tes regresi, latihan rollback, atau memeriksa apakah versi lama masih membuka database legacy dengan benar.

-g adalah flag kualitas hidup. Jika aplikasi Anda menyentuh izin awal, pengizinan otomatis menghilangkan beberapa sentuhan berulang dari pengaturan perangkat. Ini tidak akan menggantikan pengujian izin yang tepat, tetapi sangat berguna ketika Anda membutuhkan untuk melewati instalasi dan peluncuran dengan cepat.

Beberapa kombinasi sering muncul:

adb install -r app-debug.apk

adb install -r -g app-debug.apk

adb install -r -d older-build.apk

Terdapat perdagangan dengan semua flag. Kemudahan yang lebih besar dapat menyembunyikan kondisi nyata pengguna. Jika Anda mengizinkan otomatis setiap kali, Anda mungkin melewatkan kasus izin waktu eksekusi. Jika Anda selalu menginstal ulang atas data lama, Anda mungkin melewatkan masalah peluncuran pertama.

Itulah mengapa tim yang berpengalaman biasanya membagi kebiasaan mereka:

  • Loop pembangunan cepat: gunakan -rsometimes -g.
  • Pemeriksaan keadaan bersih: uninstall terlebih dahulu, kemudian instal ulang segar.
  • Pengujian rollback: gunakan -d saat versi pergerakan adalah hal yang sedang diuji.

Jika Anda ingin memperbarui pengetahuan Anda tentang Capacitor secara lebih luas dari sisi command-line, panduan ini tentang Capacitor __CAPGO_KEEP_1__ perintah dan perbaikan umum common Capacitor CLI commands and fixes Troubleshooting Kesalahan Pemasangan Umum

ADB cukup dapat diandalkan sehingga kesalahan pemasangan yang berulang sering menunjukkan masalah tertentu. Triknya adalah menghentikan kesalahan pemasangan dianggap sebagai acak. Mereka cenderung berkumpul di sekitar otorisasi, penggantian paket, dan identitas paket.

Daftar Periksa Perbaikan untuk Kesalahan Pemasangan Android Debug Bridge (ADB) yang Umum dan Solusi untuk Pengembang.

Ketika Perangkat Menampilkan sebagai Tidak Dijamin

Gejala:

menampilkan

adb devices Penyebab Utama: ponsel belum mempercayai komputer Anda, atau prompt ditolak. unauthorized

Perbaiki dalam urutan ini:

__CAPGO_KEEP_0__

  1. Hubungkan kembali perangkat dan tutup layar kunci.
  2. Cari prompt otorisasi RSA pada ponsel.
  3. Setujui prompt, idealnya dengan opsi 'selalu izinkan' untuk mesin pengembang Anda.
  4. Jika masih tidak dapat direcovery, restartlah server ADB:

adb kill-server

adb start-server

Masalah ini sering membuat terminal membuat masalah terlihat teknis, tetapi solusinya seringkali ada pada ponsel itu sendiri.

Ketika Paket Sudah Ada

Gejala:

INSTALL_FAILED_ALREADY_EXISTS

Biasanya berarti Anda mencoba menginstal di atas paket yang sudah ada tanpa menggunakan flag 'ganti' (replace). Kesalahan umum ini telah didokumentasikan dalam diskusi Stack Overflow tentang gagal instalasi ADB Simptom:.

Solusi paling cepat adalah:

adb install -r app-debug.apk

Jika Anda memerlukan instalasi bersih daripada pembaruan, hapus terlebih dahulu:

adb uninstall your.package.name

Gunakan jalur reinstall untuk iterasi rutin. Gunakan hapus hanya ketika Anda ingin menghapus status aplikasi lokal atau memverifikasi perilaku pertama kali.

Ketika Tanda Tangan dan Status Paket Lama Bertabrakan

Beberapa gagal bukanlah tentang file APK itu sendiri. Mereka tentang apa yang Android ingat tentang paket.

Dua pola sering muncul:

  • Tidak cocoknya tanda tangan: aplikasi yang terinstal ditandatangani dengan kunci yang berbeda daripada file APK yang Anda coba instal.
  • Status paket duplikat: sisa paket bertahan setelah dihapus dan menghalangi instalasi berikutnya.

Polanya yang kedua sangat mengganggu karena dapat bertahan setelah apa yang tampaknya sukses dihapus. Pada versi Android yang lebih baru, perilaku hapus yang berumur dapat meninggalkan status paket yang memicu INSTALL_FAILED_DUPLICATE_PACKAGEseperti yang disebutkan di atas.

Apa itu alur diagnostik yang efektif?

  • Pertama, pastikan identitas paket: Pastikan nama paket adalah yang Anda pikirkan.
  • Kemudian, periksa konsistensi tanda tangan: Build debug-signed dan release-signed tidak menggantikan satu sama lain dengan baik.
  • Lalu hapus paket yang terpasang: Gunakan jalur uninstall normal terlebih dahulu.
  • Jika masalah tetap berlanjut: Tangani sebagai keadaan paket yang ketinggalan, bukan glitch ADB acak.

Ada kerutan lain dengan APK debug yang didistribusikan di luar alat pengembang normal. Beberapa tim mengamati bahwa build yang sama terpasang melalui ADB tetapi gagal ketika disidangkan secara manual dari pesan atau email. Perilaku tersebut dapat terkait dengan verifikasi konteks-aware Android terhadap aplikasi debug-signed, yang dibahas dalam panduan untuk menyelesaikan kesalahan instalasi aplikasi pada Android . Dalam prakteknya, itu mengapa tim QA sebaiknya memilih ADB untuk distribusi debug internal daripada bergantung pada sideloading manual ad-hoc.

Catatan lapangan: Jika sebuah build terpasang melalui ADB tetapi tidak melalui sentuhan manual, jangan asumsikan APK rusak. Periksa konteks tanda tangan dan jalur instalasi terlebih dahulu.

Untuk proyek Capacitor yang terus-menerus mengalami masalah build dan deploy di lapisan native dan web, panduan troubleshooting ini untuk mengatasi kesalahan build Android di Capacitor Contoh Lengkap untuk Pengembang __CAPGO_KEEP_0__

Pada proyek Capacitor, loop terminal biasanya singkat. Anda sinkronkan file native, bangun aplikasi Android, dan unggah APK hasilnya ke perangkat terhubung tanpa membuka Android Studio kecuali Anda memerlukan debugging native.

In a Capacitor project, the terminal loop is usually short. You sync native files, build the Android app, and push the resulting APK to a connected device without opening Android Studio unless you need native debugging.

Bangun APK debug dari langkah build Android biasa, kemudian instal dengan penggantian diaktifkan:

npx cap sync android

Proses ini banyak digunakan oleh tim karena menjaga loop feedback tetap rapat. Untuk aplikasi CapacitorJS,

adb install -r android/app/build/outputs/apk/debug/app-debug.apk

di mana tim mengirimkan pembaruan diferensial, __CAPGO_KEEP_0__ __CAPGO_KEEP_0__ adb install terutama penting. Penelitian IBM menemukan bahwa 78% dari tim mobile berbasis Android mengutamakan metode ini daripada pengiriman melalui Toko Play untuk perbaikan JavaScript dan CSS secara real-time, menurut video referensi ini yang membahas instalasi APK berbasis ADB dalam alur kerja perusahaan Jika Anda masih mengatur sisi proyek dari alur kerja tersebut, panduan instalasi ini.

adalah titik awal yang solid. Capacitor CLI installation guide adalah dirancang untuk alur kerja tersebut. Ini memberikan Anda pembaruan hidup yang ditandatangani, peluncuran yang dipersiapkan, perlindungan rollback, dan visibilitas perangkat yang dapat Anda lakukan lebih cepat tanpa kehilangan kendali.


If your team uses Capacitor and wants to ship JavaScript, CSS, config, and asset fixes without waiting on app store review, Capgo context

Update Langsung untuk Aplikasi Capacitor

Ketika ada bug layer web yang aktif, kirimkan perbaikan melalui Capgo daripada menunggu hari-hari untuk persetujuan toko aplikasi. Pengguna mendapatkan update di latar belakang sementara perubahan native tetap dalam jalur review normal.

Dukungan Manusia dari Martin

Mulai Sekarang

Terbaru dari Blog Kami

Capgo memberikan Anda wawasan terbaik yang Anda butuhkan untuk membuat aplikasi mobile profesional yang sebenarnya.