Guide: ADB commands for mobile software testers

In this article, QA Team Leader at ISSTA, Nir Tal, reviews useful ADB commands for tests of Android mobile devices. Android Debug Bridge is a multi-purpose command-line interface that allows you to communicate with your mobile device by running a variety of commands.

Tool Installation

  1. First, when installing Chocolatey, log into PowerShell.
  2. Fast installation for Windows users using Chocolatey, apart from installing ADB, also makes it an environment variable, as well as saves valuable time manually configuring this variable, which can also lead to errors.
  3. Verify that the tool has been installed successfully by writing “adb” in the command line, and verifying that all the options of the tool appear.

Tool Usage

  1. Connect the device with a USB cable into the computer and activate “Developer mode” on the device.
  2. Mark the option “Enabling USB Debugging”.
  3. Alow USB Debugging to be performed in the security panel.
  4. Make sure that the device is successfully connected by typing “adb devices”

To save following example scripts in files with an extension of “bat”, for example, “test.bat”, so that you do not have to write the commands repeatedly in the command line, but run the commands by executing this script file to achieve your testing goals.

Screenshots

Screenshots are mandatory for bug reports related to user experience.

The following script makes screenshots of your mobile phone with the timestamp of the current date and saves them to your desktop (or where you choose by changing the first command).

cd C:\Users\\Desktop

set SAVESTAMP=%DATE:/=-%@%TIME::=-%

set SAVESTAMP=%SAVESTAMP: =%

adb shell screencap -p /sdcard/%SAVESTAMP%.png

adb pull /sdcard/%SAVESTAMP%.png

adb shell rm /sdcard/%SAVESTAMP%.png

Saving logs via logcat

Logcat is a CLI tool that receives crash reports of applications and prints to the log that the application printed with the log class. Logs are very useful for development teams. When we find a bug that causes the application to crash, to reproduce and understand this issue.

Attached is the script – as in the previous script the logs are saved on the desktop with the timestamp of the current date.

cd C:\Users\\Desktop

set SAVESTAMP=%DATE:/=-%@%TIME::=-%

set SAVESTAMP=%SAVESTAMP: =%

adb logcat -v threadtime > %SAVESTAMP%.txt

Capturing video

Video helps greatly understand the flow that the user has performed and can help the developer to easily reproduce the error by viewing the steps performed in the recording beside from the textual description of the issue, screenshot or the log that we attach to it.

The following script is divided into 2. First, run the following command to start the recording:

adb shell screenrecord/sdcard /test.mp4

Then finish the recording with Ctrl + C. To pull the recording from the machine we run the following script:

cd C:\Users\\Desktop

adb pull /sdcard/test.mp4

adb shell rm /sdcard/test.mp4

Running ADB commands using WI-FI

To disconnect a physical connection between your device and your computer, run adb commands to your device using a Wi-Fi connection. Use an app from Google Play called “ADB wireless” and following the instructions.

Conclusion

In this article ABD was reviewed:

  • Installation
  • Activation
  • ADB commands are useful for mobile testing: screenshot, logcat logging, video capture, and ADB using Wi-Fi.

More
articles