Crate adb_client

adb_client

Android Debug Bridge (ADB) client implementation in pure Rust !

Main features :

• Full Rust, no need to use shell commands
• Currently only support server TCP/IP protocol
• Highly configurable
• Easy to use !

Examples

First declare adb_client as a dependency by simply adding this to your Cargo.toml:

[dependencies]
adb_client = "*"

Launch a command on host device

use adb_client::AdbTcpConnection;
use std::net::Ipv4Addr;

let mut connection = AdbTcpConnection::new(Ipv4Addr::from([127,0,0,1]), 5037).unwrap();
connection.shell_command(None, vec!["df", "-h"]);

Get available ADB devices

use adb_client::AdbTcpConnection;
use std::net::Ipv4Addr;

let mut connection = AdbTcpConnection::new(Ipv4Addr::from([127,0,0,1]), 5037).unwrap();
connection.devices();

Push a file to the device

use adb_client::AdbTcpConnection;
use std::net::Ipv4Addr;
use std::fs::File;
use std::path::Path;

let mut connection = AdbTcpConnection::new(Ipv4Addr::from([127,0,0,1]), 5037).unwrap();
let mut input = File::open(Path::new(&filename)).unwrap(); 
connection.send(None, &mut input, &path)?;

Rust binary

This crate also provides a lightweight binary based on the adb_client crate. You can install it by running the following command :

cargo install adb_client --example adb_cli 

Missing features

• USB protocol

All pull requests are welcome !

Documentation

• https://developer.android.com/studio/command-line/adb

• https://github.com/cstyan/adbDocumentation

Structs

• AdbTcpConnection
  Represents an ADB-over-TCP connection.
• AdbVersion
  Represents the ADB server version.
• Device
  Represents a device connected to the ADB server.
• DeviceLong
  Represents a new device with more informations helded.

Enums

• DeviceState
  Represents the connection state of the device.
• RebootType
  Type of reboot needed.
• RustADBError
  Represents all error types that can be thrown by the crate.

Type Aliases

• Result
  Custom Result type thrown by this crate.