18 releases (2 stable)

1.0.1 Apr 10, 2024
1.0.0 Oct 3, 2023
0.8.0 Aug 16, 2023
0.5.0 Apr 7, 2023
0.1.5 Jan 23, 2022

#110 in Debugging

Download history 5/week @ 2024-02-18 4/week @ 2024-02-25 2/week @ 2024-03-03 15/week @ 2024-03-10 1/week @ 2024-03-17 10/week @ 2024-03-31 119/week @ 2024-04-07 14/week @ 2024-04-14

143 downloads per month

MIT license

44KB
973 lines

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

Dependencies

~3.5–5.5MB
~94K SLoC