ADB: dasar bekerja dengan Android Debug Bridge dan perintah populer

Apa itu ADB dan untuk apa

Android Debug Bridge (ADB) — adalah aplikasi klien-server yang terdiri dari tiga komponen: klien (berjalan di komputer), server (proses latar belakang di komputer), dan daemon adbd (berjalan di perangkat Android itu sendiri). Ketika pengembang atau insinyur menghubungkan smartphone ke PC, ADB membuat saluran komunikasi yang andal yang dapat digunakan untuk mengirimkan perintah, file, dan data.

Skenario penggunaan utama ADB meliputi debugging aplikasi pada perangkat nyata tanpa perlu mempublikasikan APK di toko, mengekstrak log untuk analisis kesalahan, otomatisasi pengujian, pencadangan data, flashing image recovery, dan mendapatkan akses root. Bahkan jika Anda tidak menulis kode, ADB dapat berguna untuk mengekstrak tangkapan layar dari aplikasi, merekam panduan video dari layar ponsel, atau memulihkan perangkat setelah flashing yang gagal.

Dukungan ADB terintegrasi di semua build resmi Android mulai dari versi 2.1 (API 7). Untuk pengoperasian, diperlukan opsi 'Debug USB' yang diaktifkan di pengaturan pengembang. Mulai Android 4.2, saat pertama kali terhubung, perangkat meminta konfirmasi: Anda harus mengizinkan debugging untuk komputer tertentu berdasarkan kunci RSA-nya.

Instalasi ADB di komputer

Untuk Windows — unduh Platform Tools dari situs resmi Google Developers, ekstrak arsip ke folder C:\adb dan tambahkan jalur ini ke variabel lingkungan PATH. Setelah memulai ulang terminal, perintah adb akan tersedia secara global.

Untuk macOS — cara termudah adalah menginstal ADB melalui manajer paket Homebrew: jalankan brew install android-platform-tools. Semua dependensi akan diselesaikan secara otomatis.

Untuk Linux — di distribusi berbasis Debian / Ubuntu: sudo apt install adb. Setelah instalasi, tambahkan pengguna ke grup plugdev: sudo usermod -aG plugdev $USER dan login kembali agar ADB mendapatkan akses ke perangkat USB.

Keberhasilan instalasi dapat diperiksa dengan perintah adb version. Jika nomor versi Android Debug Bridge ditampilkan, alat siap digunakan.

Menghubungkan perangkat dan perintah dasar

Koneksi pertama selalu dimulai dengan perintah adb devices. Ini menampilkan daftar perangkat yang terhubung dan statusnya. Jika perangkat muncul sebagai unauthorized, buka kunci layar dan konfirmasi debugging di ponsel.

adb devices
List of devices attached
emulator-5554   device
0123456789ABCD  device

Instalasi aplikasi — salah satu operasi paling umum. Cukup tentukan jalur ke file APK:

adb install C:\apps\myapp.apk

Jika aplikasi sudah terinstal tetapi perlu diganti dengan versi yang diperbarui, tambahkan flag -r (replace):

adb install -r C:\apps\myapp-v2.apk

Penghapusan aplikasi dilakukan berdasarkan nama paket:

adb uninstall com.example.myapp

Menyalin file — adb pull mengambil file dari perangkat ke komputer, adb push mengunggah file ke perangkat:

adb pull /sdcard/DCIM/screenshot.png .
adb push myfile.txt /sdcard/Documents/

Shell interaktif — perintah adb shell membuka shell perintah perangkat. Di dalamnya, Anda dapat menjalankan perintah Linux standar: ls, ps, top, dumpsys, pm, am, dan lainnya.

adb shell
tissot_sprout:/ $ ls -la /sdcard/
tissot_sprout:/ $ ps | grep com.android.chrome

Menjalankan aktivitas melalui ADB memungkinkan Anda membuka aplikasi atau layar apa pun tanpa mencari ikon secara manual:

adb shell am start -n com.android.chrome/com.google.android.apps.chrome.Main

Bekerja dengan log: Logcat

Logcat — adalah sistem pencatatan Android yang mengumpulkan pesan dari aplikasi, layanan sistem, dan kernel. Alat ini sangat diperlukan saat debugging: dari log Anda dapat memahami mengapa aplikasi crash, metode mana yang menyebabkan pengecualian, atau berapa lama operasi tertentu berlangsung.

Menjalankan sederhana tanpa filter — adb logcat. Aliran log tidak terbatas, tekan Ctrl+C untuk berhenti. Untuk memfilter pesan berdasarkan tag, gunakan parameter -s:

adb logcat -s MainActivity:V

Tingkat kepentingan pencatatan (dari paling detail hingga kritis): V (Verbose), D (Debug), I (Info), W (Warning), E (Error), F (Fatal). Kombinasi tag dan tingkat memungkinkan Anda mengekstrak hanya pesan yang diperlukan.

Untuk membersihkan buffer yang terkumpul sebelum pengujian:

adb logcat -c

Dan untuk menyimpan log ke file:

adb logcat -d > app_logs.txt

Flag -d (dump) menampilkan buffer saat ini dan menyelesaikan tanpa memblokir terminal. Ini nyaman untuk skrip otomatisasi.

Tangkapan layar, rekaman layar, dan perintah diagnostik berguna

Tangkapan layar dibuat dengan perintah adb shell screencap. Hasilnya disimpan dalam file yang kemudian diekstrak melalui adb pull:

adb shell screencap /sdcard/screen.png
adb pull /sdcard/screen.png

Anda dapat menggabungkan kedua operasi dalam satu baris menggunakan substitusi dan pipeline. Dalam praktiknya, ini mempercepat pembuatan dokumentasi dan laporan pengujian.

Rekaman layar tersedia di Android 4.4+ (API 19). Durasi rekaman default — 180 detik, bitrate — 4 Mbit/s. Perintah utama:

adb shell screenrecord /sdcard/demo.mp4

Untuk menghentikan rekaman, tekan Ctrl+C. Resolusi video sesuai dengan resolusi layar perangkat, tetapi tidak melebihi 1080p. Untuk mengubah bitrate, tentukan --bit-rate:

adb shell screenrecord --bit-rate 8000000 /sdcard/demo.mp4

Perintah diagnostik: adb shell dumpsys menampilkan status semua layanan sistem. Untuk mendapatkan informasi hanya tentang baterai:

adb shell dumpsys battery

Daftar paket yang terinstal dapat diperoleh melalui Package Manager:

adb shell pm list packages

Mereset pengaturan aplikasi (analog dengan menghapus data di pengaturan):

adb shell pm clear com.example.myapp

Fitur lanjutan ADB

Debugging Wi-Fi menghilangkan kebutuhan untuk menjaga perangkat tetap terhubung melalui USB. Pastikan komputer dan perangkat berada di jaringan yang sama. Pertama jalankan adb tcpip 5555, lepaskan USB, lalu hubungkan melalui IP:

adb tcpip 5555
adb connect 192.168.1.100:5555

Jika alamat IP perangkat tidak diketahui, cari tahu melalui adb shell ip addr show wlan0 sebelum melepas kabel.

Pencadangan data aplikasi atau seluruh sistem dilakukan tanpa root:

adb backup -apk -shared -all -system -f mybackup.ab

Pemulihan dari cadangan:

adb restore mybackup.ab

Emulasi masukan — perintah adb shell input memungkinkan simulasi sentuhan, gesekan, penekanan tombol, dan masukan teks. Ini adalah dasar untuk otomatisasi pengujian UI tanpa framework tambahan:

adb shell input tap 500 1000
adb shell input swipe 300 500 800 500
adb shell input text "Hello, ADB!"

Mulai ulang dalam mode berbeda:

adb reboot          # restart normal
adb reboot recovery # mode pemulihan
adb reboot bootloader # bootloader (fastboot)

Mode fastboot membuka akses ke flashing image, membuka kunci bootloader, dan menginstal recovery kustom.

Bekerja dengan beberapa perangkat

Ketika beberapa perangkat atau emulator terhubung secara bersamaan, ADB memerlukan nomor seri tertentu. Perintah adb devices menampilkan semua perangkat yang terhubung dengan nomor serinya.

Untuk mengarahkan perintah ke perangkat tertentu, gunakan flag -s:

adb -s 0123456789ABCD install myapp.apk

Jika hanya satu perangkat, Anda dapat bekerja tanpa flag. Namun di lingkungan CI di mana beberapa emulator berjalan secara bersamaan, menentukan nomor seri adalah wajib.

Mematikan server ADB — jika perangkat berhenti terdeteksi atau memberikan kesalahan, memulai ulang server membantu:

adb kill-server
adb start-server

Setelah itu jalankan adb devices — server akan restart dan mengarahkan permintaan ke daemon perangkat.

Perintah utama ADB: tabel ringkasan

Kesimpulan

ADB (Android Debug Bridge) — adalah alat fundamental bagi siapa saja yang bekerja dengan Android di tingkat profesional. Dari instalasi dasar aplikasi hingga otomatisasi pengujian yang kompleks dan pemulihan perangkat — ADB mencakup hampir semua skenario interaksi komputer dengan smartphone atau tablet.

Dengan menguasai perintah yang dijelaskan dalam artikel ini, Anda akan dapat mengelola perangkat Android melalui terminal dengan percaya diri, menganalisis log, mengambil tangkapan layar untuk dokumentasi, melakukan pencadangan, dan mempercepat proses pengembangan. Latihan rutin dan mempelajari output dari adb help akan menjadikan Anda pengguna berpengalaman dari alat yang kuat ini.