adb_client
| Crates.io | adb_client |
| lib.rs | adb_client |
| version | |
| source | src |
| created_at | 2022-01-05 10:08:23.355008 |
| updated_at | 2024-12-18 10:19:45.431396 |
| description | Rust ADB (Android Debug Bridge) client library |
| homepage | |
| repository | https://github.com/cocool97/adb_client |
| max_upload_size | |
| id | 508307 |
| Cargo.toml error: | TOML parse error at line 18, column 1 | 18 | autolib = false | ^^^^^^^ unknown field `autolib`, expected one of `name`, `version`, `edition`, `authors`, `description`, `readme`, `license`, `repository`, `homepage`, `documentation`, `build`, `resolver`, `links`, `default-run`, `default_dash_run`, `rust-version`, `rust_dash_version`, `rust_version`, `license-file`, `license_dash_file`, `license_file`, `licenseFile`, `license_capital_file`, `forced-target`, `forced_dash_target`, `autobins`, `autotests`, `autoexamples`, `autobenches`, `publish`, `metadata`, `keywords`, `categories`, `exclude`, `include` |
| size | 0 |
(cocool97)
documentation
README
adb_client
Rust library implementing ADB protocol.
Installation
Add adb_client crate as a dependency by simply adding it to your Cargo.toml:
[dependencies]
adb_client = "*"
Benchmarks
Benchmarks run on v2.0.6, on a Samsung S10 SM-G973F device and an Intel i7-1265U CPU laptop
ADBServerDevice push vs adb push
ADBServerDevice performs all operations by using adb server as a bridge.
| File size | Sample size | ADBServerDevice |
adb |
Difference |
|---|---|---|---|---|
| 10 MB | 100 | 350,79 ms | 356,30 ms | -1,57 % |
| 500 MB | 50 | 15,60 s | 15,64 s | -0,25 % |
| 1 GB | 20 | 31,09 s | 31,12 s | -0,10 % |
Examples
Get available ADB devices
use adb_client::ADBServer;
use std::net::{SocketAddrV4, Ipv4Addr};
// A custom server address can be provided
let server_ip = Ipv4Addr::new(127, 0, 0, 1);
let server_port = 5037;
let mut server = ADBServer::new(SocketAddrV4::new(server_ip, server_port));
server.devices();
Using ADB server as bridge
Launch a command on device
use adb_client::{ADBServer, ADBDeviceExt};
let mut server = ADBServer::default();
let mut device = server.get_device().expect("cannot get device");
device.shell_command(&["df", "-h"], &mut std::io::stdout());
Push a file to the device
use adb_client::ADBServer;
use std::net::Ipv4Addr;
use std::fs::File;
use std::path::Path;
let mut server = ADBServer::default();
let mut device = server.get_device().expect("cannot get device");
let mut input = File::open(Path::new("/tmp/f")).expect("Cannot open file");
device.push(&mut input, "/data/local/tmp");
Interact directly with end devices
(USB) Launch a command on device
use adb_client::{ADBUSBDevice, ADBDeviceExt};
let vendor_id = 0x04e8;
let product_id = 0x6860;
let mut device = ADBUSBDevice::new(vendor_id, product_id).expect("cannot find device");
device.shell_command(&["df", "-h"], &mut std::io::stdout());
(USB) Push a file to the device
use adb_client::{ADBUSBDevice, ADBDeviceExt};
use std::fs::File;
use std::path::Path;
let vendor_id = 0x04e8;
let product_id = 0x6860;
let mut device = ADBUSBDevice::new(vendor_id, product_id).expect("cannot find device");
let mut input = File::open(Path::new("/tmp/f")).expect("Cannot open file");
device.push(&mut input, &"/data/local/tmp");
(TCP) Get a shell from device
use std::net::{SocketAddr, IpAddr, Ipv4Addr};
use adb_client::{ADBTcpDevice, ADBDeviceExt};
let device_ip = IpAddr::V4(Ipv4Addr::new(192, 168, 0, 10));
let device_port = 43210;
let mut device = ADBTcpDevice::new(SocketAddr::new(device_ip, device_port)).expect("cannot find device");
device.shell(&mut std::io::stdin(), Box::new(std::io::stdout()));