Struct AdbDevice 

pub struct AdbDevice {
    pub serial: String,
    /* private fields */
}

Represents a connection to a specific Android device via the ADB server.

Each operation opens a fresh TCP connection to the ADB server, selects the transport for this device, then performs the command. This matches how the ADB protocol works — there is no persistent session.

Fields

serial: String

Implementations

impl AdbDevice

pub fn new( serial: impl Into<String>, host: impl Into<String>, port: u16, ) -> Self

Create a new device handle.

pub fn with_serial(serial: impl Into<String>) -> Self

Create a device handle using default ADB server address.

pub async fn get_state(&self) -> Result<DeviceState>

Get the device state (device, offline, unauthorized, etc.).

pub async fn get_serialno(&self) -> Result<String>

Get the real serial number of the device.

pub async fn get_features(&self) -> Result<Vec<String>>

Get the device feature list (e.g., shell_v2, cmd, stat_v2).

pub async fn shell(&self, cmd: &str) -> Result<String>

Run a shell command and return stdout as a String.

pub async fn shell_bytes(&self, cmd: &str) -> Result<Vec<u8>>

Run a shell command and return stdout as raw bytes.

pub async fn shell2(&self, cmd: &str) -> Result<ShellOutput>

Run a shell command and return both stdout and exit code.

Wraps the command in a subshell (cmd) so that even exit N won’t prevent the sentinel from being printed, then appends ; echo DROIDRUN_EXIT:$? to capture the exit code.

pub async fn getprop(&self, name: &str) -> Result<String>

Get a system property by name.

pub async fn prop_model(&self) -> Result<String>

Get the device model (ro.product.model).

pub async fn prop_name(&self) -> Result<String>

Get the device name (ro.product.name).

pub async fn prop_device(&self) -> Result<String>

Get the device codename (ro.product.device).

pub async fn tap(&self, x: i32, y: i32) -> Result<()>

Tap at screen coordinates.

pub async fn swipe( &self, x1: i32, y1: i32, x2: i32, y2: i32, duration_ms: u32, ) -> Result<()>

Swipe from (x1, y1) to (x2, y2) over duration_ms milliseconds.

pub async fn keyevent(&self, keycode: i32) -> Result<()>

Send a key event.

pub async fn drag( &self, sx: i32, sy: i32, ex: i32, ey: i32, duration_ms: u32, ) -> Result<()>

Drag from (sx, sy) to (ex, ey) over duration_ms milliseconds.

pub async fn input_text(&self, text: &str) -> Result<()>

Type text using ADB input method.

Note: For reliable Unicode text input, use droidrun-core’s Portal keyboard. This method escapes special shell characters but cannot handle all Unicode.

pub async fn screencap(&self) -> Result<Vec<u8>>

Take a screenshot and return PNG bytes.

pub async fn app_start( &self, package: &str, activity: Option<&str>, ) -> Result<String>

Start an app with optional activity name.

pub async fn app_stop(&self, package: &str) -> Result<()>

Force stop an app.

pub async fn app_clear(&self, package: &str) -> Result<String>

Clear app data and cache.

pub async fn app_current(&self) -> Result<CurrentApp>

Get the current foreground app.

pub async fn app_info(&self, package: &str) -> Result<AppDetail>

Get detailed info about an installed app.

pub async fn install(&self, apk_path: &Path, flags: &[&str]) -> Result<String>

Install an APK on the device.

Pushes the APK to /data/local/tmp/, runs pm install, then removes it.

pub async fn uninstall(&self, package: &str) -> Result<String>

Uninstall an app.

pub async fn list_packages(&self, flags: &[&str]) -> Result<Vec<String>>

List installed packages.

pub async fn forward(&self, local_port: u16, remote_port: u16) -> Result<u16>

Set up port forwarding. Returns the local port.

If local_port is 0, the ADB server assigns a free port.

pub async fn forward_list(&self) -> Result<Vec<ForwardEntry>>

List all port forwards for this device.

pub async fn forward_remove(&self, local_port: u16) -> Result<()>

Remove a specific port forward.

pub async fn forward_remove_all(&self) -> Result<()>

Remove all port forwards for this device.

pub async fn reverse(&self, remote_port: u16, local_port: u16) -> Result<()>

Set up reverse port forwarding (device → host).

pub async fn reverse_list(&self) -> Result<Vec<ReverseEntry>>

List all reverse port forwards.

pub async fn reverse_remove(&self, remote_port: u16) -> Result<()>

Remove a specific reverse forward.

pub async fn reverse_remove_all(&self) -> Result<()>

Remove all reverse forwards.

pub async fn root(&self) -> Result<String>

Restart adbd as root. Only works on userdebug/eng builds or emulators.

pub async fn tcpip(&self, port: u16) -> Result<String>

Switch adbd to TCP/IP mode on the given port.

pub async fn reboot(&self, mode: RebootMode) -> Result<()>

Reboot the device.

pub async fn push(&self, local_path: &Path, remote_path: &str) -> Result<()>

Push a local file to the device using the sync protocol.

pub async fn push_bytes(&self, data: &[u8], remote_path: &str) -> Result<()>

Push raw bytes to a file on the device.

pub async fn pull_bytes(&self, remote_path: &str) -> Result<Vec<u8>>

Pull a file from the device and return its contents as bytes.

pub async fn pull(&self, remote_path: &str, local_path: &Path) -> Result<()>

Pull a file from the device to a local path.

pub async fn stat(&self, path: &str) -> Result<FileStat>

Get file metadata via sync STAT protocol.

pub async fn list_dir(&self, path: &str) -> Result<Vec<SyncDirEntry>>

List directory contents via sync LIST protocol.

pub async fn exists(&self, path: &str) -> Result<bool>

Check if a file or directory exists on the device.

pub async fn remove(&self, path: &str) -> Result<()>

Delete a file on the device.

pub async fn rmtree(&self, path: &str) -> Result<()>

Delete a directory recursively on the device.

pub async fn window_size(&self) -> Result<ScreenSize>

Get screen dimensions.

pub async fn rotation(&self) -> Result<u8>

Get current screen rotation (0=natural, 1=left, 2=inverted, 3=right).

pub async fn is_screen_on(&self) -> Result<bool>

Check if the screen is currently on.

pub async fn switch_screen(&self, on: bool) -> Result<()>

Turn screen on or off.

pub async fn wlan_ip(&self) -> Result<String>

Get the device’s WLAN IP address.

pub async fn get_date(&self) -> Result<String>

Get the device date/time.

pub async fn logcat(&self, filter: Option<&str>) -> Result<Receiver<String>>

Stream logcat output. Returns an mpsc receiver.

The stream runs in a background task until the receiver is dropped.

Trait Implementations

impl Clone for AdbDevice

fn clone(&self) -> AdbDevice

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AdbDevice

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.