Starting March 27, 2025, we recommend using android-latest-release instead of aosp-main to build and contribute to AOSP. For more information, see Changes to AOSP.

CommandUtil

public final class CommandUtil
extends Object

java.lang.Object
↳	com.android.sts.common.CommandUtil

Collection of utilities to help run commands on device via adb

Summary

Public methods
`static CommandResult`	`runAndCheck(ITestDevice device, String cmd, int retries)` Execute shell command on device, throws AssumptionError if command does not return 0.
`static CommandResult`	`runAndCheck(ITestDevice device, String cmd)` Execute shell command on device, throws AssumptionError if command does not return 0.

Public methods

runAndCheck

public static CommandResult runAndCheck (ITestDevice device, 
                String cmd, 
                int retries)

Execute shell command on device, throws AssumptionError if command does not return 0.

Parameters
`device`	`ITestDevice`: the device to use
`cmd`	`String`: the command to run
`retries`	`int`: the number of retries to attempt

Returns
`CommandResult`	the result of device.executeShellV2Command

Throws
`DeviceNotAvailableException`

runAndCheck

public static CommandResult runAndCheck (ITestDevice device, 
                String cmd)

Execute shell command on device, throws AssumptionError if command does not return 0.

Parameters
`device`	`ITestDevice`: the device to use
`cmd`	`String`: the command to run

Returns
`CommandResult`	the result of device.executeShellV2Command

Throws
`DeviceNotAvailableException`