feat: add direct devices TLS support; refactoring (#64)
* feat: massive internal refactoring * feat: fix doc + add 'doc' github action * feat: improve code; add TLS --------- Co-authored-by: LIAUD Corentin <corentinliaud26@gmail.com>
This commit is contained in:
8
.github/workflows/rust-quality.yml
vendored
8
.github/workflows/rust-quality.yml
vendored
@@ -23,6 +23,14 @@ jobs:
|
||||
- name: Run formatter
|
||||
run : cargo fmt --all --check
|
||||
|
||||
doc:
|
||||
name: "doc"
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
- name: Run doc
|
||||
run : cargo doc --all-features --keep-going
|
||||
|
||||
tests:
|
||||
name: "tests"
|
||||
runs-on: ubuntu-latest
|
||||
|
||||
20
README.md
20
README.md
@@ -8,6 +8,9 @@
|
||||
<a href="https://crates.io/crates/adb_client">
|
||||
<img alt="crates.io" src="https://img.shields.io/crates/v/adb_client.svg"/>
|
||||
</a>
|
||||
<a href="https://github.com/cocool97/adb_client/actions">
|
||||
<img alt="ci status" src="https://github.com/cocool97/adb_client/actions/workflows/rust-build.yml/badge.svg"/>
|
||||
</a>
|
||||
<a href="https://deps.rs/repo/github/cocool97/adb_client">
|
||||
<img alt="dependency status" src="https://deps.rs/repo/github/cocool97/adb_client/status.svg"/>
|
||||
</a>
|
||||
@@ -20,24 +23,27 @@
|
||||
Main features of this library:
|
||||
|
||||
- Full Rust, don't use `adb *` shell commands to interact with devices
|
||||
- Supports:
|
||||
- **TCP/IP** protocol, using ADB server as a proxy (standard behavior when using `adb` CLI)
|
||||
- **USB** protocol, interacting directly with end devices
|
||||
- Supports
|
||||
- Using ADB server as a proxy (standard behavior when using `adb` CLI)
|
||||
- Connecting directly to end devices (without using adb-server)
|
||||
- Over **USB**
|
||||
- Over **TCP/IP**
|
||||
- Implements hidden `adb` features, like `framebuffer`
|
||||
- Highly configurable
|
||||
- Easy to use !
|
||||
|
||||
## adb_client
|
||||
|
||||
Rust library implementing both ADB protocols and providing a high-level abstraction over many supported commands.
|
||||
Rust library implementing both ADB protocols (server and end-devices) and providing a high-level abstraction over the many supported commands.
|
||||
|
||||
Improved documentation [here](./adb_client/README.md).
|
||||
Improved documentation available [here](./adb_client/README.md).
|
||||
|
||||
## adb_cli
|
||||
|
||||
Rust binary providing an improved version of official `adb` CLI, wrapping `adb_client` library. Can act as an usage example of the library.
|
||||
Rust binary providing an improved version of Google's official `adb` CLI, by using `adb_client` library.
|
||||
Provides an usage example of the library.
|
||||
|
||||
Improved documentation [here](./adb_cli/README.md).
|
||||
Improved documentation available [here](./adb_cli/README.md).
|
||||
|
||||
## Related publications
|
||||
|
||||
|
||||
@@ -1,9 +1,11 @@
|
||||
mod emu;
|
||||
mod host;
|
||||
mod local;
|
||||
mod tcp;
|
||||
mod usb;
|
||||
|
||||
pub use emu::EmuCommand;
|
||||
pub use host::HostCommand;
|
||||
pub use local::LocalCommand;
|
||||
pub use tcp::{TcpCommand, TcpCommands};
|
||||
pub use usb::{UsbCommand, UsbCommands};
|
||||
|
||||
44
adb_cli/src/commands/tcp.rs
Normal file
44
adb_cli/src/commands/tcp.rs
Normal file
@@ -0,0 +1,44 @@
|
||||
use std::net::SocketAddr;
|
||||
use std::path::PathBuf;
|
||||
|
||||
use clap::Parser;
|
||||
|
||||
use crate::models::RebootTypeCommand;
|
||||
|
||||
#[derive(Parser, Debug)]
|
||||
pub struct TcpCommand {
|
||||
pub address: SocketAddr,
|
||||
#[clap(subcommand)]
|
||||
pub commands: TcpCommands,
|
||||
}
|
||||
|
||||
#[derive(Parser, Debug)]
|
||||
pub enum TcpCommands {
|
||||
/// Spawn an interactive shell or run a list of commands on the device
|
||||
Shell { commands: Vec<String> },
|
||||
/// Pull a file from device
|
||||
Pull { source: String, destination: String },
|
||||
/// Push a file on device
|
||||
Push { filename: String, path: String },
|
||||
/// Stat a file on device
|
||||
Stat { path: String },
|
||||
/// Run an activity on device specified by the intent
|
||||
Run {
|
||||
/// The package whose activity is to be invoked
|
||||
#[clap(short = 'p', long = "package")]
|
||||
package: String,
|
||||
/// The activity to be invoked itself, Usually it is MainActivity
|
||||
#[clap(short = 'a', long = "activity")]
|
||||
activity: String,
|
||||
},
|
||||
/// Reboot the device
|
||||
Reboot {
|
||||
#[clap(subcommand)]
|
||||
reboot_type: RebootTypeCommand,
|
||||
},
|
||||
/// Install an APK on device
|
||||
Install {
|
||||
/// Path to APK file. Extension must be ".apk"
|
||||
path: PathBuf,
|
||||
},
|
||||
}
|
||||
@@ -6,10 +6,12 @@ mod adb_termios;
|
||||
mod commands;
|
||||
mod models;
|
||||
|
||||
use adb_client::{ADBDeviceExt, ADBEmulatorDevice, ADBServer, ADBUSBDevice, DeviceShort};
|
||||
use adb_client::{
|
||||
ADBDeviceExt, ADBEmulatorDevice, ADBServer, ADBTcpDevice, ADBUSBDevice, DeviceShort,
|
||||
};
|
||||
use anyhow::{anyhow, Result};
|
||||
use clap::Parser;
|
||||
use commands::{EmuCommand, HostCommand, LocalCommand, UsbCommands};
|
||||
use commands::{EmuCommand, HostCommand, LocalCommand, TcpCommands, UsbCommands};
|
||||
use models::{Command, Opts};
|
||||
use std::fs::File;
|
||||
use std::io::Write;
|
||||
@@ -233,6 +235,60 @@ fn main() -> Result<()> {
|
||||
}
|
||||
}
|
||||
}
|
||||
Command::Tcp(tcp) => {
|
||||
let mut device = ADBTcpDevice::new(tcp.address)?;
|
||||
|
||||
match tcp.commands {
|
||||
TcpCommands::Shell { commands } => {
|
||||
if commands.is_empty() {
|
||||
// Need to duplicate some code here as ADBTermios [Drop] implementation resets terminal state.
|
||||
// Using a scope here would call drop() too early..
|
||||
#[cfg(any(target_os = "linux", target_os = "macos"))]
|
||||
{
|
||||
let mut adb_termios = adb_termios::ADBTermios::new(std::io::stdin())?;
|
||||
adb_termios.set_adb_termios()?;
|
||||
device.shell(std::io::stdin(), std::io::stdout())?;
|
||||
}
|
||||
|
||||
#[cfg(not(any(target_os = "linux", target_os = "macos")))]
|
||||
{
|
||||
device.shell(std::io::stdin(), std::io::stdout())?;
|
||||
}
|
||||
} else {
|
||||
device.shell_command(commands, std::io::stdout())?;
|
||||
}
|
||||
}
|
||||
TcpCommands::Pull {
|
||||
source,
|
||||
destination,
|
||||
} => {
|
||||
let mut output = File::create(Path::new(&destination))?;
|
||||
device.pull(&source, &mut output)?;
|
||||
log::info!("Downloaded {source} as {destination}");
|
||||
}
|
||||
TcpCommands::Stat { path } => {
|
||||
let stat_response = device.stat(&path)?;
|
||||
println!("{}", stat_response);
|
||||
}
|
||||
TcpCommands::Reboot { reboot_type } => {
|
||||
log::info!("Reboots device in mode {:?}", reboot_type);
|
||||
device.reboot(reboot_type.into())?
|
||||
}
|
||||
TcpCommands::Push { filename, path } => {
|
||||
let mut input = File::open(Path::new(&filename))?;
|
||||
device.push(&mut input, &path)?;
|
||||
log::info!("Uploaded {filename} to {path}");
|
||||
}
|
||||
TcpCommands::Run { package, activity } => {
|
||||
let output = device.run_activity(&package, &activity)?;
|
||||
std::io::stdout().write_all(&output)?;
|
||||
}
|
||||
TcpCommands::Install { path } => {
|
||||
log::info!("Starting installation of APK {}...", path.display());
|
||||
device.install(path)?;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
Ok(())
|
||||
|
||||
@@ -2,7 +2,7 @@ use std::net::SocketAddrV4;
|
||||
|
||||
use clap::Parser;
|
||||
|
||||
use crate::commands::{EmuCommand, HostCommand, LocalCommand, UsbCommand};
|
||||
use crate::commands::{EmuCommand, HostCommand, LocalCommand, TcpCommand, UsbCommand};
|
||||
|
||||
#[derive(Parser, Debug)]
|
||||
#[clap(about, version, author)]
|
||||
@@ -27,4 +27,6 @@ pub enum Command {
|
||||
Emu(EmuCommand),
|
||||
/// Device commands via USB, no server needed
|
||||
Usb(UsbCommand),
|
||||
/// Device commands via TCP, no server needed
|
||||
Tcp(TcpCommand),
|
||||
}
|
||||
|
||||
@@ -15,15 +15,17 @@ bincode = { version = "1.3.3" }
|
||||
byteorder = { version = "1.5.0" }
|
||||
chrono = { version = "0.4.38" }
|
||||
homedir = { version = "0.3.4" }
|
||||
image = { version = "0.25.4" }
|
||||
lazy_static = { version = "1.5.0" }
|
||||
log = { version = "0.4.22" }
|
||||
image = { version = "0.25.5" }
|
||||
log = { version = "0.4.22", features = ["max_level_debug", "release_max_level_debug"]}
|
||||
num-bigint = { version = "0.8.4", package = "num-bigint-dig" }
|
||||
num-traits = { version = "0.2.19" }
|
||||
rand = { version = "0.8.5" }
|
||||
rcgen = { version = "0.13.1" }
|
||||
regex = { version = "1.11.0", features = ["perf", "std", "unicode"] }
|
||||
rsa = { version = "0.9.6" }
|
||||
rsa = { version = "0.9.7" }
|
||||
rusb = { version = "0.9.4", features = ["vendored"] }
|
||||
rustls = { version = "0.23.18" }
|
||||
rustls-pki-types = "1.10.0"
|
||||
serde = { version = "1.0.210", features = ["derive"] }
|
||||
serde_repr = { version = "0.1.19" }
|
||||
sha1 = { version = "0.10.6", features = ["oid"] }
|
||||
|
||||
@@ -31,9 +31,9 @@ let mut server = ADBServer::new(SocketAddrV4::new(server_ip, server_port));
|
||||
server.devices();
|
||||
```
|
||||
|
||||
### Using ADB server as proxy
|
||||
### Using ADB server as bridge
|
||||
|
||||
#### [TCP] Launch a command on device
|
||||
#### Launch a command on device
|
||||
|
||||
```rust no_run
|
||||
use adb_client::{ADBServer, ADBDeviceExt};
|
||||
@@ -43,7 +43,7 @@ let mut device = server.get_device().expect("cannot get device");
|
||||
device.shell_command(["df", "-h"],std::io::stdout());
|
||||
```
|
||||
|
||||
#### [TCP] Push a file to the device
|
||||
#### Push a file to the device
|
||||
|
||||
```rust no_run
|
||||
use adb_client::ADBServer;
|
||||
@@ -57,9 +57,9 @@ let mut input = File::open(Path::new("/tmp/f")).expect("Cannot open file");
|
||||
device.push(&mut input, "/data/local/tmp");
|
||||
```
|
||||
|
||||
### Interacting directly with device
|
||||
### Interact directly with end devices
|
||||
|
||||
#### [USB] Launch a command on device
|
||||
#### (USB) Launch a command on device
|
||||
|
||||
```rust no_run
|
||||
use adb_client::{ADBUSBDevice, ADBDeviceExt};
|
||||
@@ -70,7 +70,7 @@ let mut device = ADBUSBDevice::new(vendor_id, product_id).expect("cannot find de
|
||||
device.shell_command(["df", "-h"],std::io::stdout());
|
||||
```
|
||||
|
||||
#### [USB] Push a file to the device
|
||||
#### (USB) Push a file to the device
|
||||
|
||||
```rust no_run
|
||||
use adb_client::{ADBUSBDevice, ADBDeviceExt};
|
||||
@@ -83,3 +83,15 @@ let mut device = ADBUSBDevice::new(vendor_id, product_id).expect("cannot find de
|
||||
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
|
||||
|
||||
```rust no_run
|
||||
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(std::io::stdin(), std::io::stdout());
|
||||
```
|
||||
|
||||
@@ -4,30 +4,30 @@ use std::path::Path;
|
||||
use crate::models::AdbStatResponse;
|
||||
use crate::{RebootType, Result};
|
||||
|
||||
/// Trait representing all features available on both [`ADBServerDevice`] and [`ADBUSBDevice`]
|
||||
/// Trait representing all features available on devices.
|
||||
pub trait ADBDeviceExt {
|
||||
/// Runs 'command' in a shell on the device, and write its output and error streams into [`output`].
|
||||
/// Run 'command' in a shell on the device, and write its output and error streams into `output`.
|
||||
fn shell_command<S: ToString, W: Write>(
|
||||
&mut self,
|
||||
command: impl IntoIterator<Item = S>,
|
||||
output: W,
|
||||
) -> Result<()>;
|
||||
|
||||
/// Starts an interactive shell session on the device.
|
||||
/// Input data is read from [reader] and write to [writer].
|
||||
/// [W] has a 'static bound as it is internally used in a thread.
|
||||
/// Start an interactive shell session on the device.
|
||||
/// Input data is read from `reader` and write to `writer`.
|
||||
/// `W` has a 'static bound as it is internally used in a thread.
|
||||
fn shell<R: Read, W: Write + Send + 'static>(&mut self, reader: R, writer: W) -> Result<()>;
|
||||
|
||||
/// Display the stat information for a remote file
|
||||
fn stat(&mut self, remote_path: &str) -> Result<AdbStatResponse>;
|
||||
|
||||
/// Pull the remote file pointed to by [source] and write its contents into [`output`]
|
||||
/// Pull the remote file pointed to by `source` and write its contents into `output`
|
||||
fn pull<A: AsRef<str>, W: Write>(&mut self, source: A, output: W) -> Result<()>;
|
||||
|
||||
/// Push [stream] to [path] on the device.
|
||||
/// Push `stream` to `path` on the device.
|
||||
fn push<R: Read, A: AsRef<str>>(&mut self, stream: R, path: A) -> Result<()>;
|
||||
|
||||
/// Reboots the device using given reboot type
|
||||
/// Reboot the device using given reboot type
|
||||
fn reboot(&mut self, reboot_type: RebootType) -> Result<()>;
|
||||
|
||||
/// Run `activity` from `package` on device. Return the command output.
|
||||
|
||||
236
adb_client/src/device/adb_message_device.rs
Normal file
236
adb_client/src/device/adb_message_device.rs
Normal file
@@ -0,0 +1,236 @@
|
||||
use byteorder::{LittleEndian, ReadBytesExt};
|
||||
use rand::Rng;
|
||||
use std::io::{Cursor, Read, Seek};
|
||||
|
||||
use crate::{constants::BUFFER_SIZE, ADBMessageTransport, AdbStatResponse, Result, RustADBError};
|
||||
|
||||
use super::{models::MessageSubcommand, ADBTransportMessage, MessageCommand};
|
||||
|
||||
/// Generic structure representing an ADB device reachable over an [`ADBMessageTransport`].
|
||||
/// Structure is totally agnostic over which transport is truly used.
|
||||
#[derive(Debug)]
|
||||
pub struct ADBMessageDevice<T: ADBMessageTransport> {
|
||||
transport: T,
|
||||
}
|
||||
|
||||
impl<T: ADBMessageTransport> ADBMessageDevice<T> {
|
||||
/// Instantiate a new [`ADBMessageTransport`]
|
||||
pub fn new(transport: T) -> Self {
|
||||
Self { transport }
|
||||
}
|
||||
|
||||
pub(crate) fn get_transport(&mut self) -> &T {
|
||||
&self.transport
|
||||
}
|
||||
|
||||
pub(crate) fn get_transport_mut(&mut self) -> &mut T {
|
||||
&mut self.transport
|
||||
}
|
||||
|
||||
/// Receive a message and acknowledge it by replying with an `OKAY` command
|
||||
pub(crate) fn recv_and_reply_okay(
|
||||
&mut self,
|
||||
local_id: u32,
|
||||
remote_id: u32,
|
||||
) -> Result<ADBTransportMessage> {
|
||||
let message = self.transport.read_message()?;
|
||||
self.transport.write_message(ADBTransportMessage::new(
|
||||
MessageCommand::Okay,
|
||||
local_id,
|
||||
remote_id,
|
||||
"".into(),
|
||||
))?;
|
||||
Ok(message)
|
||||
}
|
||||
|
||||
/// Expect a message with an `OKAY` command after sending a message.
|
||||
pub(crate) fn send_and_expect_okay(
|
||||
&mut self,
|
||||
message: ADBTransportMessage,
|
||||
) -> Result<ADBTransportMessage> {
|
||||
self.transport.write_message(message)?;
|
||||
let message = self.transport.read_message()?;
|
||||
let received_command = message.header().command();
|
||||
if received_command != MessageCommand::Okay {
|
||||
return Err(RustADBError::ADBRequestFailed(format!(
|
||||
"expected command OKAY after message, got {}",
|
||||
received_command
|
||||
)));
|
||||
}
|
||||
Ok(message)
|
||||
}
|
||||
|
||||
pub(crate) fn recv_file<W: std::io::Write>(
|
||||
&mut self,
|
||||
local_id: u32,
|
||||
remote_id: u32,
|
||||
mut output: W,
|
||||
) -> std::result::Result<(), RustADBError> {
|
||||
let mut len: Option<u64> = None;
|
||||
loop {
|
||||
let payload = self
|
||||
.recv_and_reply_okay(local_id, remote_id)?
|
||||
.into_payload();
|
||||
let mut rdr = Cursor::new(&payload);
|
||||
while rdr.position() != payload.len() as u64 {
|
||||
match len.take() {
|
||||
Some(0) | None => {
|
||||
rdr.seek_relative(4)?;
|
||||
len.replace(rdr.read_u32::<LittleEndian>()? as u64);
|
||||
}
|
||||
Some(length) => {
|
||||
let remaining_bytes = payload.len() as u64 - rdr.position();
|
||||
if length < remaining_bytes {
|
||||
std::io::copy(&mut rdr.by_ref().take(length), &mut output)?;
|
||||
} else {
|
||||
std::io::copy(&mut rdr.take(remaining_bytes), &mut output)?;
|
||||
len.replace(length - remaining_bytes);
|
||||
// this payload is now exhausted
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
if Cursor::new(&payload[(payload.len() - 8)..(payload.len() - 4)])
|
||||
.read_u32::<LittleEndian>()?
|
||||
== MessageSubcommand::Done as u32
|
||||
{
|
||||
break;
|
||||
}
|
||||
}
|
||||
Ok(())
|
||||
}
|
||||
|
||||
pub(crate) fn push_file<R: std::io::Read>(
|
||||
&mut self,
|
||||
local_id: u32,
|
||||
remote_id: u32,
|
||||
mut reader: R,
|
||||
) -> std::result::Result<(), RustADBError> {
|
||||
let mut buffer = [0; BUFFER_SIZE];
|
||||
let amount_read = reader.read(&mut buffer)?;
|
||||
let subcommand_data = MessageSubcommand::Data.with_arg(amount_read as u32);
|
||||
|
||||
let mut serialized_message =
|
||||
bincode::serialize(&subcommand_data).map_err(|_e| RustADBError::ConversionError)?;
|
||||
serialized_message.append(&mut buffer[..amount_read].to_vec());
|
||||
|
||||
let message = ADBTransportMessage::new(
|
||||
MessageCommand::Write,
|
||||
local_id,
|
||||
remote_id,
|
||||
serialized_message,
|
||||
);
|
||||
|
||||
self.send_and_expect_okay(message)?;
|
||||
|
||||
loop {
|
||||
let mut buffer = [0; BUFFER_SIZE];
|
||||
|
||||
match reader.read(&mut buffer) {
|
||||
Ok(0) => {
|
||||
// Currently file mtime is not forwarded
|
||||
let subcommand_data = MessageSubcommand::Done.with_arg(0);
|
||||
|
||||
let serialized_message = bincode::serialize(&subcommand_data)
|
||||
.map_err(|_e| RustADBError::ConversionError)?;
|
||||
|
||||
let message = ADBTransportMessage::new(
|
||||
MessageCommand::Write,
|
||||
local_id,
|
||||
remote_id,
|
||||
serialized_message,
|
||||
);
|
||||
|
||||
self.send_and_expect_okay(message)?;
|
||||
|
||||
// Command should end with a Write => Okay
|
||||
let received = self.transport.read_message()?;
|
||||
match received.header().command() {
|
||||
MessageCommand::Write => return Ok(()),
|
||||
c => {
|
||||
return Err(RustADBError::ADBRequestFailed(format!(
|
||||
"Wrong command received {}",
|
||||
c
|
||||
)))
|
||||
}
|
||||
}
|
||||
}
|
||||
Ok(size) => {
|
||||
let subcommand_data = MessageSubcommand::Data.with_arg(size as u32);
|
||||
|
||||
let mut serialized_message = bincode::serialize(&subcommand_data)
|
||||
.map_err(|_e| RustADBError::ConversionError)?;
|
||||
serialized_message.append(&mut buffer[..size].to_vec());
|
||||
|
||||
let message = ADBTransportMessage::new(
|
||||
MessageCommand::Write,
|
||||
local_id,
|
||||
remote_id,
|
||||
serialized_message,
|
||||
);
|
||||
|
||||
self.send_and_expect_okay(message)?;
|
||||
}
|
||||
Err(e) => {
|
||||
return Err(RustADBError::IOError(e));
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
pub(crate) fn begin_synchronization(&mut self) -> Result<(u32, u32)> {
|
||||
let sync_directive = "sync:\0";
|
||||
|
||||
let mut rng = rand::thread_rng();
|
||||
let message = ADBTransportMessage::new(
|
||||
MessageCommand::Open,
|
||||
rng.gen(), /* Our 'local-id' */
|
||||
0,
|
||||
sync_directive.into(),
|
||||
);
|
||||
let message = self.send_and_expect_okay(message)?;
|
||||
let local_id = message.header().arg1();
|
||||
let remote_id = message.header().arg0();
|
||||
Ok((local_id, remote_id))
|
||||
}
|
||||
|
||||
pub(crate) fn stat_with_explicit_ids(
|
||||
&mut self,
|
||||
remote_path: &str,
|
||||
local_id: u32,
|
||||
remote_id: u32,
|
||||
) -> Result<AdbStatResponse> {
|
||||
let stat_buffer = MessageSubcommand::Stat.with_arg(remote_path.len() as u32);
|
||||
let message = ADBTransportMessage::new(
|
||||
MessageCommand::Write,
|
||||
local_id,
|
||||
remote_id,
|
||||
bincode::serialize(&stat_buffer).map_err(|_e| RustADBError::ConversionError)?,
|
||||
);
|
||||
self.send_and_expect_okay(message)?;
|
||||
self.send_and_expect_okay(ADBTransportMessage::new(
|
||||
MessageCommand::Write,
|
||||
local_id,
|
||||
remote_id,
|
||||
remote_path.into(),
|
||||
))?;
|
||||
let response = self.transport.read_message()?;
|
||||
// Skip first 4 bytes as this is the literal "STAT".
|
||||
// Interesting part starts right after
|
||||
bincode::deserialize(&response.into_payload()[4..])
|
||||
.map_err(|_e| RustADBError::ConversionError)
|
||||
}
|
||||
|
||||
pub(crate) fn end_transaction(&mut self, local_id: u32, remote_id: u32) -> Result<()> {
|
||||
let quit_buffer = MessageSubcommand::Quit.with_arg(0u32);
|
||||
self.send_and_expect_okay(ADBTransportMessage::new(
|
||||
MessageCommand::Write,
|
||||
local_id,
|
||||
remote_id,
|
||||
bincode::serialize(&quit_buffer).map_err(|_e| RustADBError::ConversionError)?,
|
||||
))?;
|
||||
let _discard_close = self.transport.read_message()?;
|
||||
Ok(())
|
||||
}
|
||||
}
|
||||
38
adb_client/src/device/adb_message_device_commands.rs
Normal file
38
adb_client/src/device/adb_message_device_commands.rs
Normal file
@@ -0,0 +1,38 @@
|
||||
use crate::{models::AdbStatResponse, ADBDeviceExt, ADBMessageTransport, RebootType, Result};
|
||||
use std::io::{Read, Write};
|
||||
|
||||
use super::ADBMessageDevice;
|
||||
|
||||
impl<T: ADBMessageTransport> ADBDeviceExt for ADBMessageDevice<T> {
|
||||
fn shell_command<S: ToString, W: Write>(
|
||||
&mut self,
|
||||
command: impl IntoIterator<Item = S>,
|
||||
output: W,
|
||||
) -> Result<()> {
|
||||
self.shell_command(command, output)
|
||||
}
|
||||
|
||||
fn shell<R: Read, W: Write + Send + 'static>(&mut self, reader: R, writer: W) -> Result<()> {
|
||||
self.shell(reader, writer)
|
||||
}
|
||||
|
||||
fn stat(&mut self, remote_path: &str) -> Result<AdbStatResponse> {
|
||||
self.stat(remote_path)
|
||||
}
|
||||
|
||||
fn pull<A: AsRef<str>, W: Write>(&mut self, source: A, output: W) -> Result<()> {
|
||||
self.pull(source, output)
|
||||
}
|
||||
|
||||
fn push<R: Read, A: AsRef<str>>(&mut self, stream: R, path: A) -> Result<()> {
|
||||
self.push(stream, path)
|
||||
}
|
||||
|
||||
fn reboot(&mut self, reboot_type: RebootType) -> Result<()> {
|
||||
self.reboot(reboot_type)
|
||||
}
|
||||
|
||||
fn install<P: AsRef<std::path::Path>>(&mut self, apk_path: P) -> Result<()> {
|
||||
self.install(apk_path)
|
||||
}
|
||||
}
|
||||
112
adb_client/src/device/adb_tcp_device.rs
Normal file
112
adb_client/src/device/adb_tcp_device.rs
Normal file
@@ -0,0 +1,112 @@
|
||||
use std::net::SocketAddr;
|
||||
use std::path::Path;
|
||||
|
||||
use super::adb_message_device::ADBMessageDevice;
|
||||
use super::models::MessageCommand;
|
||||
use super::ADBTransportMessage;
|
||||
use crate::{ADBDeviceExt, ADBMessageTransport, ADBTransport, Result, RustADBError, TcpTransport};
|
||||
|
||||
/// Represent a device reached and available over USB.
|
||||
#[derive(Debug)]
|
||||
pub struct ADBTcpDevice {
|
||||
inner: ADBMessageDevice<TcpTransport>,
|
||||
}
|
||||
|
||||
impl ADBTcpDevice {
|
||||
/// Instantiate a new [`ADBTcpDevice`]
|
||||
pub fn new(address: SocketAddr) -> Result<Self> {
|
||||
let mut device = Self {
|
||||
inner: ADBMessageDevice::new(TcpTransport::new(address)?),
|
||||
};
|
||||
|
||||
device.connect()?;
|
||||
|
||||
Ok(device)
|
||||
}
|
||||
|
||||
/// Send initial connect
|
||||
pub fn connect(&mut self) -> Result<()> {
|
||||
self.get_transport_mut().connect()?;
|
||||
|
||||
let message = ADBTransportMessage::new(
|
||||
MessageCommand::Cnxn,
|
||||
0x01000000,
|
||||
1048576,
|
||||
format!("host::{}\0", env!("CARGO_PKG_NAME"))
|
||||
.as_bytes()
|
||||
.to_vec(),
|
||||
);
|
||||
|
||||
self.get_transport_mut().write_message(message)?;
|
||||
|
||||
let message = self.get_transport_mut().read_message()?;
|
||||
|
||||
// At this point, we should have received a STLS message
|
||||
if message.header().command() != MessageCommand::Stls {
|
||||
return Err(RustADBError::ADBRequestFailed(format!(
|
||||
"Wrong command received {}",
|
||||
message.header().command()
|
||||
)));
|
||||
};
|
||||
|
||||
let message = ADBTransportMessage::new(MessageCommand::Stls, 1, 0, vec![]);
|
||||
|
||||
self.get_transport_mut().write_message(message)?;
|
||||
|
||||
// Upgrade TCP connection to TLS
|
||||
self.get_transport_mut().upgrade_connection()?;
|
||||
|
||||
log::debug!("Connection successfully upgraded from TCP to TLS");
|
||||
|
||||
Ok(())
|
||||
}
|
||||
|
||||
fn get_transport_mut(&mut self) -> &mut TcpTransport {
|
||||
self.inner.get_transport_mut()
|
||||
}
|
||||
}
|
||||
|
||||
impl ADBDeviceExt for ADBTcpDevice {
|
||||
fn shell_command<S: ToString, W: std::io::Write>(
|
||||
&mut self,
|
||||
command: impl IntoIterator<Item = S>,
|
||||
output: W,
|
||||
) -> Result<()> {
|
||||
self.inner.shell_command(command, output)
|
||||
}
|
||||
|
||||
fn shell<R: std::io::Read, W: std::io::Write + Send + 'static>(
|
||||
&mut self,
|
||||
reader: R,
|
||||
writer: W,
|
||||
) -> Result<()> {
|
||||
self.inner.shell(reader, writer)
|
||||
}
|
||||
|
||||
fn stat(&mut self, remote_path: &str) -> Result<crate::AdbStatResponse> {
|
||||
self.inner.stat(remote_path)
|
||||
}
|
||||
|
||||
fn pull<A: AsRef<str>, W: std::io::Write>(&mut self, source: A, output: W) -> Result<()> {
|
||||
self.inner.pull(source, output)
|
||||
}
|
||||
|
||||
fn push<R: std::io::Read, A: AsRef<str>>(&mut self, stream: R, path: A) -> Result<()> {
|
||||
self.inner.push(stream, path)
|
||||
}
|
||||
|
||||
fn reboot(&mut self, reboot_type: crate::RebootType) -> Result<()> {
|
||||
self.inner.reboot(reboot_type)
|
||||
}
|
||||
|
||||
fn install<P: AsRef<Path>>(&mut self, apk_path: P) -> Result<()> {
|
||||
self.inner.install(apk_path)
|
||||
}
|
||||
}
|
||||
|
||||
impl Drop for ADBTcpDevice {
|
||||
fn drop(&mut self) {
|
||||
// Best effort here
|
||||
let _ = self.get_transport_mut().disconnect();
|
||||
}
|
||||
}
|
||||
@@ -1,31 +1,32 @@
|
||||
use serde::{Deserialize, Serialize};
|
||||
|
||||
use super::usb_commands::USBCommand;
|
||||
use crate::RustADBError;
|
||||
|
||||
use super::models::MessageCommand;
|
||||
|
||||
pub const AUTH_TOKEN: u32 = 1;
|
||||
pub const AUTH_SIGNATURE: u32 = 2;
|
||||
pub const AUTH_RSAPUBLICKEY: u32 = 3;
|
||||
|
||||
#[derive(Debug)]
|
||||
pub struct ADBUsbMessage {
|
||||
header: ADBUsbMessageHeader,
|
||||
pub struct ADBTransportMessage {
|
||||
header: ADBTransportMessageHeader,
|
||||
payload: Vec<u8>,
|
||||
}
|
||||
|
||||
#[derive(Debug, Serialize, Deserialize)]
|
||||
#[repr(C)]
|
||||
pub struct ADBUsbMessageHeader {
|
||||
command: USBCommand, /* command identifier constant */
|
||||
arg0: u32, /* first argument */
|
||||
arg1: u32, /* second argument */
|
||||
data_length: u32, /* length of payload (0 is allowed) */
|
||||
data_crc32: u32, /* crc32 of data payload */
|
||||
magic: u32, /* command ^ 0xffffffff */
|
||||
pub struct ADBTransportMessageHeader {
|
||||
command: MessageCommand, /* command identifier constant */
|
||||
arg0: u32, /* first argument */
|
||||
arg1: u32, /* second argument */
|
||||
data_length: u32, /* length of payload (0 is allowed) */
|
||||
data_crc32: u32, /* crc32 of data payload */
|
||||
magic: u32, /* command ^ 0xffffffff */
|
||||
}
|
||||
|
||||
impl ADBUsbMessageHeader {
|
||||
pub fn new(command: USBCommand, arg0: u32, arg1: u32, data: &[u8]) -> Self {
|
||||
impl ADBTransportMessageHeader {
|
||||
pub fn new(command: MessageCommand, arg0: u32, arg1: u32, data: &[u8]) -> Self {
|
||||
Self {
|
||||
command,
|
||||
arg0,
|
||||
@@ -36,7 +37,7 @@ impl ADBUsbMessageHeader {
|
||||
}
|
||||
}
|
||||
|
||||
pub fn command(&self) -> USBCommand {
|
||||
pub fn command(&self) -> MessageCommand {
|
||||
self.command
|
||||
}
|
||||
|
||||
@@ -60,7 +61,7 @@ impl ADBUsbMessageHeader {
|
||||
data.iter().map(|&x| x as u32).sum()
|
||||
}
|
||||
|
||||
fn compute_magic(command: USBCommand) -> u32 {
|
||||
fn compute_magic(command: MessageCommand) -> u32 {
|
||||
let command_u32 = command as u32;
|
||||
command_u32 ^ 0xFFFFFFFF
|
||||
}
|
||||
@@ -70,24 +71,24 @@ impl ADBUsbMessageHeader {
|
||||
}
|
||||
}
|
||||
|
||||
impl ADBUsbMessage {
|
||||
pub fn new(command: USBCommand, arg0: u32, arg1: u32, data: Vec<u8>) -> Self {
|
||||
impl ADBTransportMessage {
|
||||
pub fn new(command: MessageCommand, arg0: u32, arg1: u32, data: Vec<u8>) -> Self {
|
||||
Self {
|
||||
header: ADBUsbMessageHeader::new(command, arg0, arg1, &data),
|
||||
header: ADBTransportMessageHeader::new(command, arg0, arg1, &data),
|
||||
payload: data,
|
||||
}
|
||||
}
|
||||
|
||||
pub fn from_header_and_payload(header: ADBUsbMessageHeader, payload: Vec<u8>) -> Self {
|
||||
pub fn from_header_and_payload(header: ADBTransportMessageHeader, payload: Vec<u8>) -> Self {
|
||||
Self { header, payload }
|
||||
}
|
||||
|
||||
pub fn check_message_integrity(&self) -> bool {
|
||||
ADBUsbMessageHeader::compute_magic(self.header.command) == self.header.magic
|
||||
&& ADBUsbMessageHeader::compute_crc32(&self.payload) == self.header.data_crc32
|
||||
ADBTransportMessageHeader::compute_magic(self.header.command) == self.header.magic
|
||||
&& ADBTransportMessageHeader::compute_crc32(&self.payload) == self.header.data_crc32
|
||||
}
|
||||
|
||||
pub fn header(&self) -> &ADBUsbMessageHeader {
|
||||
pub fn header(&self) -> &ADBTransportMessageHeader {
|
||||
&self.header
|
||||
}
|
||||
|
||||
@@ -100,7 +101,7 @@ impl ADBUsbMessage {
|
||||
}
|
||||
}
|
||||
|
||||
impl TryFrom<[u8; 24]> for ADBUsbMessageHeader {
|
||||
impl TryFrom<[u8; 24]> for ADBTransportMessageHeader {
|
||||
type Error = RustADBError;
|
||||
|
||||
fn try_from(value: [u8; 24]) -> Result<Self, Self::Error> {
|
||||
274
adb_client/src/device/adb_usb_device.rs
Normal file
274
adb_client/src/device/adb_usb_device.rs
Normal file
@@ -0,0 +1,274 @@
|
||||
use rusb::Device;
|
||||
use rusb::DeviceDescriptor;
|
||||
use rusb::UsbContext;
|
||||
use std::fs::read_to_string;
|
||||
use std::path::Path;
|
||||
use std::path::PathBuf;
|
||||
use std::time::Duration;
|
||||
|
||||
use super::adb_message_device::ADBMessageDevice;
|
||||
use super::models::MessageCommand;
|
||||
use super::{ADBRsaKey, ADBTransportMessage};
|
||||
use crate::device::adb_transport_message::{AUTH_RSAPUBLICKEY, AUTH_SIGNATURE, AUTH_TOKEN};
|
||||
use crate::ADBDeviceExt;
|
||||
use crate::ADBMessageTransport;
|
||||
use crate::ADBTransport;
|
||||
use crate::{Result, RustADBError, USBTransport};
|
||||
|
||||
/// Represent a device reached and available over USB.
|
||||
#[derive(Debug)]
|
||||
pub struct ADBUSBDevice {
|
||||
private_key: ADBRsaKey,
|
||||
inner: ADBMessageDevice<USBTransport>,
|
||||
}
|
||||
|
||||
pub fn read_adb_private_key<P: AsRef<Path>>(private_key_path: P) -> Result<Option<ADBRsaKey>> {
|
||||
Ok(read_to_string(private_key_path.as_ref()).map(|pk| {
|
||||
match ADBRsaKey::new_from_pkcs8(&pk) {
|
||||
Ok(pk) => Some(pk),
|
||||
Err(e) => {
|
||||
log::error!("Error while create RSA private key: {e}");
|
||||
None
|
||||
}
|
||||
}
|
||||
})?)
|
||||
}
|
||||
|
||||
/// Search for adb devices with known interface class and subclass values
|
||||
fn search_adb_devices() -> Result<Option<(u16, u16)>> {
|
||||
let mut found_devices = vec![];
|
||||
for device in rusb::devices()?.iter() {
|
||||
let Ok(des) = device.device_descriptor() else {
|
||||
continue;
|
||||
};
|
||||
if is_adb_device(&device, &des) {
|
||||
log::debug!(
|
||||
"Autodetect device {:04x}:{:04x}",
|
||||
des.vendor_id(),
|
||||
des.product_id()
|
||||
);
|
||||
found_devices.push((des.vendor_id(), des.product_id()));
|
||||
}
|
||||
}
|
||||
|
||||
match (found_devices.first(), found_devices.get(1)) {
|
||||
(None, _) => Ok(None),
|
||||
(Some(identifiers), None) => Ok(Some(*identifiers)),
|
||||
(Some((vid1, pid1)), Some((vid2, pid2))) => Err(RustADBError::DeviceNotFound(format!(
|
||||
"Found two Android devices {:04x}:{:04x} and {:04x}:{:04x}",
|
||||
vid1, pid1, vid2, pid2
|
||||
))),
|
||||
}
|
||||
}
|
||||
|
||||
fn is_adb_device<T: UsbContext>(device: &Device<T>, des: &DeviceDescriptor) -> bool {
|
||||
const ADB_CLASS: u8 = 0xff;
|
||||
|
||||
const ADB_SUBCLASS: u8 = 0x42;
|
||||
const ADB_PROTOCOL: u8 = 0x1;
|
||||
|
||||
// Some devices require choosing the file transfer mode
|
||||
// for usb debugging to take effect.
|
||||
const BULK_CLASS: u8 = 0xdc;
|
||||
const BULK_ADB_SUBCLASS: u8 = 2;
|
||||
|
||||
for n in 0..des.num_configurations() {
|
||||
let Ok(config_des) = device.config_descriptor(n) else {
|
||||
continue;
|
||||
};
|
||||
for interface in config_des.interfaces() {
|
||||
for interface_des in interface.descriptors() {
|
||||
let proto = interface_des.protocol_code();
|
||||
let class = interface_des.class_code();
|
||||
let subcl = interface_des.sub_class_code();
|
||||
if proto == ADB_PROTOCOL
|
||||
&& ((class == ADB_CLASS && subcl == ADB_SUBCLASS)
|
||||
|| (class == BULK_CLASS && subcl == BULK_ADB_SUBCLASS))
|
||||
{
|
||||
return true;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
false
|
||||
}
|
||||
|
||||
pub fn get_default_adb_key_path() -> Result<PathBuf> {
|
||||
homedir::my_home()
|
||||
.ok()
|
||||
.flatten()
|
||||
.map(|home| home.join(".android").join("adbkey"))
|
||||
.ok_or(RustADBError::NoHomeDirectory)
|
||||
}
|
||||
|
||||
impl ADBUSBDevice {
|
||||
/// Instantiate a new [`ADBUSBDevice`]
|
||||
pub fn new(vendor_id: u16, product_id: u16) -> Result<Self> {
|
||||
Self::new_with_custom_private_key(vendor_id, product_id, get_default_adb_key_path()?)
|
||||
}
|
||||
|
||||
/// Instantiate a new [`ADBUSBDevice`] using a custom private key path
|
||||
pub fn new_with_custom_private_key(
|
||||
vendor_id: u16,
|
||||
product_id: u16,
|
||||
private_key_path: PathBuf,
|
||||
) -> Result<Self> {
|
||||
let private_key = match read_adb_private_key(private_key_path)? {
|
||||
Some(pk) => pk,
|
||||
None => ADBRsaKey::new_random()?,
|
||||
};
|
||||
|
||||
let mut s = Self {
|
||||
private_key,
|
||||
inner: ADBMessageDevice::new(USBTransport::new(vendor_id, product_id)),
|
||||
};
|
||||
|
||||
s.connect()?;
|
||||
|
||||
Ok(s)
|
||||
}
|
||||
|
||||
/// autodetect connected ADB devices and establish a connection with the first device found
|
||||
pub fn autodetect() -> Result<Self> {
|
||||
Self::autodetect_with_custom_private_key(get_default_adb_key_path()?)
|
||||
}
|
||||
|
||||
/// autodetect connected ADB devices and establish a connection with the first device found using a custom private key path
|
||||
pub fn autodetect_with_custom_private_key(private_key_path: PathBuf) -> Result<Self> {
|
||||
match search_adb_devices()? {
|
||||
Some((vendor_id, product_id)) => {
|
||||
ADBUSBDevice::new_with_custom_private_key(vendor_id, product_id, private_key_path)
|
||||
}
|
||||
_ => Err(RustADBError::DeviceNotFound(
|
||||
"cannot find USB devices matching the signature of an ADB device".into(),
|
||||
)),
|
||||
}
|
||||
}
|
||||
|
||||
/// Send initial connect
|
||||
pub fn connect(&mut self) -> Result<()> {
|
||||
self.get_transport_mut().connect()?;
|
||||
|
||||
let message = ADBTransportMessage::new(
|
||||
MessageCommand::Cnxn,
|
||||
0x01000000,
|
||||
1048576,
|
||||
format!("host::{}\0", env!("CARGO_PKG_NAME"))
|
||||
.as_bytes()
|
||||
.to_vec(),
|
||||
);
|
||||
|
||||
self.get_transport_mut().write_message(message)?;
|
||||
|
||||
let message = self.get_transport_mut().read_message()?;
|
||||
|
||||
// At this point, we should have received either:
|
||||
// - an AUTH message with arg0 == 1
|
||||
// - a CNXN message
|
||||
let auth_message = match message.header().command() {
|
||||
MessageCommand::Auth if message.header().arg0() == AUTH_TOKEN => message,
|
||||
MessageCommand::Auth if message.header().arg0() != AUTH_TOKEN => {
|
||||
return Err(RustADBError::ADBRequestFailed(
|
||||
"Received AUTH message with type != 1".into(),
|
||||
))
|
||||
}
|
||||
c => {
|
||||
return Err(RustADBError::ADBRequestFailed(format!(
|
||||
"Wrong command received {}",
|
||||
c
|
||||
)))
|
||||
}
|
||||
};
|
||||
|
||||
let sign = self.private_key.sign(auth_message.into_payload())?;
|
||||
|
||||
let message = ADBTransportMessage::new(MessageCommand::Auth, AUTH_SIGNATURE, 0, sign);
|
||||
|
||||
self.get_transport_mut().write_message(message)?;
|
||||
|
||||
let received_response = self.get_transport_mut().read_message()?;
|
||||
|
||||
if received_response.header().command() == MessageCommand::Cnxn {
|
||||
log::info!(
|
||||
"Authentication OK, device info {}",
|
||||
String::from_utf8(received_response.into_payload())?
|
||||
);
|
||||
return Ok(());
|
||||
}
|
||||
|
||||
let mut pubkey = self.private_key.android_pubkey_encode()?.into_bytes();
|
||||
pubkey.push(b'\0');
|
||||
|
||||
let message = ADBTransportMessage::new(MessageCommand::Auth, AUTH_RSAPUBLICKEY, 0, pubkey);
|
||||
|
||||
self.get_transport_mut().write_message(message)?;
|
||||
|
||||
let response = self
|
||||
.get_transport_mut()
|
||||
.read_message_with_timeout(Duration::from_secs(10))?;
|
||||
|
||||
match response.header().command() {
|
||||
MessageCommand::Cnxn => log::info!(
|
||||
"Authentication OK, device info {}",
|
||||
String::from_utf8(response.into_payload())?
|
||||
),
|
||||
_ => {
|
||||
return Err(RustADBError::ADBRequestFailed(format!(
|
||||
"wrong response {}",
|
||||
response.header().command()
|
||||
)))
|
||||
}
|
||||
}
|
||||
|
||||
Ok(())
|
||||
}
|
||||
|
||||
fn get_transport_mut(&mut self) -> &mut USBTransport {
|
||||
self.inner.get_transport_mut()
|
||||
}
|
||||
}
|
||||
|
||||
impl ADBDeviceExt for ADBUSBDevice {
|
||||
fn shell_command<S: ToString, W: std::io::Write>(
|
||||
&mut self,
|
||||
command: impl IntoIterator<Item = S>,
|
||||
output: W,
|
||||
) -> Result<()> {
|
||||
self.inner.shell_command(command, output)
|
||||
}
|
||||
|
||||
fn shell<R: std::io::Read, W: std::io::Write + Send + 'static>(
|
||||
&mut self,
|
||||
reader: R,
|
||||
writer: W,
|
||||
) -> Result<()> {
|
||||
self.inner.shell(reader, writer)
|
||||
}
|
||||
|
||||
fn stat(&mut self, remote_path: &str) -> Result<crate::AdbStatResponse> {
|
||||
self.inner.stat(remote_path)
|
||||
}
|
||||
|
||||
fn pull<A: AsRef<str>, W: std::io::Write>(&mut self, source: A, output: W) -> Result<()> {
|
||||
self.inner.pull(source, output)
|
||||
}
|
||||
|
||||
fn push<R: std::io::Read, A: AsRef<str>>(&mut self, stream: R, path: A) -> Result<()> {
|
||||
self.inner.push(stream, path)
|
||||
}
|
||||
|
||||
fn reboot(&mut self, reboot_type: crate::RebootType) -> Result<()> {
|
||||
self.inner.reboot(reboot_type)
|
||||
}
|
||||
|
||||
fn install<P: AsRef<Path>>(&mut self, apk_path: P) -> Result<()> {
|
||||
self.inner.install(apk_path)
|
||||
}
|
||||
}
|
||||
|
||||
impl Drop for ADBUSBDevice {
|
||||
fn drop(&mut self) {
|
||||
// Best effort here
|
||||
let _ = self.get_transport_mut().disconnect();
|
||||
}
|
||||
}
|
||||
59
adb_client/src/device/commands/install.rs
Normal file
59
adb_client/src/device/commands/install.rs
Normal file
@@ -0,0 +1,59 @@
|
||||
use std::fs::File;
|
||||
|
||||
use rand::Rng;
|
||||
|
||||
use crate::{
|
||||
device::{
|
||||
adb_message_device::ADBMessageDevice, ADBTransportMessage, MessageCommand, MessageWriter,
|
||||
},
|
||||
utils::check_extension_is_apk,
|
||||
ADBMessageTransport, Result,
|
||||
};
|
||||
|
||||
impl<T: ADBMessageTransport> ADBMessageDevice<T> {
|
||||
pub(crate) fn install<P: AsRef<std::path::Path>>(&mut self, apk_path: P) -> Result<()> {
|
||||
let mut apk_file = File::open(&apk_path)?;
|
||||
|
||||
check_extension_is_apk(&apk_path)?;
|
||||
|
||||
let file_size = apk_file.metadata()?.len();
|
||||
|
||||
let mut rng = rand::thread_rng();
|
||||
|
||||
let local_id = rng.gen();
|
||||
|
||||
let message = ADBTransportMessage::new(
|
||||
MessageCommand::Open,
|
||||
local_id,
|
||||
0,
|
||||
format!("exec:cmd package 'install' -S {}\0", file_size)
|
||||
.as_bytes()
|
||||
.to_vec(),
|
||||
);
|
||||
self.get_transport_mut().write_message(message)?;
|
||||
|
||||
let response = self.get_transport_mut().read_message()?;
|
||||
let remote_id = response.header().arg0();
|
||||
|
||||
let transport = self.get_transport().clone();
|
||||
|
||||
let mut writer = MessageWriter::new(transport, local_id, remote_id);
|
||||
|
||||
std::io::copy(&mut apk_file, &mut writer)?;
|
||||
|
||||
let final_status = self.get_transport_mut().read_message()?;
|
||||
|
||||
match final_status.into_payload().as_slice() {
|
||||
b"Success\n" => {
|
||||
log::info!(
|
||||
"APK file {} successfully installed",
|
||||
apk_path.as_ref().display()
|
||||
);
|
||||
Ok(())
|
||||
}
|
||||
d => Err(crate::RustADBError::ADBRequestFailed(String::from_utf8(
|
||||
d.to_vec(),
|
||||
)?)),
|
||||
}
|
||||
}
|
||||
}
|
||||
6
adb_client/src/device/commands/mod.rs
Normal file
6
adb_client/src/device/commands/mod.rs
Normal file
@@ -0,0 +1,6 @@
|
||||
mod install;
|
||||
mod pull;
|
||||
mod push;
|
||||
mod reboot;
|
||||
mod shell;
|
||||
mod stat;
|
||||
49
adb_client/src/device/commands/pull.rs
Normal file
49
adb_client/src/device/commands/pull.rs
Normal file
@@ -0,0 +1,49 @@
|
||||
use std::io::Write;
|
||||
|
||||
use crate::{
|
||||
device::{
|
||||
adb_message_device::ADBMessageDevice, models::MessageSubcommand, ADBTransportMessage,
|
||||
MessageCommand,
|
||||
},
|
||||
ADBMessageTransport, Result, RustADBError,
|
||||
};
|
||||
|
||||
impl<T: ADBMessageTransport> ADBMessageDevice<T> {
|
||||
pub(crate) fn pull<A: AsRef<str>, W: Write>(&mut self, source: A, output: W) -> Result<()> {
|
||||
let (local_id, remote_id) = self.begin_synchronization()?;
|
||||
let source = source.as_ref();
|
||||
|
||||
let adb_stat_response = self.stat_with_explicit_ids(source, local_id, remote_id)?;
|
||||
|
||||
if adb_stat_response.file_perm == 0 {
|
||||
return Err(RustADBError::UnknownResponseType(
|
||||
"mode is 0: source file does not exist".to_string(),
|
||||
));
|
||||
}
|
||||
|
||||
self.get_transport_mut().write_message_with_timeout(
|
||||
ADBTransportMessage::new(MessageCommand::Okay, local_id, remote_id, "".into()),
|
||||
std::time::Duration::from_secs(4),
|
||||
)?;
|
||||
|
||||
let recv_buffer = MessageSubcommand::Recv.with_arg(source.len() as u32);
|
||||
let recv_buffer =
|
||||
bincode::serialize(&recv_buffer).map_err(|_e| RustADBError::ConversionError)?;
|
||||
self.send_and_expect_okay(ADBTransportMessage::new(
|
||||
MessageCommand::Write,
|
||||
local_id,
|
||||
remote_id,
|
||||
recv_buffer,
|
||||
))?;
|
||||
self.send_and_expect_okay(ADBTransportMessage::new(
|
||||
MessageCommand::Write,
|
||||
local_id,
|
||||
remote_id,
|
||||
source.into(),
|
||||
))?;
|
||||
|
||||
self.recv_file(local_id, remote_id, output)?;
|
||||
self.end_transaction(local_id, remote_id)?;
|
||||
Ok(())
|
||||
}
|
||||
}
|
||||
35
adb_client/src/device/commands/push.rs
Normal file
35
adb_client/src/device/commands/push.rs
Normal file
@@ -0,0 +1,35 @@
|
||||
use std::io::Read;
|
||||
|
||||
use crate::{
|
||||
device::{
|
||||
adb_message_device::ADBMessageDevice, ADBTransportMessage, MessageCommand,
|
||||
MessageSubcommand,
|
||||
},
|
||||
ADBMessageTransport, Result, RustADBError,
|
||||
};
|
||||
|
||||
impl<T: ADBMessageTransport> ADBMessageDevice<T> {
|
||||
pub(crate) fn push<R: Read, A: AsRef<str>>(&mut self, stream: R, path: A) -> Result<()> {
|
||||
let (local_id, remote_id) = self.begin_synchronization()?;
|
||||
|
||||
let path_header = format!("{},0777", path.as_ref());
|
||||
|
||||
let send_buffer = MessageSubcommand::Send.with_arg(path_header.len() as u32);
|
||||
let mut send_buffer =
|
||||
bincode::serialize(&send_buffer).map_err(|_e| RustADBError::ConversionError)?;
|
||||
send_buffer.append(&mut path_header.as_bytes().to_vec());
|
||||
|
||||
self.send_and_expect_okay(ADBTransportMessage::new(
|
||||
MessageCommand::Write,
|
||||
local_id,
|
||||
remote_id,
|
||||
send_buffer,
|
||||
))?;
|
||||
|
||||
self.push_file(local_id, remote_id, stream)?;
|
||||
|
||||
self.end_transaction(local_id, remote_id)?;
|
||||
|
||||
Ok(())
|
||||
}
|
||||
}
|
||||
28
adb_client/src/device/commands/reboot.rs
Normal file
28
adb_client/src/device/commands/reboot.rs
Normal file
@@ -0,0 +1,28 @@
|
||||
use rand::Rng;
|
||||
|
||||
use crate::{
|
||||
device::{adb_message_device::ADBMessageDevice, ADBTransportMessage, MessageCommand},
|
||||
ADBMessageTransport, RebootType, Result, RustADBError,
|
||||
};
|
||||
|
||||
impl<T: ADBMessageTransport> ADBMessageDevice<T> {
|
||||
pub(crate) fn reboot(&mut self, reboot_type: RebootType) -> Result<()> {
|
||||
let mut rng = rand::thread_rng();
|
||||
|
||||
let message = ADBTransportMessage::new(
|
||||
MessageCommand::Open,
|
||||
rng.gen(), // Our 'local-id'
|
||||
0,
|
||||
format!("reboot:{}\0", reboot_type).as_bytes().to_vec(),
|
||||
);
|
||||
self.get_transport_mut().write_message(message)?;
|
||||
|
||||
let message = self.get_transport_mut().read_message()?;
|
||||
|
||||
if message.header().command() != MessageCommand::Okay {
|
||||
return Err(RustADBError::ADBShellNotSupported);
|
||||
}
|
||||
|
||||
Ok(())
|
||||
}
|
||||
}
|
||||
112
adb_client/src/device/commands/shell.rs
Normal file
112
adb_client/src/device/commands/shell.rs
Normal file
@@ -0,0 +1,112 @@
|
||||
use rand::Rng;
|
||||
use std::io::{Read, Write};
|
||||
|
||||
use crate::device::ShellMessageWriter;
|
||||
use crate::Result;
|
||||
use crate::{
|
||||
device::{ADBMessageDevice, ADBTransportMessage, MessageCommand},
|
||||
ADBMessageTransport, RustADBError,
|
||||
};
|
||||
|
||||
impl<T: ADBMessageTransport> ADBMessageDevice<T> {
|
||||
/// Runs 'command' in a shell on the device, and write its output and error streams into [`output`].
|
||||
pub(crate) fn shell_command<S: ToString, W: Write>(
|
||||
&mut self,
|
||||
command: impl IntoIterator<Item = S>,
|
||||
mut output: W,
|
||||
) -> Result<()> {
|
||||
let message = ADBTransportMessage::new(
|
||||
MessageCommand::Open,
|
||||
1,
|
||||
0,
|
||||
format!(
|
||||
"shell:{}\0",
|
||||
command
|
||||
.into_iter()
|
||||
.map(|v| v.to_string())
|
||||
.collect::<Vec<_>>()
|
||||
.join(" "),
|
||||
)
|
||||
.as_bytes()
|
||||
.to_vec(),
|
||||
);
|
||||
self.get_transport_mut().write_message(message)?;
|
||||
|
||||
let response = self.get_transport_mut().read_message()?;
|
||||
if response.header().command() != MessageCommand::Okay {
|
||||
return Err(RustADBError::ADBRequestFailed(format!(
|
||||
"wrong command {}",
|
||||
response.header().command()
|
||||
)));
|
||||
}
|
||||
|
||||
loop {
|
||||
let response = self.get_transport_mut().read_message()?;
|
||||
if response.header().command() != MessageCommand::Write {
|
||||
break;
|
||||
}
|
||||
|
||||
output.write_all(&response.into_payload())?;
|
||||
}
|
||||
|
||||
Ok(())
|
||||
}
|
||||
|
||||
/// Starts an interactive shell session on the device.
|
||||
/// Input data is read from [reader] and write to [writer].
|
||||
/// [W] has a 'static bound as it is internally used in a thread.
|
||||
pub(crate) fn shell<R: Read, W: Write + Send + 'static>(
|
||||
&mut self,
|
||||
mut reader: R,
|
||||
mut writer: W,
|
||||
) -> Result<()> {
|
||||
let sync_directive = "shell:\0";
|
||||
|
||||
let mut rng = rand::thread_rng();
|
||||
let message = ADBTransportMessage::new(
|
||||
MessageCommand::Open,
|
||||
rng.gen(), /* Our 'local-id' */
|
||||
0,
|
||||
sync_directive.into(),
|
||||
);
|
||||
let message = self.send_and_expect_okay(message)?;
|
||||
let local_id = message.header().arg1();
|
||||
let remote_id = message.header().arg0();
|
||||
|
||||
let mut transport = self.get_transport().clone();
|
||||
|
||||
// Reading thread, reads response from adbd
|
||||
std::thread::spawn(move || -> Result<()> {
|
||||
loop {
|
||||
let message = transport.read_message()?;
|
||||
|
||||
// Acknowledge for more data
|
||||
let response =
|
||||
ADBTransportMessage::new(MessageCommand::Okay, local_id, remote_id, vec![]);
|
||||
transport.write_message(response)?;
|
||||
|
||||
match message.header().command() {
|
||||
MessageCommand::Write => {}
|
||||
MessageCommand::Okay => continue,
|
||||
_ => return Err(RustADBError::ADBShellNotSupported),
|
||||
}
|
||||
|
||||
writer.write_all(&message.into_payload())?;
|
||||
writer.flush()?;
|
||||
}
|
||||
});
|
||||
|
||||
let transport = self.get_transport().clone();
|
||||
let mut shell_writer = ShellMessageWriter::new(transport, local_id, remote_id);
|
||||
|
||||
// Read from given reader (that could be stdin e.g), and write content to device adbd
|
||||
if let Err(e) = std::io::copy(&mut reader, &mut shell_writer) {
|
||||
match e.kind() {
|
||||
std::io::ErrorKind::BrokenPipe => return Ok(()),
|
||||
_ => return Err(RustADBError::IOError(e)),
|
||||
}
|
||||
}
|
||||
|
||||
Ok(())
|
||||
}
|
||||
}
|
||||
12
adb_client/src/device/commands/stat.rs
Normal file
12
adb_client/src/device/commands/stat.rs
Normal file
@@ -0,0 +1,12 @@
|
||||
use crate::{
|
||||
device::adb_message_device::ADBMessageDevice, ADBMessageTransport, AdbStatResponse, Result,
|
||||
};
|
||||
|
||||
impl<T: ADBMessageTransport> ADBMessageDevice<T> {
|
||||
pub(crate) fn stat(&mut self, remote_path: &str) -> Result<AdbStatResponse> {
|
||||
let (local_id, remote_id) = self.begin_synchronization()?;
|
||||
let adb_stat_response = self.stat_with_explicit_ids(remote_path, local_id, remote_id)?;
|
||||
self.end_transaction(local_id, remote_id)?;
|
||||
Ok(adb_stat_response)
|
||||
}
|
||||
}
|
||||
@@ -1,20 +1,20 @@
|
||||
use std::io::{ErrorKind, Write};
|
||||
|
||||
use crate::USBTransport;
|
||||
use crate::ADBMessageTransport;
|
||||
|
||||
use super::{ADBUsbMessage, USBCommand};
|
||||
use super::{ADBTransportMessage, MessageCommand};
|
||||
|
||||
/// Wraps a `Writer` to hide underlying ADB protocol write logic.
|
||||
/// [`Write`] trait implementation to hide underlying ADB protocol write logic.
|
||||
///
|
||||
/// Read received responses to check that message has been received.
|
||||
pub struct USBWriter {
|
||||
transport: USBTransport,
|
||||
/// Read received responses to check that message has been correctly received.
|
||||
pub struct MessageWriter<T: ADBMessageTransport> {
|
||||
transport: T,
|
||||
local_id: u32,
|
||||
remote_id: u32,
|
||||
}
|
||||
|
||||
impl USBWriter {
|
||||
pub fn new(transport: USBTransport, local_id: u32, remote_id: u32) -> Self {
|
||||
impl<T: ADBMessageTransport> MessageWriter<T> {
|
||||
pub fn new(transport: T, local_id: u32, remote_id: u32) -> Self {
|
||||
Self {
|
||||
transport,
|
||||
local_id,
|
||||
@@ -23,10 +23,10 @@ impl USBWriter {
|
||||
}
|
||||
}
|
||||
|
||||
impl Write for USBWriter {
|
||||
impl<T: ADBMessageTransport> Write for MessageWriter<T> {
|
||||
fn write(&mut self, buf: &[u8]) -> std::io::Result<usize> {
|
||||
let message = ADBUsbMessage::new(
|
||||
USBCommand::Write,
|
||||
let message = ADBTransportMessage::new(
|
||||
MessageCommand::Write,
|
||||
self.local_id,
|
||||
self.remote_id,
|
||||
buf.to_vec(),
|
||||
@@ -37,7 +37,7 @@ impl Write for USBWriter {
|
||||
|
||||
match self.transport.read_message() {
|
||||
Ok(response) => match response.header().command() {
|
||||
USBCommand::Okay => Ok(buf.len()),
|
||||
MessageCommand::Okay => Ok(buf.len()),
|
||||
c => Err(std::io::Error::new(
|
||||
ErrorKind::Other,
|
||||
format!("wrong response received: {c}"),
|
||||
17
adb_client/src/device/mod.rs
Normal file
17
adb_client/src/device/mod.rs
Normal file
@@ -0,0 +1,17 @@
|
||||
mod adb_message_device;
|
||||
mod adb_message_device_commands;
|
||||
mod adb_tcp_device;
|
||||
mod adb_transport_message;
|
||||
mod adb_usb_device;
|
||||
mod commands;
|
||||
mod message_writer;
|
||||
mod models;
|
||||
mod shell_message_writer;
|
||||
|
||||
use adb_message_device::ADBMessageDevice;
|
||||
pub use adb_tcp_device::ADBTcpDevice;
|
||||
pub use adb_transport_message::{ADBTransportMessage, ADBTransportMessageHeader};
|
||||
pub use adb_usb_device::{get_default_adb_key_path, ADBUSBDevice};
|
||||
pub use message_writer::MessageWriter;
|
||||
pub use models::{ADBRsaKey, MessageCommand, MessageSubcommand};
|
||||
pub use shell_message_writer::ShellMessageWriter;
|
||||
@@ -44,7 +44,7 @@ impl ADBRsaInternalPublicKey {
|
||||
}
|
||||
}
|
||||
|
||||
#[derive(Debug)]
|
||||
#[derive(Debug, Clone)]
|
||||
pub struct ADBRsaKey {
|
||||
private_key: RsaPrivateKey,
|
||||
}
|
||||
@@ -4,7 +4,7 @@ use std::fmt::Display;
|
||||
|
||||
#[derive(Clone, Copy, Debug, Eq, PartialEq, Serialize_repr, Deserialize_repr)]
|
||||
#[repr(u32)]
|
||||
pub enum USBCommand {
|
||||
pub enum MessageCommand {
|
||||
/// Connect to a device
|
||||
Cnxn = 0x4e584e43,
|
||||
/// Close connection to a device
|
||||
@@ -18,12 +18,13 @@ pub enum USBCommand {
|
||||
/// Server understood the message
|
||||
Okay = 0x59414b4f,
|
||||
// Sync 0x434e5953
|
||||
// Stls 0x534C5453
|
||||
/// Start a connection using TLS
|
||||
Stls = 0x534C5453,
|
||||
}
|
||||
|
||||
#[derive(Debug, Eq, PartialEq, Copy, Clone, Serialize_repr, Deserialize_repr)]
|
||||
#[repr(u32)]
|
||||
pub enum USBSubcommand {
|
||||
pub enum MessageSubcommand {
|
||||
Stat = 0x54415453,
|
||||
Send = 0x444E4553,
|
||||
Recv = 0x56434552,
|
||||
@@ -36,11 +37,11 @@ pub enum USBSubcommand {
|
||||
|
||||
#[derive(Debug, Serialize, Deserialize)]
|
||||
pub struct SubcommandWithArg {
|
||||
subcommand: USBSubcommand,
|
||||
subcommand: MessageSubcommand,
|
||||
arg: u32,
|
||||
}
|
||||
|
||||
impl USBSubcommand {
|
||||
impl MessageSubcommand {
|
||||
pub fn with_arg(self, arg: u32) -> SubcommandWithArg {
|
||||
SubcommandWithArg {
|
||||
subcommand: self,
|
||||
@@ -49,15 +50,16 @@ impl USBSubcommand {
|
||||
}
|
||||
}
|
||||
|
||||
impl Display for USBCommand {
|
||||
impl Display for MessageCommand {
|
||||
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
|
||||
match self {
|
||||
USBCommand::Cnxn => write!(f, "CNXN"),
|
||||
USBCommand::Clse => write!(f, "CLSE"),
|
||||
USBCommand::Auth => write!(f, "AUTH"),
|
||||
USBCommand::Open => write!(f, "OPEN"),
|
||||
USBCommand::Write => write!(f, "WRTE"),
|
||||
USBCommand::Okay => write!(f, "OKAY"),
|
||||
MessageCommand::Cnxn => write!(f, "CNXN"),
|
||||
MessageCommand::Clse => write!(f, "CLSE"),
|
||||
MessageCommand::Auth => write!(f, "AUTH"),
|
||||
MessageCommand::Open => write!(f, "OPEN"),
|
||||
MessageCommand::Write => write!(f, "WRTE"),
|
||||
MessageCommand::Okay => write!(f, "OKAY"),
|
||||
MessageCommand::Stls => write!(f, "STLS"),
|
||||
}
|
||||
}
|
||||
}
|
||||
5
adb_client/src/device/models/mod.rs
Normal file
5
adb_client/src/device/models/mod.rs
Normal file
@@ -0,0 +1,5 @@
|
||||
mod adb_rsa_key;
|
||||
mod message_commands;
|
||||
|
||||
pub use adb_rsa_key::ADBRsaKey;
|
||||
pub use message_commands::{MessageCommand, MessageSubcommand};
|
||||
@@ -1,18 +1,18 @@
|
||||
use std::io::Write;
|
||||
|
||||
use crate::USBTransport;
|
||||
use crate::ADBMessageTransport;
|
||||
|
||||
use super::{ADBUsbMessage, USBCommand};
|
||||
use super::{models::MessageCommand, ADBTransportMessage};
|
||||
|
||||
/// Wraps a `Writer` to hide underlying ADB protocol write logic.
|
||||
pub struct USBShellWriter {
|
||||
transport: USBTransport,
|
||||
/// [`Write`] trait implementation to hide underlying ADB protocol write logic for shell commands.
|
||||
pub struct ShellMessageWriter<T: ADBMessageTransport> {
|
||||
transport: T,
|
||||
local_id: u32,
|
||||
remote_id: u32,
|
||||
}
|
||||
|
||||
impl USBShellWriter {
|
||||
pub fn new(transport: USBTransport, local_id: u32, remote_id: u32) -> Self {
|
||||
impl<T: ADBMessageTransport> ShellMessageWriter<T> {
|
||||
pub fn new(transport: T, local_id: u32, remote_id: u32) -> Self {
|
||||
Self {
|
||||
transport,
|
||||
local_id,
|
||||
@@ -21,10 +21,10 @@ impl USBShellWriter {
|
||||
}
|
||||
}
|
||||
|
||||
impl Write for USBShellWriter {
|
||||
impl<T: ADBMessageTransport> Write for ShellMessageWriter<T> {
|
||||
fn write(&mut self, buf: &[u8]) -> std::io::Result<usize> {
|
||||
let message = ADBUsbMessage::new(
|
||||
USBCommand::Write,
|
||||
let message = ADBTransportMessage::new(
|
||||
MessageCommand::Write,
|
||||
self.local_id,
|
||||
self.remote_id,
|
||||
buf.to_vec(),
|
||||
@@ -1,15 +1,14 @@
|
||||
use std::net::{Ipv4Addr, SocketAddrV4};
|
||||
use std::{
|
||||
net::{Ipv4Addr, SocketAddrV4},
|
||||
sync::LazyLock,
|
||||
};
|
||||
|
||||
use crate::{ADBTransport, Result, RustADBError, TCPEmulatorTransport};
|
||||
use lazy_static::lazy_static;
|
||||
use crate::{ADBServerDevice, ADBTransport, Result, RustADBError, TCPEmulatorTransport};
|
||||
use regex::Regex;
|
||||
|
||||
use super::ADBServerDevice;
|
||||
|
||||
lazy_static! {
|
||||
pub static ref EMULATOR_REGEX: Regex =
|
||||
Regex::new("^emulator-(?P<port>\\d+)$").expect("wrong syntax for emulator regex");
|
||||
}
|
||||
static EMULATOR_REGEX: LazyLock<Regex> = LazyLock::new(|| {
|
||||
Regex::new("^emulator-(?P<port>\\d+)$").expect("wrong syntax for emulator regex")
|
||||
});
|
||||
|
||||
/// Represents an emulator connected to the ADB server.
|
||||
#[derive(Debug)]
|
||||
3
adb_client/src/emulator_device/mod.rs
Normal file
3
adb_client/src/emulator_device/mod.rs
Normal file
@@ -0,0 +1,3 @@
|
||||
mod adb_emulator_device;
|
||||
mod commands;
|
||||
pub use adb_emulator_device::ADBEmulatorDevice;
|
||||
@@ -93,4 +93,25 @@ pub enum RustADBError {
|
||||
/// An error occurred with PKCS8 data
|
||||
#[error("error with pkcs8: {0}")]
|
||||
RsaPkcs8Error(#[from] rsa::pkcs8::Error),
|
||||
/// Error during certificate generation
|
||||
#[error(transparent)]
|
||||
CertificateGenerationError(#[from] rcgen::Error),
|
||||
/// TLS Error
|
||||
#[error(transparent)]
|
||||
TLSError(#[from] rustls::Error),
|
||||
/// PEM certificate error
|
||||
#[error(transparent)]
|
||||
PemCertError(#[from] rustls_pki_types::pem::Error),
|
||||
/// Error while locking mutex
|
||||
#[error("error while locking data")]
|
||||
PoisonError,
|
||||
/// Cannot upgrade connection from TCP to TLS
|
||||
#[error("upgrade error: {0}")]
|
||||
UpgradeError(String),
|
||||
}
|
||||
|
||||
impl<T> From<std::sync::PoisonError<T>> for RustADBError {
|
||||
fn from(_err: std::sync::PoisonError<T>) -> Self {
|
||||
Self::PoisonError
|
||||
}
|
||||
}
|
||||
|
||||
@@ -6,17 +6,20 @@
|
||||
|
||||
mod adb_device_ext;
|
||||
mod constants;
|
||||
mod emulator;
|
||||
mod device;
|
||||
mod emulator_device;
|
||||
mod error;
|
||||
mod models;
|
||||
mod server;
|
||||
mod server_device;
|
||||
mod transports;
|
||||
mod usb;
|
||||
mod utils;
|
||||
|
||||
pub use adb_device_ext::ADBDeviceExt;
|
||||
pub use device::{ADBTcpDevice, ADBUSBDevice};
|
||||
pub use emulator_device::ADBEmulatorDevice;
|
||||
pub use error::{Result, RustADBError};
|
||||
pub use models::{AdbStatResponse, AdbVersion, DeviceLong, DeviceShort, DeviceState, RebootType};
|
||||
pub use server::*;
|
||||
pub use server_device::ADBServerDevice;
|
||||
pub use transports::*;
|
||||
pub use usb::ADBUSBDevice;
|
||||
|
||||
@@ -1,16 +1,15 @@
|
||||
use lazy_static::lazy_static;
|
||||
use std::str::FromStr;
|
||||
use std::sync::LazyLock;
|
||||
use std::{fmt::Display, str};
|
||||
|
||||
use crate::{DeviceState, RustADBError};
|
||||
use regex::bytes::Regex;
|
||||
|
||||
lazy_static! {
|
||||
static ref DEVICES_LONG_REGEX: Regex = Regex::new("^(?P<identifier>\\S+)\\s+(?P<state>\\w+) ((usb:(?P<usb1>.*)|(?P<usb2>\\d-\\d)) )?(product:(?P<product>\\w+) model:(?P<model>\\w+) device:(?P<device>\\w+) )?transport_id:(?P<transport_id>\\d+)$").expect("cannot build devices long regex");
|
||||
static DEVICES_LONG_REGEX: LazyLock<Regex> = LazyLock::new(|| {
|
||||
Regex::new("^(?P<identifier>\\S+)\\s+(?P<state>\\w+) ((usb:(?P<usb1>.*)|(?P<usb2>\\d-\\d)) )?(product:(?P<product>\\w+) model:(?P<model>\\w+) device:(?P<device>\\w+) )?transport_id:(?P<transport_id>\\d+)$").expect("cannot build devices long regex")
|
||||
});
|
||||
|
||||
}
|
||||
|
||||
/// Represents a new device with more informations helded.
|
||||
/// Represents a new device with more informations.
|
||||
#[derive(Debug)]
|
||||
pub struct DeviceLong {
|
||||
/// Unique device identifier.
|
||||
|
||||
@@ -1,13 +1,10 @@
|
||||
use lazy_static::lazy_static;
|
||||
use regex::bytes::Regex;
|
||||
use std::{fmt::Display, str::FromStr};
|
||||
use std::{fmt::Display, str::FromStr, sync::LazyLock};
|
||||
|
||||
use crate::{DeviceState, RustADBError};
|
||||
|
||||
lazy_static! {
|
||||
static ref DEVICES_REGEX: Regex =
|
||||
Regex::new("^(\\S+)\t(\\w+)\n?$").expect("Cannot build devices regex");
|
||||
}
|
||||
static DEVICES_REGEX: LazyLock<Regex> =
|
||||
LazyLock::new(|| Regex::new("^(\\S+)\t(\\w+)\n?$").expect("Cannot build devices regex"));
|
||||
|
||||
/// Represents a device connected to the ADB server.
|
||||
#[derive(Debug, Clone)]
|
||||
|
||||
@@ -1,10 +1,4 @@
|
||||
mod adb_emulator_device;
|
||||
mod adb_server;
|
||||
mod adb_server_device;
|
||||
mod adb_server_device_commands;
|
||||
mod device_commands;
|
||||
mod server_commands;
|
||||
mod commands;
|
||||
|
||||
pub use adb_emulator_device::ADBEmulatorDevice;
|
||||
pub use adb_server::ADBServer;
|
||||
pub use adb_server_device::ADBServerDevice;
|
||||
|
||||
@@ -6,9 +6,11 @@ use std::{
|
||||
use crate::{
|
||||
constants::BUFFER_SIZE,
|
||||
models::{AdbServerCommand, AdbStatResponse, HostFeatures},
|
||||
ADBDeviceExt, ADBServerDevice, Result, RustADBError,
|
||||
ADBDeviceExt, Result, RustADBError,
|
||||
};
|
||||
|
||||
use super::ADBServerDevice;
|
||||
|
||||
impl ADBDeviceExt for ADBServerDevice {
|
||||
fn shell_command<S: ToString, W: Write>(
|
||||
&mut self,
|
||||
@@ -104,7 +104,7 @@ impl TryFrom<[u8; std::mem::size_of::<Self>()]> for FrameBufferInfoV2 {
|
||||
|
||||
impl ADBServerDevice {
|
||||
/// Dump framebuffer of this device into given ['path']
|
||||
/// Big help from source code (https://android.googlesource.com/platform/system/adb/+/refs/heads/main/framebuffer_service.cpp)
|
||||
/// Big help from source code (<https://android.googlesource.com/platform/system/adb/+/refs/heads/main/framebuffer_service.cpp>)
|
||||
pub fn framebuffer<P: AsRef<Path>>(&mut self, path: P) -> Result<()> {
|
||||
let img = self.framebuffer_inner()?;
|
||||
Ok(img.save(path.as_ref())?)
|
||||
@@ -1,6 +1,8 @@
|
||||
use std::{fs::File, io::Read, path::Path};
|
||||
|
||||
use crate::{models::AdbServerCommand, utils::check_extension_is_apk, ADBServerDevice, Result};
|
||||
use crate::{
|
||||
models::AdbServerCommand, server_device::ADBServerDevice, utils::check_extension_is_apk, Result,
|
||||
};
|
||||
|
||||
impl ADBServerDevice {
|
||||
/// Install an APK on device
|
||||
@@ -9,7 +9,7 @@ use std::{
|
||||
};
|
||||
|
||||
impl ADBServerDevice {
|
||||
/// Lists files in [path] on the device.
|
||||
/// Lists files in `path` on the device.
|
||||
pub fn list<A: AsRef<str>>(&mut self, path: A) -> Result<()> {
|
||||
let serial = self.identifier.clone();
|
||||
self.connect()?
|
||||
@@ -69,7 +69,7 @@ impl<R: Read> Read for ADBRecvCommandReader<R> {
|
||||
}
|
||||
|
||||
impl ADBServerDevice {
|
||||
/// Receives [path] to [stream] from the device.
|
||||
/// Receives `path` to `stream` from the device.
|
||||
pub fn pull<A: AsRef<str>>(&mut self, path: A, stream: &mut dyn Write) -> Result<()> {
|
||||
let serial = self.identifier.clone();
|
||||
self.connect()?
|
||||
@@ -42,7 +42,7 @@ impl<W: Write> Write for ADBSendCommandWriter<W> {
|
||||
}
|
||||
|
||||
impl ADBServerDevice {
|
||||
/// Send [stream] to [path] on the device.
|
||||
/// Send `stream` to `path` on the device.
|
||||
pub fn push<R: Read, A: AsRef<str>>(&mut self, stream: R, path: A) -> Result<()> {
|
||||
log::info!("Sending data to {}", path.as_ref());
|
||||
let serial = self.identifier.clone();
|
||||
@@ -41,7 +41,7 @@ impl ADBServerDevice {
|
||||
}
|
||||
}
|
||||
|
||||
/// Stat file given as [path] on the device.
|
||||
/// Stat file given as `path` on the device.
|
||||
pub fn stat<A: AsRef<str>>(&mut self, path: A) -> Result<AdbStatResponse> {
|
||||
let serial = self.identifier.clone();
|
||||
self.connect()?
|
||||
5
adb_client/src/server_device/mod.rs
Normal file
5
adb_client/src/server_device/mod.rs
Normal file
@@ -0,0 +1,5 @@
|
||||
mod adb_server_device;
|
||||
mod adb_server_device_commands;
|
||||
mod commands;
|
||||
|
||||
pub use adb_server_device::ADBServerDevice;
|
||||
@@ -1,8 +1,11 @@
|
||||
mod tcp_emulator_transport;
|
||||
mod tcp_server_transport;
|
||||
mod transport_trait;
|
||||
mod tcp_transport;
|
||||
mod traits;
|
||||
mod usb_transport;
|
||||
|
||||
pub use tcp_emulator_transport::TCPEmulatorTransport;
|
||||
pub use tcp_server_transport::TCPServerTransport;
|
||||
pub use transport_trait::ADBTransport;
|
||||
pub use tcp_transport::TcpTransport;
|
||||
pub use traits::{ADBMessageTransport, ADBTransport};
|
||||
pub use usb_transport::USBTransport;
|
||||
|
||||
344
adb_client/src/transports/tcp_transport.rs
Normal file
344
adb_client/src/transports/tcp_transport.rs
Normal file
@@ -0,0 +1,344 @@
|
||||
use rcgen::{CertificateParams, KeyPair, PKCS_RSA_SHA256};
|
||||
use rustls::{
|
||||
client::danger::{HandshakeSignatureValid, ServerCertVerified, ServerCertVerifier},
|
||||
pki_types::{pem::PemObject, CertificateDer, PrivatePkcs8KeyDer},
|
||||
ClientConfig, ClientConnection, KeyLogFile, SignatureScheme, StreamOwned,
|
||||
};
|
||||
|
||||
use super::{ADBMessageTransport, ADBTransport};
|
||||
use crate::{
|
||||
device::{
|
||||
get_default_adb_key_path, ADBTransportMessage, ADBTransportMessageHeader, MessageCommand,
|
||||
},
|
||||
Result, RustADBError,
|
||||
};
|
||||
use std::{
|
||||
fs::read_to_string,
|
||||
io::{Read, Write},
|
||||
net::{Shutdown, SocketAddr, TcpStream},
|
||||
ops::{Deref, DerefMut},
|
||||
path::PathBuf,
|
||||
sync::{Arc, Mutex},
|
||||
time::Duration,
|
||||
};
|
||||
|
||||
#[derive(Debug)]
|
||||
enum CurrentConnection {
|
||||
Tcp(TcpStream),
|
||||
Tls(Box<StreamOwned<ClientConnection, TcpStream>>),
|
||||
}
|
||||
|
||||
impl CurrentConnection {
|
||||
fn set_read_timeout(&self, read_timeout: Duration) -> Result<()> {
|
||||
match self {
|
||||
CurrentConnection::Tcp(tcp_stream) => {
|
||||
Ok(tcp_stream.set_read_timeout(Some(read_timeout))?)
|
||||
}
|
||||
CurrentConnection::Tls(stream_owned) => {
|
||||
Ok(stream_owned.sock.set_read_timeout(Some(read_timeout))?)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
fn set_write_timeout(&self, write_timeout: Duration) -> Result<()> {
|
||||
match self {
|
||||
CurrentConnection::Tcp(tcp_stream) => {
|
||||
Ok(tcp_stream.set_write_timeout(Some(write_timeout))?)
|
||||
}
|
||||
CurrentConnection::Tls(stream_owned) => {
|
||||
Ok(stream_owned.sock.set_write_timeout(Some(write_timeout))?)
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
impl Read for CurrentConnection {
|
||||
fn read(&mut self, buf: &mut [u8]) -> std::io::Result<usize> {
|
||||
match self {
|
||||
CurrentConnection::Tcp(tcp_stream) => tcp_stream.read(buf),
|
||||
CurrentConnection::Tls(tls_conn) => tls_conn.read(buf),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
impl Write for CurrentConnection {
|
||||
fn write(&mut self, buf: &[u8]) -> std::io::Result<usize> {
|
||||
match self {
|
||||
CurrentConnection::Tcp(tcp_stream) => tcp_stream.write(buf),
|
||||
CurrentConnection::Tls(tls_conn) => tls_conn.write(buf),
|
||||
}
|
||||
}
|
||||
|
||||
fn flush(&mut self) -> std::io::Result<()> {
|
||||
match self {
|
||||
CurrentConnection::Tcp(tcp_stream) => tcp_stream.flush(),
|
||||
CurrentConnection::Tls(tls_conn) => tls_conn.flush(),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// Transport running on USB
|
||||
#[derive(Clone, Debug)]
|
||||
pub struct TcpTransport {
|
||||
address: SocketAddr,
|
||||
current_connection: Option<Arc<Mutex<CurrentConnection>>>,
|
||||
private_key_path: PathBuf,
|
||||
}
|
||||
|
||||
fn certificate_from_pk(key_pair: &KeyPair) -> Result<Vec<CertificateDer<'static>>> {
|
||||
let certificate_params = CertificateParams::default();
|
||||
let certificate = certificate_params.self_signed(key_pair)?;
|
||||
Ok(vec![certificate.der().to_owned()])
|
||||
}
|
||||
|
||||
impl TcpTransport {
|
||||
/// Instantiate a new [`TcpTransport`]
|
||||
pub fn new(address: SocketAddr) -> Result<Self> {
|
||||
Self::new_with_custom_private_key(address, get_default_adb_key_path()?)
|
||||
}
|
||||
|
||||
/// Instantiate a new [`TcpTransport`] using a given private key
|
||||
pub fn new_with_custom_private_key(
|
||||
address: SocketAddr,
|
||||
private_key_path: PathBuf,
|
||||
) -> Result<Self> {
|
||||
Ok(Self {
|
||||
address,
|
||||
current_connection: None,
|
||||
private_key_path,
|
||||
})
|
||||
}
|
||||
|
||||
fn get_current_connection(&mut self) -> Result<Arc<Mutex<CurrentConnection>>> {
|
||||
self.current_connection
|
||||
.as_ref()
|
||||
.ok_or(RustADBError::IOError(std::io::Error::new(
|
||||
std::io::ErrorKind::NotConnected,
|
||||
"not connected",
|
||||
)))
|
||||
.cloned()
|
||||
}
|
||||
|
||||
pub(crate) fn upgrade_connection(&mut self) -> Result<()> {
|
||||
let current_connection = match self.current_connection.clone() {
|
||||
Some(current_connection) => current_connection,
|
||||
None => {
|
||||
return Err(RustADBError::UpgradeError(
|
||||
"cannot upgrade a non-existing connection...".into(),
|
||||
))
|
||||
}
|
||||
};
|
||||
|
||||
{
|
||||
let mut current_conn_locked = current_connection.lock()?;
|
||||
match current_conn_locked.deref() {
|
||||
CurrentConnection::Tcp(tcp_stream) => {
|
||||
// TODO: Check if we cannot be more precise
|
||||
|
||||
let pk_content = read_to_string(&self.private_key_path)?;
|
||||
|
||||
let key_pair =
|
||||
KeyPair::from_pkcs8_pem_and_sign_algo(&pk_content, &PKCS_RSA_SHA256)?;
|
||||
|
||||
let certificate = certificate_from_pk(&key_pair)?;
|
||||
let private_key = PrivatePkcs8KeyDer::from_pem_file(&self.private_key_path)?;
|
||||
|
||||
let mut client_config = ClientConfig::builder()
|
||||
.dangerous()
|
||||
.with_custom_certificate_verifier(Arc::new(NoCertificateVerification {}))
|
||||
.with_client_auth_cert(certificate, private_key.into())?;
|
||||
|
||||
client_config.key_log = Arc::new(KeyLogFile::new());
|
||||
|
||||
let rc_config = Arc::new(client_config);
|
||||
let example_com = self.address.ip().into();
|
||||
let conn = ClientConnection::new(rc_config, example_com)?;
|
||||
let owned = tcp_stream.try_clone()?;
|
||||
let client = StreamOwned::new(conn, owned);
|
||||
|
||||
// Update current connection state to now use TLS protocol
|
||||
*current_conn_locked = CurrentConnection::Tls(Box::new(client));
|
||||
}
|
||||
CurrentConnection::Tls(_) => {
|
||||
return Err(RustADBError::UpgradeError(
|
||||
"cannot upgrade a TLS connection...".into(),
|
||||
))
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
let message = self.read_message()?;
|
||||
match message.header().command() {
|
||||
MessageCommand::Cnxn => {
|
||||
let device_infos = String::from_utf8(message.into_payload())?;
|
||||
log::debug!("received device info: {device_infos}");
|
||||
Ok(())
|
||||
}
|
||||
c => Err(RustADBError::ADBRequestFailed(format!(
|
||||
"Wrong command received {}",
|
||||
c
|
||||
))),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
impl ADBTransport for TcpTransport {
|
||||
fn connect(&mut self) -> Result<()> {
|
||||
let stream = TcpStream::connect(self.address)?;
|
||||
self.current_connection = Some(Arc::new(Mutex::new(CurrentConnection::Tcp(stream))));
|
||||
Ok(())
|
||||
}
|
||||
|
||||
fn disconnect(&mut self) -> Result<()> {
|
||||
log::debug!("disconnecting...");
|
||||
if let Some(current_connection) = &self.current_connection {
|
||||
let mut lock = current_connection.lock()?;
|
||||
match lock.deref_mut() {
|
||||
CurrentConnection::Tcp(tcp_stream) => {
|
||||
let _ = tcp_stream.shutdown(Shutdown::Both);
|
||||
}
|
||||
CurrentConnection::Tls(tls_conn) => {
|
||||
tls_conn.conn.send_close_notify();
|
||||
let _ = tls_conn.sock.shutdown(Shutdown::Both);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
Ok(())
|
||||
}
|
||||
}
|
||||
|
||||
impl ADBMessageTransport for TcpTransport {
|
||||
fn read_message_with_timeout(
|
||||
&mut self,
|
||||
read_timeout: std::time::Duration,
|
||||
) -> Result<crate::device::ADBTransportMessage> {
|
||||
let raw_connection_lock = self.get_current_connection()?;
|
||||
let mut raw_connection = raw_connection_lock.lock()?;
|
||||
|
||||
raw_connection.set_read_timeout(read_timeout)?;
|
||||
|
||||
let mut data = [0; 24];
|
||||
let mut total_read = 0;
|
||||
loop {
|
||||
total_read += raw_connection.read(&mut data[total_read..])?;
|
||||
if total_read == data.len() {
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
let header = ADBTransportMessageHeader::try_from(data)?;
|
||||
|
||||
if header.data_length() != 0 {
|
||||
let mut msg_data = vec![0_u8; header.data_length() as usize];
|
||||
let mut total_read = 0;
|
||||
loop {
|
||||
total_read += raw_connection.read(&mut msg_data[total_read..])?;
|
||||
if total_read == msg_data.capacity() {
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
let message = ADBTransportMessage::from_header_and_payload(header, msg_data);
|
||||
|
||||
// Check message integrity
|
||||
if !message.check_message_integrity() {
|
||||
return Err(RustADBError::InvalidIntegrity(
|
||||
ADBTransportMessageHeader::compute_crc32(message.payload()),
|
||||
message.header().data_crc32(),
|
||||
));
|
||||
}
|
||||
|
||||
return Ok(message);
|
||||
}
|
||||
|
||||
Ok(ADBTransportMessage::from_header_and_payload(header, vec![]))
|
||||
}
|
||||
|
||||
fn write_message_with_timeout(
|
||||
&mut self,
|
||||
message: ADBTransportMessage,
|
||||
write_timeout: Duration,
|
||||
) -> Result<()> {
|
||||
let message_bytes = message.header().as_bytes()?;
|
||||
let raw_connection_lock = self.get_current_connection()?;
|
||||
let mut raw_connection = raw_connection_lock.lock()?;
|
||||
|
||||
raw_connection.set_write_timeout(write_timeout)?;
|
||||
|
||||
let mut total_written = 0;
|
||||
loop {
|
||||
total_written += raw_connection.write(&message_bytes[total_written..])?;
|
||||
if total_written == message_bytes.len() {
|
||||
raw_connection.flush()?;
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
let payload = message.into_payload();
|
||||
if !payload.is_empty() {
|
||||
let mut total_written = 0;
|
||||
loop {
|
||||
total_written += raw_connection.write(&payload[total_written..])?;
|
||||
if total_written == payload.len() {
|
||||
raw_connection.flush()?;
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
Ok(())
|
||||
}
|
||||
}
|
||||
|
||||
#[derive(Debug)]
|
||||
struct NoCertificateVerification;
|
||||
|
||||
impl ServerCertVerifier for NoCertificateVerification {
|
||||
fn verify_server_cert(
|
||||
&self,
|
||||
_end_entity: &rustls::pki_types::CertificateDer<'_>,
|
||||
_intermediates: &[rustls::pki_types::CertificateDer<'_>],
|
||||
_server_name: &rustls::pki_types::ServerName<'_>,
|
||||
_ocsp_response: &[u8],
|
||||
_now: rustls::pki_types::UnixTime,
|
||||
) -> std::result::Result<rustls::client::danger::ServerCertVerified, rustls::Error> {
|
||||
Ok(ServerCertVerified::assertion())
|
||||
}
|
||||
|
||||
fn verify_tls12_signature(
|
||||
&self,
|
||||
_message: &[u8],
|
||||
_cert: &rustls::pki_types::CertificateDer<'_>,
|
||||
_dss: &rustls::DigitallySignedStruct,
|
||||
) -> std::result::Result<rustls::client::danger::HandshakeSignatureValid, rustls::Error> {
|
||||
Ok(HandshakeSignatureValid::assertion())
|
||||
}
|
||||
|
||||
fn verify_tls13_signature(
|
||||
&self,
|
||||
_message: &[u8],
|
||||
_cert: &rustls::pki_types::CertificateDer<'_>,
|
||||
_dss: &rustls::DigitallySignedStruct,
|
||||
) -> std::result::Result<rustls::client::danger::HandshakeSignatureValid, rustls::Error> {
|
||||
Ok(HandshakeSignatureValid::assertion())
|
||||
}
|
||||
|
||||
fn supported_verify_schemes(&self) -> Vec<rustls::SignatureScheme> {
|
||||
vec![
|
||||
SignatureScheme::RSA_PKCS1_SHA1,
|
||||
SignatureScheme::ECDSA_SHA1_Legacy,
|
||||
SignatureScheme::RSA_PKCS1_SHA256,
|
||||
SignatureScheme::ECDSA_NISTP256_SHA256,
|
||||
SignatureScheme::RSA_PKCS1_SHA384,
|
||||
SignatureScheme::ECDSA_NISTP384_SHA384,
|
||||
SignatureScheme::RSA_PKCS1_SHA512,
|
||||
SignatureScheme::ECDSA_NISTP521_SHA512,
|
||||
SignatureScheme::RSA_PSS_SHA256,
|
||||
SignatureScheme::RSA_PSS_SHA384,
|
||||
SignatureScheme::RSA_PSS_SHA512,
|
||||
SignatureScheme::ED25519,
|
||||
SignatureScheme::ED448,
|
||||
]
|
||||
}
|
||||
}
|
||||
30
adb_client/src/transports/traits/adb_message_transport.rs
Normal file
30
adb_client/src/transports/traits/adb_message_transport.rs
Normal file
@@ -0,0 +1,30 @@
|
||||
use std::time::Duration;
|
||||
|
||||
use super::ADBTransport;
|
||||
use crate::{device::ADBTransportMessage, Result};
|
||||
|
||||
const DEFAULT_READ_TIMEOUT: Duration = Duration::from_secs(u64::MAX);
|
||||
const DEFAULT_WRITE_TIMEOUT: Duration = Duration::from_secs(2);
|
||||
|
||||
/// Trait representing a transport able to read and write messages.
|
||||
pub trait ADBMessageTransport: ADBTransport + Clone + Send + 'static {
|
||||
/// Read a message using given timeout on the underlying transport
|
||||
fn read_message_with_timeout(&mut self, read_timeout: Duration) -> Result<ADBTransportMessage>;
|
||||
|
||||
/// Read data to underlying connection, using default timeout
|
||||
fn read_message(&mut self) -> Result<ADBTransportMessage> {
|
||||
self.read_message_with_timeout(DEFAULT_READ_TIMEOUT)
|
||||
}
|
||||
|
||||
/// Write a message using given timeout on the underlying transport
|
||||
fn write_message_with_timeout(
|
||||
&mut self,
|
||||
message: ADBTransportMessage,
|
||||
write_timeout: Duration,
|
||||
) -> Result<()>;
|
||||
|
||||
/// Write data to underlying connection, using default timeout
|
||||
fn write_message(&mut self, message: ADBTransportMessage) -> Result<()> {
|
||||
self.write_message_with_timeout(message, DEFAULT_WRITE_TIMEOUT)
|
||||
}
|
||||
}
|
||||
10
adb_client/src/transports/traits/adb_transport.rs
Normal file
10
adb_client/src/transports/traits/adb_transport.rs
Normal file
@@ -0,0 +1,10 @@
|
||||
use crate::Result;
|
||||
|
||||
/// Trait representing a transport usable by ADB protocol.
|
||||
pub trait ADBTransport {
|
||||
/// Initializes the connection to this transport.
|
||||
fn connect(&mut self) -> Result<()>;
|
||||
|
||||
/// Shuts down the connection to this transport.
|
||||
fn disconnect(&mut self) -> Result<()>;
|
||||
}
|
||||
5
adb_client/src/transports/traits/mod.rs
Normal file
5
adb_client/src/transports/traits/mod.rs
Normal file
@@ -0,0 +1,5 @@
|
||||
mod adb_message_transport;
|
||||
mod adb_transport;
|
||||
|
||||
pub use adb_message_transport::ADBMessageTransport;
|
||||
pub use adb_transport::ADBTransport;
|
||||
@@ -1,10 +0,0 @@
|
||||
use crate::Result;
|
||||
|
||||
/// Trait representing a transport
|
||||
pub trait ADBTransport {
|
||||
/// Initializes the connection
|
||||
fn connect(&mut self) -> Result<()>;
|
||||
|
||||
/// Shuts down the connection
|
||||
fn disconnect(&mut self) -> Result<()>;
|
||||
}
|
||||
@@ -4,9 +4,9 @@ use rusb::{
|
||||
constants::LIBUSB_CLASS_VENDOR_SPEC, DeviceHandle, Direction, GlobalContext, TransferType,
|
||||
};
|
||||
|
||||
use super::ADBTransport;
|
||||
use super::{ADBMessageTransport, ADBTransport};
|
||||
use crate::{
|
||||
usb::{ADBUsbMessage, ADBUsbMessageHeader, USBCommand},
|
||||
device::{ADBTransportMessage, ADBTransportMessageHeader, MessageCommand},
|
||||
Result, RustADBError,
|
||||
};
|
||||
|
||||
@@ -16,9 +16,6 @@ struct Endpoint {
|
||||
address: u8,
|
||||
}
|
||||
|
||||
const MAX_READ_TIMEOUT: Duration = Duration::from_secs(u64::MAX);
|
||||
const DEFAULT_WRITE_TIMEOUT: Duration = Duration::from_secs(2);
|
||||
|
||||
/// Transport running on USB
|
||||
#[derive(Debug, Clone)]
|
||||
pub struct USBTransport {
|
||||
@@ -52,105 +49,6 @@ impl USBTransport {
|
||||
Ok(())
|
||||
}
|
||||
|
||||
/// Write data to underlying connection, with default timeout
|
||||
pub(crate) fn write_message(&mut self, message: ADBUsbMessage) -> Result<()> {
|
||||
self.write_message_with_timeout(message, DEFAULT_WRITE_TIMEOUT)
|
||||
}
|
||||
|
||||
/// Write data to underlying connection
|
||||
pub(crate) fn write_message_with_timeout(
|
||||
&mut self,
|
||||
message: ADBUsbMessage,
|
||||
timeout: Duration,
|
||||
) -> Result<()> {
|
||||
let endpoint = self.find_writable_endpoint()?;
|
||||
let handle = self.get_raw_connection()?;
|
||||
|
||||
if let Ok(true) = handle.kernel_driver_active(endpoint.iface) {
|
||||
handle.detach_kernel_driver(endpoint.iface)?;
|
||||
}
|
||||
|
||||
Self::configure_endpoint(&handle, &endpoint)?;
|
||||
|
||||
let message_bytes = message.header().as_bytes()?;
|
||||
let mut total_written = 0;
|
||||
loop {
|
||||
total_written +=
|
||||
handle.write_bulk(endpoint.address, &message_bytes[total_written..], timeout)?;
|
||||
if total_written == message_bytes.len() {
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
let payload = message.into_payload();
|
||||
let mut total_written = 0;
|
||||
loop {
|
||||
total_written +=
|
||||
handle.write_bulk(endpoint.address, &payload[total_written..], timeout)?;
|
||||
if total_written == payload.len() {
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
Ok(())
|
||||
}
|
||||
|
||||
/// Blocking method to read data from underlying connection.
|
||||
pub(crate) fn read_message(&mut self) -> Result<ADBUsbMessage> {
|
||||
self.read_message_with_timeout(MAX_READ_TIMEOUT)
|
||||
}
|
||||
|
||||
/// Read data from underlying connection with given timeout.
|
||||
pub(crate) fn read_message_with_timeout(&mut self, timeout: Duration) -> Result<ADBUsbMessage> {
|
||||
let endpoint = self.find_readable_endpoint()?;
|
||||
let handle = self.get_raw_connection()?;
|
||||
|
||||
if let Ok(true) = handle.kernel_driver_active(endpoint.iface) {
|
||||
handle.detach_kernel_driver(endpoint.iface)?;
|
||||
}
|
||||
|
||||
Self::configure_endpoint(&handle, &endpoint)?;
|
||||
|
||||
let mut data = [0; 24];
|
||||
let mut total_read = 0;
|
||||
loop {
|
||||
total_read += handle.read_bulk(endpoint.address, &mut data[total_read..], timeout)?;
|
||||
if total_read == data.len() {
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
let header = ADBUsbMessageHeader::try_from(data)?;
|
||||
|
||||
log::trace!("received header {header:?}");
|
||||
|
||||
if header.data_length() != 0 {
|
||||
let mut msg_data = vec![0_u8; header.data_length() as usize];
|
||||
let mut total_read = 0;
|
||||
loop {
|
||||
total_read +=
|
||||
handle.read_bulk(endpoint.address, &mut msg_data[total_read..], timeout)?;
|
||||
if total_read == msg_data.capacity() {
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
let message = ADBUsbMessage::from_header_and_payload(header, msg_data);
|
||||
|
||||
// Check message integrity
|
||||
if !message.check_message_integrity() {
|
||||
return Err(RustADBError::InvalidIntegrity(
|
||||
ADBUsbMessageHeader::compute_crc32(message.payload()),
|
||||
message.header().data_crc32(),
|
||||
));
|
||||
}
|
||||
|
||||
return Ok(message);
|
||||
}
|
||||
|
||||
Ok(ADBUsbMessage::from_header_and_payload(header, vec![]))
|
||||
}
|
||||
|
||||
fn find_readable_endpoint(&self) -> Result<Endpoint> {
|
||||
let handle = self.get_raw_connection()?;
|
||||
for n in 0..handle.device().device_descriptor()?.num_configurations() {
|
||||
@@ -233,7 +131,98 @@ impl ADBTransport for USBTransport {
|
||||
}
|
||||
|
||||
fn disconnect(&mut self) -> crate::Result<()> {
|
||||
let message = ADBUsbMessage::new(USBCommand::Clse, 0, 0, "".into());
|
||||
let message = ADBTransportMessage::new(MessageCommand::Clse, 0, 0, "".into());
|
||||
self.write_message(message)
|
||||
}
|
||||
}
|
||||
|
||||
impl ADBMessageTransport for USBTransport {
|
||||
fn write_message_with_timeout(
|
||||
&mut self,
|
||||
message: ADBTransportMessage,
|
||||
timeout: Duration,
|
||||
) -> Result<()> {
|
||||
let endpoint = self.find_writable_endpoint()?;
|
||||
let handle = self.get_raw_connection()?;
|
||||
|
||||
if let Ok(true) = handle.kernel_driver_active(endpoint.iface) {
|
||||
handle.detach_kernel_driver(endpoint.iface)?;
|
||||
}
|
||||
|
||||
Self::configure_endpoint(&handle, &endpoint)?;
|
||||
|
||||
let message_bytes = message.header().as_bytes()?;
|
||||
let mut total_written = 0;
|
||||
loop {
|
||||
total_written +=
|
||||
handle.write_bulk(endpoint.address, &message_bytes[total_written..], timeout)?;
|
||||
if total_written == message_bytes.len() {
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
let payload = message.into_payload();
|
||||
if !payload.is_empty() {
|
||||
let mut total_written = 0;
|
||||
loop {
|
||||
total_written +=
|
||||
handle.write_bulk(endpoint.address, &payload[total_written..], timeout)?;
|
||||
if total_written == payload.len() {
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
Ok(())
|
||||
}
|
||||
|
||||
fn read_message_with_timeout(&mut self, timeout: Duration) -> Result<ADBTransportMessage> {
|
||||
let endpoint = self.find_readable_endpoint()?;
|
||||
let handle = self.get_raw_connection()?;
|
||||
|
||||
if let Ok(true) = handle.kernel_driver_active(endpoint.iface) {
|
||||
handle.detach_kernel_driver(endpoint.iface)?;
|
||||
}
|
||||
|
||||
Self::configure_endpoint(&handle, &endpoint)?;
|
||||
|
||||
let mut data = [0; 24];
|
||||
let mut total_read = 0;
|
||||
loop {
|
||||
total_read += handle.read_bulk(endpoint.address, &mut data[total_read..], timeout)?;
|
||||
if total_read == data.len() {
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
let header = ADBTransportMessageHeader::try_from(data)?;
|
||||
|
||||
log::trace!("received header {header:?}");
|
||||
|
||||
if header.data_length() != 0 {
|
||||
let mut msg_data = vec![0_u8; header.data_length() as usize];
|
||||
let mut total_read = 0;
|
||||
loop {
|
||||
total_read +=
|
||||
handle.read_bulk(endpoint.address, &mut msg_data[total_read..], timeout)?;
|
||||
if total_read == msg_data.capacity() {
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
let message = ADBTransportMessage::from_header_and_payload(header, msg_data);
|
||||
|
||||
// Check message integrity
|
||||
if !message.check_message_integrity() {
|
||||
return Err(RustADBError::InvalidIntegrity(
|
||||
ADBTransportMessageHeader::compute_crc32(message.payload()),
|
||||
message.header().data_crc32(),
|
||||
));
|
||||
}
|
||||
|
||||
return Ok(message);
|
||||
}
|
||||
|
||||
Ok(ADBTransportMessage::from_header_and_payload(header, vec![]))
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1,447 +0,0 @@
|
||||
use byteorder::ReadBytesExt;
|
||||
use rand::Rng;
|
||||
use rusb::Device;
|
||||
use rusb::DeviceDescriptor;
|
||||
use rusb::UsbContext;
|
||||
use std::fs::read_to_string;
|
||||
use std::io::Cursor;
|
||||
use std::io::Read;
|
||||
use std::io::Seek;
|
||||
use std::path::Path;
|
||||
use std::path::PathBuf;
|
||||
use std::time::Duration;
|
||||
|
||||
use byteorder::LittleEndian;
|
||||
|
||||
use super::{ADBRsaKey, ADBUsbMessage};
|
||||
use crate::constants::BUFFER_SIZE;
|
||||
use crate::models::AdbStatResponse;
|
||||
use crate::usb::adb_usb_message::{AUTH_RSAPUBLICKEY, AUTH_SIGNATURE, AUTH_TOKEN};
|
||||
use crate::{
|
||||
usb::usb_commands::{USBCommand, USBSubcommand},
|
||||
ADBTransport, Result, RustADBError, USBTransport,
|
||||
};
|
||||
|
||||
/// Represent a device reached directly over USB
|
||||
#[derive(Debug)]
|
||||
pub struct ADBUSBDevice {
|
||||
private_key: ADBRsaKey,
|
||||
pub(crate) transport: USBTransport,
|
||||
}
|
||||
|
||||
fn read_adb_private_key<P: AsRef<Path>>(private_key_path: P) -> Result<Option<ADBRsaKey>> {
|
||||
read_to_string(private_key_path.as_ref())
|
||||
.map_err(RustADBError::from)
|
||||
.map(|pk| match ADBRsaKey::new_from_pkcs8(&pk) {
|
||||
Ok(pk) => Some(pk),
|
||||
Err(e) => {
|
||||
log::error!("Error while create RSA private key: {e}");
|
||||
None
|
||||
}
|
||||
})
|
||||
}
|
||||
/// Search for adb devices with known interface class and subclass values
|
||||
fn search_adb_devices() -> Result<Option<(u16, u16)>> {
|
||||
let mut found_devices = vec![];
|
||||
for device in rusb::devices()?.iter() {
|
||||
let Ok(des) = device.device_descriptor() else {
|
||||
continue;
|
||||
};
|
||||
if is_adb_device(&device, &des) {
|
||||
log::debug!(
|
||||
"Autodetect device {:04x}:{:04x}",
|
||||
des.vendor_id(),
|
||||
des.product_id()
|
||||
);
|
||||
found_devices.push((des.vendor_id(), des.product_id()));
|
||||
}
|
||||
}
|
||||
|
||||
match (found_devices.first(), found_devices.get(1)) {
|
||||
(None, _) => Ok(None),
|
||||
(Some(identifiers), None) => Ok(Some(*identifiers)),
|
||||
(Some((vid1, pid1)), Some((vid2, pid2))) => Err(RustADBError::DeviceNotFound(format!(
|
||||
"Found two Android devices {:04x}:{:04x} and {:04x}:{:04x}",
|
||||
vid1, pid1, vid2, pid2
|
||||
))),
|
||||
}
|
||||
}
|
||||
|
||||
fn is_adb_device<T: UsbContext>(device: &Device<T>, des: &DeviceDescriptor) -> bool {
|
||||
const ADB_CLASS: u8 = 0xff;
|
||||
|
||||
const ADB_SUBCLASS: u8 = 0x42;
|
||||
const ADB_PROTOCOL: u8 = 0x1;
|
||||
|
||||
// Some devices require choosing the file transfer mode
|
||||
// for usb debugging to take effect.
|
||||
const BULK_CLASS: u8 = 0xdc;
|
||||
const BULK_ADB_SUBCLASS: u8 = 2;
|
||||
|
||||
for n in 0..des.num_configurations() {
|
||||
let Ok(config_des) = device.config_descriptor(n) else {
|
||||
continue;
|
||||
};
|
||||
for interface in config_des.interfaces() {
|
||||
for interface_des in interface.descriptors() {
|
||||
let proto = interface_des.protocol_code();
|
||||
let class = interface_des.class_code();
|
||||
let subcl = interface_des.sub_class_code();
|
||||
if proto == ADB_PROTOCOL
|
||||
&& ((class == ADB_CLASS && subcl == ADB_SUBCLASS)
|
||||
|| (class == BULK_CLASS && subcl == BULK_ADB_SUBCLASS))
|
||||
{
|
||||
return true;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
false
|
||||
}
|
||||
|
||||
fn get_default_adb_key_path() -> Result<PathBuf> {
|
||||
homedir::my_home()
|
||||
.ok()
|
||||
.flatten()
|
||||
.map(|home| home.join(".android").join("adbkey"))
|
||||
.ok_or(RustADBError::NoHomeDirectory)
|
||||
}
|
||||
|
||||
impl ADBUSBDevice {
|
||||
/// Instantiate a new [ADBUSBDevice]
|
||||
pub fn new(vendor_id: u16, product_id: u16) -> Result<Self> {
|
||||
Self::new_with_custom_private_key(vendor_id, product_id, get_default_adb_key_path()?)
|
||||
}
|
||||
|
||||
/// Instantiate a new [ADBUSBDevice] using a custom private key path
|
||||
pub fn new_with_custom_private_key(
|
||||
vendor_id: u16,
|
||||
product_id: u16,
|
||||
private_key_path: PathBuf,
|
||||
) -> Result<Self> {
|
||||
let private_key = match read_adb_private_key(private_key_path)? {
|
||||
Some(pk) => pk,
|
||||
None => ADBRsaKey::new_random()?,
|
||||
};
|
||||
|
||||
let mut s = Self {
|
||||
private_key,
|
||||
transport: USBTransport::new(vendor_id, product_id),
|
||||
};
|
||||
|
||||
s.connect()?;
|
||||
|
||||
Ok(s)
|
||||
}
|
||||
|
||||
/// autodetect connected ADB devices and establish a connection with the first device found
|
||||
pub fn autodetect() -> Result<Self> {
|
||||
Self::autodetect_with_custom_private_key(get_default_adb_key_path()?)
|
||||
}
|
||||
|
||||
/// autodetect connected ADB devices and establish a connection with the first device found using a custom private key path
|
||||
pub fn autodetect_with_custom_private_key(private_key_path: PathBuf) -> Result<Self> {
|
||||
match search_adb_devices()? {
|
||||
Some((vendor_id, product_id)) => {
|
||||
ADBUSBDevice::new_with_custom_private_key(vendor_id, product_id, private_key_path)
|
||||
}
|
||||
_ => Err(RustADBError::DeviceNotFound(
|
||||
"cannot find USB devices matching the signature of an ADB device".into(),
|
||||
)),
|
||||
}
|
||||
}
|
||||
|
||||
/// Send initial connect
|
||||
pub fn connect(&mut self) -> Result<()> {
|
||||
self.transport.connect()?;
|
||||
|
||||
let message = ADBUsbMessage::new(
|
||||
USBCommand::Cnxn,
|
||||
0x01000000,
|
||||
1048576,
|
||||
format!("host::{}\0", env!("CARGO_PKG_NAME"))
|
||||
.as_bytes()
|
||||
.to_vec(),
|
||||
);
|
||||
|
||||
self.transport.write_message(message)?;
|
||||
|
||||
let message = self.transport.read_message()?;
|
||||
|
||||
// At this point, we should have received either:
|
||||
// - an AUTH message with arg0 == 1
|
||||
// - a CNXN message
|
||||
let auth_message = match message.header().command() {
|
||||
USBCommand::Auth if message.header().arg0() == AUTH_TOKEN => message,
|
||||
USBCommand::Auth if message.header().arg0() != AUTH_TOKEN => {
|
||||
return Err(RustADBError::ADBRequestFailed(
|
||||
"Received AUTH message with type != 1".into(),
|
||||
))
|
||||
}
|
||||
c => {
|
||||
return Err(RustADBError::ADBRequestFailed(format!(
|
||||
"Wrong command received {}",
|
||||
c
|
||||
)))
|
||||
}
|
||||
};
|
||||
|
||||
let sign = self.private_key.sign(auth_message.into_payload())?;
|
||||
|
||||
let message = ADBUsbMessage::new(USBCommand::Auth, AUTH_SIGNATURE, 0, sign);
|
||||
|
||||
self.transport.write_message(message)?;
|
||||
|
||||
let received_response = self.transport.read_message()?;
|
||||
|
||||
if received_response.header().command() == USBCommand::Cnxn {
|
||||
log::info!(
|
||||
"Authentication OK, device info {}",
|
||||
String::from_utf8(received_response.into_payload())?
|
||||
);
|
||||
return Ok(());
|
||||
}
|
||||
|
||||
let mut pubkey = self.private_key.android_pubkey_encode()?.into_bytes();
|
||||
pubkey.push(b'\0');
|
||||
|
||||
let message = ADBUsbMessage::new(USBCommand::Auth, AUTH_RSAPUBLICKEY, 0, pubkey);
|
||||
|
||||
self.transport.write_message(message)?;
|
||||
|
||||
let response = self
|
||||
.transport
|
||||
.read_message_with_timeout(Duration::from_secs(10))?;
|
||||
|
||||
match response.header().command() {
|
||||
USBCommand::Cnxn => log::info!(
|
||||
"Authentication OK, device info {}",
|
||||
String::from_utf8(response.into_payload())?
|
||||
),
|
||||
_ => {
|
||||
return Err(RustADBError::ADBRequestFailed(format!(
|
||||
"wrong response {}",
|
||||
response.header().command()
|
||||
)))
|
||||
}
|
||||
}
|
||||
|
||||
Ok(())
|
||||
}
|
||||
/// Receive a message and acknowledge it by replying with an `OKAY` command
|
||||
pub(crate) fn recv_and_reply_okay(
|
||||
&mut self,
|
||||
local_id: u32,
|
||||
remote_id: u32,
|
||||
) -> Result<ADBUsbMessage> {
|
||||
let message = self.transport.read_message()?;
|
||||
self.transport.write_message(ADBUsbMessage::new(
|
||||
USBCommand::Okay,
|
||||
local_id,
|
||||
remote_id,
|
||||
"".into(),
|
||||
))?;
|
||||
Ok(message)
|
||||
}
|
||||
|
||||
/// Expect a message with an `OKAY` command after sending a message.
|
||||
pub(crate) fn send_and_expect_okay(&mut self, message: ADBUsbMessage) -> Result<ADBUsbMessage> {
|
||||
self.transport.write_message(message)?;
|
||||
let message = self.transport.read_message()?;
|
||||
let received_command = message.header().command();
|
||||
if received_command != USBCommand::Okay {
|
||||
return Err(RustADBError::ADBRequestFailed(format!(
|
||||
"expected command OKAY after message, got {}",
|
||||
received_command
|
||||
)));
|
||||
}
|
||||
Ok(message)
|
||||
}
|
||||
|
||||
pub(crate) fn recv_file<W: std::io::Write>(
|
||||
&mut self,
|
||||
local_id: u32,
|
||||
remote_id: u32,
|
||||
mut output: W,
|
||||
) -> std::result::Result<(), RustADBError> {
|
||||
let mut len: Option<u64> = None;
|
||||
loop {
|
||||
let payload = self
|
||||
.recv_and_reply_okay(local_id, remote_id)?
|
||||
.into_payload();
|
||||
let mut rdr = Cursor::new(&payload);
|
||||
while rdr.position() != payload.len() as u64 {
|
||||
match len.take() {
|
||||
Some(0) | None => {
|
||||
rdr.seek_relative(4)?;
|
||||
len.replace(rdr.read_u32::<LittleEndian>()? as u64);
|
||||
}
|
||||
Some(length) => {
|
||||
log::debug!("len = {length}");
|
||||
let remaining_bytes = payload.len() as u64 - rdr.position();
|
||||
log::debug!(
|
||||
"payload length {} - reader_position {} = {remaining_bytes}",
|
||||
payload.len(),
|
||||
rdr.position()
|
||||
);
|
||||
if length < remaining_bytes {
|
||||
let read = std::io::copy(&mut rdr.by_ref().take(length), &mut output)?;
|
||||
log::debug!(
|
||||
"expected to read {length} bytes, actually read {read} bytes"
|
||||
);
|
||||
} else {
|
||||
let read = std::io::copy(&mut rdr.take(remaining_bytes), &mut output)?;
|
||||
len.replace(length - remaining_bytes);
|
||||
log::debug!("expected to read {remaining_bytes} bytes, actually read {read} bytes");
|
||||
// this payload is exhausted
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
if Cursor::new(&payload[(payload.len() - 8)..(payload.len() - 4)])
|
||||
.read_u32::<LittleEndian>()?
|
||||
== USBSubcommand::Done as u32
|
||||
{
|
||||
break;
|
||||
}
|
||||
}
|
||||
Ok(())
|
||||
}
|
||||
|
||||
pub(crate) fn push_file<R: std::io::Read>(
|
||||
&mut self,
|
||||
local_id: u32,
|
||||
remote_id: u32,
|
||||
mut reader: R,
|
||||
) -> std::result::Result<(), RustADBError> {
|
||||
let mut buffer = [0; BUFFER_SIZE];
|
||||
let amount_read = reader.read(&mut buffer)?;
|
||||
let subcommand_data = USBSubcommand::Data.with_arg(amount_read as u32);
|
||||
|
||||
let mut serialized_message =
|
||||
bincode::serialize(&subcommand_data).map_err(|_e| RustADBError::ConversionError)?;
|
||||
serialized_message.append(&mut buffer[..amount_read].to_vec());
|
||||
|
||||
let message =
|
||||
ADBUsbMessage::new(USBCommand::Write, local_id, remote_id, serialized_message);
|
||||
|
||||
self.send_and_expect_okay(message)?;
|
||||
|
||||
loop {
|
||||
let mut buffer = [0; BUFFER_SIZE];
|
||||
|
||||
match reader.read(&mut buffer) {
|
||||
Ok(0) => {
|
||||
// Currently file mtime is not forwarded
|
||||
let subcommand_data = USBSubcommand::Done.with_arg(0);
|
||||
|
||||
let serialized_message = bincode::serialize(&subcommand_data)
|
||||
.map_err(|_e| RustADBError::ConversionError)?;
|
||||
|
||||
let message = ADBUsbMessage::new(
|
||||
USBCommand::Write,
|
||||
local_id,
|
||||
remote_id,
|
||||
serialized_message,
|
||||
);
|
||||
|
||||
self.send_and_expect_okay(message)?;
|
||||
|
||||
// Command should end with a Write => Okay
|
||||
let received = self.transport.read_message()?;
|
||||
match received.header().command() {
|
||||
USBCommand::Write => return Ok(()),
|
||||
c => {
|
||||
return Err(RustADBError::ADBRequestFailed(format!(
|
||||
"Wrong command received {}",
|
||||
c
|
||||
)))
|
||||
}
|
||||
}
|
||||
}
|
||||
Ok(size) => {
|
||||
let subcommand_data = USBSubcommand::Data.with_arg(size as u32);
|
||||
|
||||
let mut serialized_message = bincode::serialize(&subcommand_data)
|
||||
.map_err(|_e| RustADBError::ConversionError)?;
|
||||
serialized_message.append(&mut buffer[..size].to_vec());
|
||||
|
||||
let message = ADBUsbMessage::new(
|
||||
USBCommand::Write,
|
||||
local_id,
|
||||
remote_id,
|
||||
serialized_message,
|
||||
);
|
||||
|
||||
self.send_and_expect_okay(message)?;
|
||||
}
|
||||
Err(e) => {
|
||||
return Err(RustADBError::IOError(e));
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
pub(crate) fn begin_synchronization(&mut self) -> Result<(u32, u32)> {
|
||||
let sync_directive = "sync:\0";
|
||||
|
||||
let mut rng = rand::thread_rng();
|
||||
let message = ADBUsbMessage::new(
|
||||
USBCommand::Open,
|
||||
rng.gen(), /* Our 'local-id' */
|
||||
0,
|
||||
sync_directive.into(),
|
||||
);
|
||||
let message = self.send_and_expect_okay(message)?;
|
||||
let local_id = message.header().arg1();
|
||||
let remote_id = message.header().arg0();
|
||||
Ok((local_id, remote_id))
|
||||
}
|
||||
|
||||
pub(crate) fn stat_with_explicit_ids(
|
||||
&mut self,
|
||||
remote_path: &str,
|
||||
local_id: u32,
|
||||
remote_id: u32,
|
||||
) -> Result<AdbStatResponse> {
|
||||
let stat_buffer = USBSubcommand::Stat.with_arg(remote_path.len() as u32);
|
||||
let message = ADBUsbMessage::new(
|
||||
USBCommand::Write,
|
||||
local_id,
|
||||
remote_id,
|
||||
bincode::serialize(&stat_buffer).map_err(|_e| RustADBError::ConversionError)?,
|
||||
);
|
||||
self.send_and_expect_okay(message)?;
|
||||
self.send_and_expect_okay(ADBUsbMessage::new(
|
||||
USBCommand::Write,
|
||||
local_id,
|
||||
remote_id,
|
||||
remote_path.into(),
|
||||
))?;
|
||||
let response = self.transport.read_message()?;
|
||||
// Skip first 4 bytes as this is the literal "STAT".
|
||||
// Interesting part starts right after
|
||||
bincode::deserialize(&response.into_payload()[4..])
|
||||
.map_err(|_e| RustADBError::ConversionError)
|
||||
}
|
||||
|
||||
pub(crate) fn end_transaction(&mut self, local_id: u32, remote_id: u32) -> Result<()> {
|
||||
let quit_buffer = USBSubcommand::Quit.with_arg(0u32);
|
||||
self.send_and_expect_okay(ADBUsbMessage::new(
|
||||
USBCommand::Write,
|
||||
local_id,
|
||||
remote_id,
|
||||
bincode::serialize(&quit_buffer).map_err(|_e| RustADBError::ConversionError)?,
|
||||
))?;
|
||||
let _discard_close = self.transport.read_message()?;
|
||||
Ok(())
|
||||
}
|
||||
}
|
||||
|
||||
impl Drop for ADBUSBDevice {
|
||||
fn drop(&mut self) {
|
||||
// Best effort here
|
||||
let _ = self.transport.disconnect();
|
||||
}
|
||||
}
|
||||
@@ -1,245 +0,0 @@
|
||||
use crate::{
|
||||
models::AdbStatResponse,
|
||||
usb::{ADBUsbMessage, USBCommand, USBSubcommand},
|
||||
utils::check_extension_is_apk,
|
||||
ADBDeviceExt, ADBUSBDevice, RebootType, Result, RustADBError,
|
||||
};
|
||||
use rand::Rng;
|
||||
use std::{
|
||||
fs::File,
|
||||
io::{Read, Write},
|
||||
};
|
||||
|
||||
use super::{USBShellWriter, USBWriter};
|
||||
|
||||
impl ADBDeviceExt for ADBUSBDevice {
|
||||
fn shell_command<S: ToString, W: Write>(
|
||||
&mut self,
|
||||
command: impl IntoIterator<Item = S>,
|
||||
mut output: W,
|
||||
) -> Result<()> {
|
||||
let message = ADBUsbMessage::new(
|
||||
USBCommand::Open,
|
||||
1,
|
||||
0,
|
||||
format!(
|
||||
"shell:{}\0",
|
||||
command
|
||||
.into_iter()
|
||||
.map(|v| v.to_string())
|
||||
.collect::<Vec<_>>()
|
||||
.join(" "),
|
||||
)
|
||||
.as_bytes()
|
||||
.to_vec(),
|
||||
);
|
||||
self.transport.write_message(message)?;
|
||||
|
||||
let response = self.transport.read_message()?;
|
||||
if response.header().command() != USBCommand::Okay {
|
||||
return Err(RustADBError::ADBRequestFailed(format!(
|
||||
"wrong command {}",
|
||||
response.header().command()
|
||||
)));
|
||||
}
|
||||
|
||||
loop {
|
||||
let response = self.transport.read_message()?;
|
||||
if response.header().command() != USBCommand::Write {
|
||||
break;
|
||||
}
|
||||
|
||||
output.write_all(&response.into_payload())?;
|
||||
}
|
||||
|
||||
Ok(())
|
||||
}
|
||||
|
||||
fn shell<R: Read, W: Write + Send + 'static>(
|
||||
&mut self,
|
||||
mut reader: R,
|
||||
mut writer: W,
|
||||
) -> Result<()> {
|
||||
let sync_directive = "shell:\0";
|
||||
|
||||
let mut rng = rand::thread_rng();
|
||||
let message = ADBUsbMessage::new(
|
||||
USBCommand::Open,
|
||||
rng.gen(), /* Our 'local-id' */
|
||||
0,
|
||||
sync_directive.into(),
|
||||
);
|
||||
let message = self.send_and_expect_okay(message)?;
|
||||
let local_id = message.header().arg1();
|
||||
let remote_id = message.header().arg0();
|
||||
|
||||
let mut transport = self.transport.clone();
|
||||
|
||||
// Reading thread, reads response from adbd
|
||||
std::thread::spawn(move || -> Result<()> {
|
||||
loop {
|
||||
let message = transport.read_message()?;
|
||||
|
||||
// Acknowledge for more data
|
||||
let response = ADBUsbMessage::new(USBCommand::Okay, local_id, remote_id, vec![]);
|
||||
transport.write_message(response)?;
|
||||
|
||||
match message.header().command() {
|
||||
USBCommand::Write => {}
|
||||
USBCommand::Okay => continue,
|
||||
_ => return Err(RustADBError::ADBShellNotSupported),
|
||||
}
|
||||
|
||||
writer.write_all(&message.into_payload())?;
|
||||
writer.flush()?;
|
||||
}
|
||||
});
|
||||
|
||||
let mut shell_writer = USBShellWriter::new(self.transport.clone(), local_id, remote_id);
|
||||
|
||||
// Read from given reader (that could be stdin e.g), and write content to device adbd
|
||||
if let Err(e) = std::io::copy(&mut reader, &mut shell_writer) {
|
||||
match e.kind() {
|
||||
std::io::ErrorKind::BrokenPipe => return Ok(()),
|
||||
_ => return Err(RustADBError::IOError(e)),
|
||||
}
|
||||
}
|
||||
|
||||
Ok(())
|
||||
}
|
||||
|
||||
fn stat(&mut self, remote_path: &str) -> Result<AdbStatResponse> {
|
||||
let (local_id, remote_id) = self.begin_synchronization()?;
|
||||
let adb_stat_response = self.stat_with_explicit_ids(remote_path, local_id, remote_id)?;
|
||||
self.end_transaction(local_id, remote_id)?;
|
||||
Ok(adb_stat_response)
|
||||
}
|
||||
|
||||
fn pull<A: AsRef<str>, W: Write>(&mut self, source: A, output: W) -> Result<()> {
|
||||
let (local_id, remote_id) = self.begin_synchronization()?;
|
||||
let source = source.as_ref();
|
||||
|
||||
let adb_stat_response = self.stat_with_explicit_ids(source, local_id, remote_id)?;
|
||||
self.transport.write_message(ADBUsbMessage::new(
|
||||
USBCommand::Okay,
|
||||
local_id,
|
||||
remote_id,
|
||||
"".into(),
|
||||
))?;
|
||||
|
||||
log::debug!("{:?}", adb_stat_response);
|
||||
if adb_stat_response.file_perm == 0 {
|
||||
return Err(RustADBError::UnknownResponseType(
|
||||
"mode is 0: source file does not exist".to_string(),
|
||||
));
|
||||
}
|
||||
|
||||
let recv_buffer = USBSubcommand::Recv.with_arg(source.len() as u32);
|
||||
let recv_buffer =
|
||||
bincode::serialize(&recv_buffer).map_err(|_e| RustADBError::ConversionError)?;
|
||||
self.send_and_expect_okay(ADBUsbMessage::new(
|
||||
USBCommand::Write,
|
||||
local_id,
|
||||
remote_id,
|
||||
recv_buffer,
|
||||
))?;
|
||||
self.send_and_expect_okay(ADBUsbMessage::new(
|
||||
USBCommand::Write,
|
||||
local_id,
|
||||
remote_id,
|
||||
source.into(),
|
||||
))?;
|
||||
|
||||
self.recv_file(local_id, remote_id, output)?;
|
||||
self.end_transaction(local_id, remote_id)?;
|
||||
Ok(())
|
||||
}
|
||||
|
||||
fn push<R: Read, A: AsRef<str>>(&mut self, stream: R, path: A) -> Result<()> {
|
||||
let (local_id, remote_id) = self.begin_synchronization()?;
|
||||
|
||||
let path_header = format!("{},0777", path.as_ref());
|
||||
|
||||
let send_buffer = USBSubcommand::Send.with_arg(path_header.len() as u32);
|
||||
let mut send_buffer =
|
||||
bincode::serialize(&send_buffer).map_err(|_e| RustADBError::ConversionError)?;
|
||||
send_buffer.append(&mut path_header.as_bytes().to_vec());
|
||||
|
||||
self.send_and_expect_okay(ADBUsbMessage::new(
|
||||
USBCommand::Write,
|
||||
local_id,
|
||||
remote_id,
|
||||
send_buffer,
|
||||
))?;
|
||||
|
||||
self.push_file(local_id, remote_id, stream)?;
|
||||
|
||||
self.end_transaction(local_id, remote_id)?;
|
||||
|
||||
Ok(())
|
||||
}
|
||||
|
||||
fn reboot(&mut self, reboot_type: RebootType) -> Result<()> {
|
||||
let mut rng = rand::thread_rng();
|
||||
|
||||
let message = ADBUsbMessage::new(
|
||||
USBCommand::Open,
|
||||
rng.gen(), // Our 'local-id'
|
||||
0,
|
||||
format!("reboot:{}\0", reboot_type).as_bytes().to_vec(),
|
||||
);
|
||||
self.transport.write_message(message)?;
|
||||
|
||||
let message = self.transport.read_message()?;
|
||||
|
||||
if message.header().command() != USBCommand::Okay {
|
||||
return Err(RustADBError::ADBShellNotSupported);
|
||||
}
|
||||
|
||||
Ok(())
|
||||
}
|
||||
|
||||
fn install<P: AsRef<std::path::Path>>(&mut self, apk_path: P) -> Result<()> {
|
||||
let mut apk_file = File::open(&apk_path)?;
|
||||
|
||||
check_extension_is_apk(&apk_path)?;
|
||||
|
||||
let file_size = apk_file.metadata()?.len();
|
||||
|
||||
let mut rng = rand::thread_rng();
|
||||
|
||||
let local_id = rng.gen();
|
||||
|
||||
let message = ADBUsbMessage::new(
|
||||
USBCommand::Open,
|
||||
local_id,
|
||||
0,
|
||||
format!("exec:cmd package 'install' -S {}\0", file_size)
|
||||
.as_bytes()
|
||||
.to_vec(),
|
||||
);
|
||||
self.transport.write_message(message)?;
|
||||
|
||||
let response = self.transport.read_message()?;
|
||||
let remote_id = response.header().arg0();
|
||||
|
||||
let mut writer = USBWriter::new(self.transport.clone(), local_id, remote_id);
|
||||
|
||||
std::io::copy(&mut apk_file, &mut writer)?;
|
||||
|
||||
let final_status = self.transport.read_message()?;
|
||||
|
||||
match final_status.into_payload().as_slice() {
|
||||
b"Success\n" => {
|
||||
log::info!(
|
||||
"APK file {} successfully installed",
|
||||
apk_path.as_ref().display()
|
||||
);
|
||||
Ok(())
|
||||
}
|
||||
d => Err(crate::RustADBError::ADBRequestFailed(String::from_utf8(
|
||||
d.to_vec(),
|
||||
)?)),
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -1,14 +0,0 @@
|
||||
mod adb_rsa_key;
|
||||
mod adb_usb_device;
|
||||
mod adb_usb_device_commands;
|
||||
mod adb_usb_message;
|
||||
mod usb_commands;
|
||||
mod usb_shell_writer;
|
||||
mod usb_writer;
|
||||
|
||||
pub use adb_rsa_key::ADBRsaKey;
|
||||
pub use adb_usb_device::ADBUSBDevice;
|
||||
pub use adb_usb_message::{ADBUsbMessage, ADBUsbMessageHeader};
|
||||
pub use usb_commands::{USBCommand, USBSubcommand};
|
||||
pub use usb_shell_writer::USBShellWriter;
|
||||
pub use usb_writer::USBWriter;
|
||||
Reference in New Issue
Block a user