ADB_Tutorial

ADB (Android Debug Bridge) is a debugging bridge tool from Google's Android SDK Platform-Tools for Android development. It supports connecting to devices via USB or network, enabling device management and debugging operations such as application installation, file transfer, and command execution.

Quick Start with ADB

Debugging Cable and Interface

• Debugging Cable: Use a USB Type-C data cable.

• Debugging Interface: The USB Type-C interface on the motherboard.

Obtaining and Installing ADB Tools

Obtaining the Tools

The ADB software tools can be obtained from the KICKPI cloud disk for use on the Windows platform. They are located in the following directory on the cloud disk:

5-DevelopmentTool/win_x64_ADB_Tool/adb-tools.rar

Google's latest Android SDK Platform-Tools can be downloaded from https://developer.android.com/tools/releases/platform-tools .

Installation Steps

1. Extract the adb-tools.rar archive, for example, to the path D:\ADB Tool\adb-tools.

2. Open a command-line window and switch to the extracted directory:

ADB$ cd D:\ADB Tool\adb-tools

1. Run the following command. A successful run indicates successful installation:

ADB$ adb --version

Example:

PS D:\ADB Tool\adb-tools> .\adb.exe --version
Android Debug Bridge version 1.0.40
Version 4797878
Installed as D:\ADB Tool\adb-tools\adb.exe

Detecting Devices with ADB

1. Connect the computer to the motherboard using a TYPE-C data cable.

2. Open a command-line window, switch to the directory where the ADB tools are extracted, and run the following command. If the connection is successful, the corresponding device can be detected:

ADB$ adb devices

Example:

PS D:\ADB Tool\adb-tools> .\adb.exe devices
List of devices attached
5d5543a9bcc93eec        device

Using ADB Features

ADB, full name Android Debug Bridge, is a debugging bridge tool for Android development. It supports connecting to devices via USB or network, enabling device management and debugging operations such as application installation, file transfer, and command execution.

The following is an introduction to some commonly used ADB commands.

View help

adb help

Device Connection and Management

Viewing Connected Devices

adb devices

This command is used to view all devices currently connected to the computer via ADB. If a device is correctly connected and authorized, its serial number and status (e.g., "device") will be displayed.

Restarting the Device

adb reboot

This command restarts the connected device.

File Operations

Uploading Files to the Device

adb push <local file path> <device target path>

For example, to upload the local test.txt file to the /sdcard/ directory on the device, use the following command:

adb push test.txt /sdcard/

Downloading Files from the Device

adb pull <device file path> <local target path>

To download the /sdcard/log.txt file from the device to the local current directory, use:

adb pull /sdcard/log.txt .

Performing File System Operations on the Device

adb shell ls /sdcard

This command executes the ls command in the device's shell environment to view the list of files and folders in the /sdcard directory.

Application Management

Only for Android platforms

Installing an Application

adb install <APK file path>

To install the local app.apk file, use:

adb install app.apk

Uninstalling an Application

adb uninstall <application package name>

For example, to uninstall the application with the package name com.example.app, use:

adb uninstall com.example.app

Clearing Application Data

adb shell pm clear <application package name>

This command clears all data of the specified application. To clear the data of com.example.app, use:

adb shell pm clear com.example.app

System Debugging

Entering the Device's Shell Environment

adb shell

After executing this command, you will enter the device's command-line interface, where you can execute various system commands.

Viewing System Logs

Only for Android platforms

adb logcat

This command is used to view the device's system logs, which can help developers locate application or system issues. Press Ctrl + C to stop the log output.

Taking a Screenshot

Only for Android platforms

adb shell screencap -p /sdcard/screenshot.png

This command generates a screenshot file named screenshot.png in the /sdcard directory on the device. You can then use the adb pull command to download it to the local machine.

Common Issues

ADB Device Not Recognized

When performing ADB debugging, check if the system Device Manager detects a device similar to the following example while the board's blue light is blinking:

image-20250509185304921

If an Unknown Device or Other devices is detected (as shown below), manually install the driver:

image-20250226152046272

Manually Install the Driver

Follow these steps:

370849870429aae4906079eb686ee326

image-20250226152541205

image-20250226152555933

image-20250226152618854

image-20250226152635425

image-20250226152643858

image-20250226152654260