Admin 12 Jun 2026 16:18

admin #general

Android Debug Bridge (ADB) - Complete Guide

Introduction to ADB

The Android Debug Bridge (ADB) is a versatile command-line tool that enables developers to communicate with an Android device, emulator, or connected device. ADB serves as a client-server program that includes three components:

A client, which can be invoked by running adb commands
A daemon (adbd), which runs commands on the device
A server, which manages communication between the client and daemon

ADB is part of the Android Platform Tools SDK and is primarily used for debugging Android applications, installing applications on devices, and transferring files. It provides a direct line of communication to a device that goes beyond what's normally possible through the Android interface alone.

Why ADB is Important

For Android developers and power users, ADB is an essential tool because it:

Facilitates application development and testing
Provides access to Unix shell to run commands on the device
Enables direct installation and uninstallation of applications
Offers advanced backup and restore capabilities
Supports port forwarding to facilitate socket connections
Allows screen mirroring and recording

Installing ADB

Setting up ADB varies depending on your operating system:

On Windows:

1. Download the Platform Tools from the Android developer website
2. Extract the ZIP file to a location on your computer
3. Add the folder to your system PATH
4. Open Command Prompt and verify installation with:
adb version

On macOS:

1. Install Homebrew if you haven't already
2. Run: brew install android-platform-tools
3. Verify installation with: adb version

On Linux:

1. For Ubuntu/Debian: sudo apt install android-tools-adb
2. For Fedora: sudo dnf install android-tools
3. Verify installation with: adb version

Setting Up Device Connection

Before using ADB, you need to enable Developer Options on your Android device:

1. Go to Settings > About
2. Tap "Build number" seven times
3. Go back to Settings > Developer Options
4. Enable "USB debugging"

Connect your device via USB and verify the connection with:

adb devices

Note: If prompted, allow USB debugging on your device. Some devices require additional drivers on Windows.

Basic ADB Commands

Device Information

adb devices - Lists all connected devices
adb get-serialno - Gets the serial number of the device
adb get-state - Shows device state (device, offline, unauthorized)
adb version - Shows ADB version

App Management

adb install app.apk - Installs an application
adb install -r app.apk - Reinstalls an existing app
adb uninstall package.name - Uninstalls an app
adb shell pm list packages - Lists all installed packages

File Operations

adb push local_file /device/path/ - Copy file from computer to device
adb pull /device/path/file local_file - Copy file from device to computer
adb shell ls - Lists files in the current directory

System Commands

adb reboot - Reboots the device
adb reboot recovery - Reboots to recovery mode
adb reboot bootloader - Reboots to bootloader/fastboot mode
adb shell - Starts an interactive shell on the device

Advanced ADB Techniques

Screen Recording

ADB can record your device's screen (Android 4.4 and later):

adb shell screenrecord /sdcard/demo.mp4
adb pull /sdcard/demo.mp4

Taking Screenshots

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

Logcat Analysis

View and filter system logs:

adb logcat - Shows all logs
adb logcat -c - Clears log buffer
adb logcat *:W - Shows only warnings and above
adb logcat -s TAG - Shows logs with specific tag

Debugging Applications

ADB offers powerful capabilities for debugging Android applications:

adb jdwp - Lists PIDs of processes waiting for debugger
adb forward tcp:8000 tcp:8000 - Sets up port forwarding
adb bugreport - Generates bug report for analysis
adb shell dumpsys - Provides detailed system information

Performance Monitoring

Monitor device performance with these ADB commands:

adb shell dumpsys cpuinfo - Shows CPU information
adb shell dumpsys meminfo - Shows memory information
adb shell dumpsys gfxinfo - Shows graphics performance
adb shell top - Shows running processes

Wireless Debugging

You can also use ADB over a network connection instead of USB:

1. Connect device via USB initially
adb tcpip 5555 - Sets device to listen on TCP port 5555
adb connect device_ip_address:5555 - Connects wirelessly
adb disconnect device_ip_address:5555 - Disconnects wireless connection

Note: Wireless debugging requires Android 11+ using a newer pairing method, but the above method works on older versions.

Troubleshooting Common Issues

"Device offline" error

Try these steps:

adb kill-server
adb start-server
Disconnect and reconnect the USB cable

"Unauthorized" error

Revoke USB debugging authorizations on your device
Disconnect and reconnect the device
Accept the debugging authorization prompt again

Device not detected

Check if the proper drivers are installed (especially on Windows)
Try a different USB cable (some cables can't transfer data)
Try a different USB port on your computer

Security Considerations

While ADB is a powerful tool, it also presents security concerns:

Only enable USB debugging when necessary
Be cautious when connecting to unknown computers
Revoke previous ADB authorizations periodically
Use ADB with a lock screen set up on your device
Consider using an ADB whitelist app for additional security

Conclusion

The Android Debug Bridge is an indispensable tool for developers, testers, and advanced users. It provides deep access to Android devices beyond the standard user interface, enabling sophisticated debugging, testing, and customization. As Android continues to evolve, ADB remains a reliable and powerful tool in the Android development ecosystem.

Mastering ADB commands can significantly enhance your productivity when working with Android devices. The ability to navigate the file system, install applications, read logs, and execute commands directly gives you complete control over your Android development workflow.

Reference Files For Android Debug Bridge (ADB)

Screenshoot