Compare commits
1 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
6210a6a587 |
49
.github/workflows/python-build.yml
vendored
49
.github/workflows/python-build.yml
vendored
@@ -1,49 +0,0 @@
|
|||||||
name: Python - Build packages & Release
|
|
||||||
|
|
||||||
on:
|
|
||||||
push: {}
|
|
||||||
pull_request: {}
|
|
||||||
release:
|
|
||||||
types: [created]
|
|
||||||
|
|
||||||
jobs:
|
|
||||||
build-python-packages:
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
defaults:
|
|
||||||
run:
|
|
||||||
working-directory: pyadb_client
|
|
||||||
|
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@v4
|
|
||||||
|
|
||||||
- name: Install Python dependencies
|
|
||||||
run: pip install .
|
|
||||||
|
|
||||||
- name: Build Python packages
|
|
||||||
run: maturin build --release --interpreter "3.8" --interpreter "3.9" --interpreter "3.10" --interpreter "3.11" --interpreter "3.12" --interpreter "3.13"
|
|
||||||
|
|
||||||
publish-python-packages:
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
defaults:
|
|
||||||
run:
|
|
||||||
working-directory: pyadb_client
|
|
||||||
needs: [build-python-packages]
|
|
||||||
if: github.event_name == 'release' && github.event.action == 'created'
|
|
||||||
|
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@v4
|
|
||||||
|
|
||||||
- name: Install Python dependencies
|
|
||||||
run: pip install .
|
|
||||||
|
|
||||||
- name: Publish Python packages
|
|
||||||
run: maturin publish --non-interactive
|
|
||||||
env:
|
|
||||||
MATURIN_PYPI_TOKEN: ${{ secrets.MATURIN_PYPI_TOKEN }}
|
|
||||||
|
|
||||||
- name: "Publish GitHub artefacts"
|
|
||||||
uses: softprops/action-gh-release@v2
|
|
||||||
with:
|
|
||||||
files: |
|
|
||||||
target/wheels/pyadb_client*.whl
|
|
||||||
target/wheels/pyadb_client*.tar.gz
|
|
||||||
15
.github/workflows/rust-build.yml
vendored
15
.github/workflows/rust-build.yml
vendored
@@ -1,15 +0,0 @@
|
|||||||
name: Rust - Build
|
|
||||||
|
|
||||||
on: [push, pull_request]
|
|
||||||
|
|
||||||
env:
|
|
||||||
CARGO_TERM_COLOR: always
|
|
||||||
|
|
||||||
jobs:
|
|
||||||
build-release:
|
|
||||||
name: "build-release"
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@v4
|
|
||||||
- name: Build project
|
|
||||||
run: cargo build --release --all-features
|
|
||||||
42
.github/workflows/rust-quality.yml
vendored
42
.github/workflows/rust-quality.yml
vendored
@@ -1,42 +0,0 @@
|
|||||||
name: Rust - Quality
|
|
||||||
|
|
||||||
on: [push, pull_request]
|
|
||||||
|
|
||||||
env:
|
|
||||||
CARGO_TERM_COLOR: always
|
|
||||||
|
|
||||||
jobs:
|
|
||||||
clippy:
|
|
||||||
name: "clippy"
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@v4
|
|
||||||
- run: rustup component add clippy
|
|
||||||
- name: Run clippy
|
|
||||||
run: cargo clippy --all-features
|
|
||||||
|
|
||||||
fmt:
|
|
||||||
name: "fmt"
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@v4
|
|
||||||
- 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 --no-deps
|
|
||||||
env:
|
|
||||||
RUSTDOCFLAGS: "-D warnings"
|
|
||||||
|
|
||||||
tests:
|
|
||||||
name: "tests"
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@v4
|
|
||||||
- name: Run tests
|
|
||||||
run: cargo test --verbose --all-features
|
|
||||||
49
.github/workflows/rust-release.yml
vendored
49
.github/workflows/rust-release.yml
vendored
@@ -1,49 +0,0 @@
|
|||||||
name: Rust - Release creation
|
|
||||||
|
|
||||||
on:
|
|
||||||
release:
|
|
||||||
types: [created]
|
|
||||||
|
|
||||||
jobs:
|
|
||||||
create-release:
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
|
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@v4
|
|
||||||
|
|
||||||
- name: "Set up Rust"
|
|
||||||
uses: actions-rs/toolchain@v1
|
|
||||||
with:
|
|
||||||
toolchain: stable
|
|
||||||
override: true
|
|
||||||
|
|
||||||
- name: "Install dependencies"
|
|
||||||
run: |
|
|
||||||
sudo apt update
|
|
||||||
sudo apt install -y rpm
|
|
||||||
cargo install cargo-deb
|
|
||||||
cargo install cargo-generate-rpm
|
|
||||||
|
|
||||||
- name: "Publish crates"
|
|
||||||
run: |
|
|
||||||
cargo publish -p adb_client --token ${CRATES_IO_TOKEN}
|
|
||||||
cargo publish -p adb_cli --token ${CRATES_IO_TOKEN}
|
|
||||||
env:
|
|
||||||
CRATES_IO_TOKEN: ${{ secrets.CRATES_IO_TOKEN }}
|
|
||||||
|
|
||||||
- name: "build-release"
|
|
||||||
run: cargo build --all-features --release
|
|
||||||
|
|
||||||
- name: "Build DEB package"
|
|
||||||
run: cargo deb -p adb_cli
|
|
||||||
|
|
||||||
- name: "Build RPM package"
|
|
||||||
run: cargo generate-rpm -p adb_cli
|
|
||||||
|
|
||||||
- name: "Publish GitHub artefacts"
|
|
||||||
uses: softprops/action-gh-release@v2
|
|
||||||
with:
|
|
||||||
files: |
|
|
||||||
target/debian/*.deb
|
|
||||||
target/generate-rpm/*.rpm
|
|
||||||
target/release/adb_cli
|
|
||||||
6
.gitignore
vendored
6
.gitignore
vendored
@@ -1,5 +1,3 @@
|
|||||||
target
|
target
|
||||||
/Cargo.lock
|
Cargo.lock
|
||||||
/.vscode
|
.vscode
|
||||||
venv
|
|
||||||
/.mypy_cache
|
|
||||||
|
|||||||
18
Cargo.toml
18
Cargo.toml
@@ -1,23 +1,13 @@
|
|||||||
[workspace]
|
[workspace]
|
||||||
members = ["adb_cli", "adb_client", "pyadb_client"]
|
members = ["adb_cli", "adb_client"]
|
||||||
resolver = "2"
|
resolver = "2"
|
||||||
|
|
||||||
[workspace.package]
|
[workspace.package]
|
||||||
authors = ["Corentin LIAUD"]
|
|
||||||
edition = "2021"
|
edition = "2021"
|
||||||
homepage = "https://github.com/cocool97/adb_client"
|
|
||||||
keywords = ["adb", "android", "tcp", "usb"]
|
|
||||||
license = "MIT"
|
license = "MIT"
|
||||||
repository = "https://github.com/cocool97/adb_client"
|
repository = "https://github.com/cocool97/adb_client"
|
||||||
version = "2.1.4"
|
version = "1.0.5"
|
||||||
|
|
||||||
# To build locally when working on a new release
|
# To build locally when working on a new version
|
||||||
[patch.crates-io]
|
[patch.crates-io]
|
||||||
adb_client = { path = "./adb_client" }
|
adb_client = { path = "./adb_client" }
|
||||||
|
|
||||||
[profile.release]
|
|
||||||
codegen-units = 1
|
|
||||||
debug-assertions = false
|
|
||||||
lto = "thin"
|
|
||||||
opt-level = 'z'
|
|
||||||
strip = true
|
|
||||||
21
LICENSE
21
LICENSE
@@ -1,21 +0,0 @@
|
|||||||
MIT License
|
|
||||||
|
|
||||||
Copyright (c) 2023-2024 Corentin LIAUD
|
|
||||||
|
|
||||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
||||||
of this software and associated documentation files (the "Software"), to deal
|
|
||||||
in the Software without restriction, including without limitation the rights
|
|
||||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
||||||
copies of the Software, and to permit persons to whom the Software is
|
|
||||||
furnished to do so, subject to the following conditions:
|
|
||||||
|
|
||||||
The above copyright notice and this permission notice shall be included in all
|
|
||||||
copies or substantial portions of the Software.
|
|
||||||
|
|
||||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
||||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
||||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
||||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
||||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
||||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
||||||
SOFTWARE.
|
|
||||||
59
README.md
59
README.md
@@ -1,60 +1,31 @@
|
|||||||
<p align="center" style="text-align: center">
|
# Rust adb_client
|
||||||
<img src="assets/logo.png" width="33%">
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p align="center">
|
[](https://crates.io/crates/adb_client)
|
||||||
<p align="center">Android Debug Bridge (ADB) client implementation in pure Rust !</p>
|
[](https://deps.rs/repo/github/cocool97/adb_client)
|
||||||
<p align="center">
|
|
||||||
<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>
|
|
||||||
<a href="https://opensource.org/licenses/MIT">
|
|
||||||
<img alt="dependency status" src="https://img.shields.io/badge/License-MIT-yellow.svg"/>
|
|
||||||
</a>
|
|
||||||
</p>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
Main features of this library:
|
**A**ndroid **D**ebug **B**ridge (ADB) client implementation in pure Rust !
|
||||||
|
|
||||||
- Full Rust, don't use `adb *` shell commands to interact with devices
|
Main features :
|
||||||
- Supports
|
|
||||||
- Using ADB server as a proxy (standard behavior when using `adb` CLI)
|
- Full Rust, no need to use `adb *` shell commands
|
||||||
- Connecting directly to end devices (without using adb-server)
|
- Currently only support server TCP/IP protocol
|
||||||
- Over **USB**
|
|
||||||
- Over **TCP/IP**
|
|
||||||
- Implements hidden `adb` features, like `framebuffer`
|
|
||||||
- Highly configurable
|
- Highly configurable
|
||||||
- Provides wrappers to use directly from Python code
|
|
||||||
- Easy to use !
|
- Easy to use !
|
||||||
|
|
||||||
## adb_client
|
## adb_client
|
||||||
|
|
||||||
Rust library implementing both ADB protocols (server and end-devices) and providing a high-level abstraction over the many supported commands.
|
Rust library implementing ADB protocol and providing high-level abstraction over commands.
|
||||||
|
|
||||||
Improved documentation available [here](./adb_client/README.md).
|
Improved documentation [here](./adb_client/README.md).
|
||||||
|
|
||||||
## adb_cli
|
## adb_cli
|
||||||
|
|
||||||
Rust binary providing an improved version of Google's official `adb` CLI, by using `adb_client` library.
|
Rust binary providing an improved version of `adb` CLI, using `adb_client` library. Can be used as an usage example of the library.
|
||||||
Provides a "real-world" usage example of this library.
|
|
||||||
|
|
||||||
Improved documentation available [here](./adb_cli/README.md).
|
Improved documentation [here](./adb_cli/README.md).
|
||||||
|
|
||||||
## pyadb_client
|
## Missing features
|
||||||
|
|
||||||
Python wrapper using `adb_client` library to export classes usable directly from a Python environment.
|
- USB protocol (Work in progress)
|
||||||
|
|
||||||
Improved documentation available [here](./pyadb_client/README.md)
|
All pull requests are welcome !
|
||||||
|
|
||||||
## Related publications
|
|
||||||
|
|
||||||
- [Diving into ADB protocol internals (1/2)](https://www.synacktiv.com/publications/diving-into-adb-protocol-internals-12)
|
|
||||||
- [Diving into ADB protocol internals (2/2)](https://www.synacktiv.com/publications/diving-into-adb-protocol-internals-22)
|
|
||||||
|
|
||||||
Some features may still be missing, all pull requests are welcome !
|
|
||||||
|
|||||||
@@ -1,8 +1,7 @@
|
|||||||
[package]
|
[package]
|
||||||
authors.workspace = true
|
|
||||||
description = "Rust ADB (Android Debug Bridge) CLI"
|
description = "Rust ADB (Android Debug Bridge) CLI"
|
||||||
edition.workspace = true
|
edition.workspace = true
|
||||||
keywords.workspace = true
|
keywords = ["adb", "android"]
|
||||||
license.workspace = true
|
license.workspace = true
|
||||||
name = "adb_cli"
|
name = "adb_cli"
|
||||||
readme = "README.md"
|
readme = "README.md"
|
||||||
@@ -10,30 +9,8 @@ repository.workspace = true
|
|||||||
version.workspace = true
|
version.workspace = true
|
||||||
|
|
||||||
[dependencies]
|
[dependencies]
|
||||||
adb_client = { version = "^2.0.0" }
|
adb_client = { version = "1.0.5" }
|
||||||
anyhow = { version = "1.0.94" }
|
anyhow = { version = "1.0.86" }
|
||||||
clap = { version = "4.5.23", features = ["derive"] }
|
clap = { version = "4.5.17", features = ["derive"] }
|
||||||
env_logger = { version = "0.11.5" }
|
env_logger = { version = "0.11.5" }
|
||||||
log = { version = "0.4.22" }
|
log = "0.4.22"
|
||||||
|
|
||||||
[target.'cfg(unix)'.dependencies]
|
|
||||||
termios = { version = "0.3.3" }
|
|
||||||
|
|
||||||
#####################################
|
|
||||||
# Debian package build instructions #
|
|
||||||
#####################################
|
|
||||||
[package.metadata.deb]
|
|
||||||
assets = [
|
|
||||||
{ source = "target/release/adb_cli", dest = "usr/bin/", mode = "755" },
|
|
||||||
]
|
|
||||||
priority = "optional"
|
|
||||||
section = "utility"
|
|
||||||
|
|
||||||
##################################
|
|
||||||
# RPM package build instructions #
|
|
||||||
##################################
|
|
||||||
[package.metadata.generate-rpm]
|
|
||||||
assets = [
|
|
||||||
{ source = "target/release/adb_cli", dest = "/usr/bin/adb_cli", mode = "755" },
|
|
||||||
]
|
|
||||||
license = "MIT"
|
|
||||||
|
|||||||
@@ -15,53 +15,37 @@ cargo install adb_cli
|
|||||||
|
|
||||||
Usage is quite simple, and tends to look like `adb`:
|
Usage is quite simple, and tends to look like `adb`:
|
||||||
|
|
||||||
- To use ADB server as a proxy:
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
user@laptop ~/adb_client (main)> adb_cli local --help
|
user@laptop ~/adb_client (main)> adb_cli --help
|
||||||
Device related commands using server
|
Rust ADB (Android Debug Bridge) CLI
|
||||||
|
|
||||||
Usage: adb_cli local [OPTIONS] <COMMAND>
|
Usage: adb_cli [OPTIONS] <COMMAND>
|
||||||
|
|
||||||
Commands:
|
Commands:
|
||||||
shell Spawn an interactive shell or run a list of commands on the device
|
|
||||||
pull Pull a file from device
|
|
||||||
push Push a file on device
|
|
||||||
stat Stat a file on device
|
|
||||||
run Run an activity on device specified by the intent
|
|
||||||
reboot Reboot the device
|
|
||||||
install Install an APK on device
|
|
||||||
framebuffer Dump framebuffer of device
|
|
||||||
host-features List available server features
|
host-features List available server features
|
||||||
|
push Push a file on device
|
||||||
|
pull Pull a file from device
|
||||||
list List a directory on device
|
list List a directory on device
|
||||||
|
stat Stat a file specified on device
|
||||||
|
shell Spawn an interactive shell or run a list of commands on the device
|
||||||
|
reboot Reboot the device
|
||||||
|
framebuffer Dump framebuffer of device
|
||||||
logcat Get logs of device
|
logcat Get logs of device
|
||||||
|
version Print current ADB version
|
||||||
|
kill Ask ADB server to quit immediately
|
||||||
|
devices List connected devices
|
||||||
|
track-devices Track new devices showing up
|
||||||
|
pair Pair device with a given code
|
||||||
|
connect Connect device over WI-FI
|
||||||
|
disconnect Disconnect device over WI-FI
|
||||||
|
sms Send a SMS with given phone number and given content
|
||||||
|
rotate Rotate device screen from 90°
|
||||||
help Print this message or the help of the given subcommand(s)
|
help Print this message or the help of the given subcommand(s)
|
||||||
|
|
||||||
Options:
|
Options:
|
||||||
|
-d, --debug
|
||||||
-a, --address <ADDRESS> [default: 127.0.0.1:5037]
|
-a, --address <ADDRESS> [default: 127.0.0.1:5037]
|
||||||
-s, --serial <SERIAL> Serial id of a specific device. Every request will be sent to this device
|
-s, --serial <SERIAL> Serial id of a specific device. Every request will be sent to this device
|
||||||
-h, --help Print help
|
-h, --help Print help
|
||||||
|
-V, --version Print version
|
||||||
```
|
```
|
||||||
|
|
||||||
- To interact directly with end devices
|
|
||||||
|
|
||||||
```bash
|
|
||||||
user@laptop ~/adb_client (main)> adb_cli usb --help
|
|
||||||
Device commands via USB, no server needed
|
|
||||||
|
|
||||||
Usage: adb_cli usb [OPTIONS] --vendor-id <VID> --product-id <PID> <COMMAND>
|
|
||||||
|
|
||||||
Commands:
|
|
||||||
shell Spawn an interactive shell or run a list of commands on the device
|
|
||||||
pull Pull a file from device
|
|
||||||
push Push a file on device
|
|
||||||
stat Stat a file on device
|
|
||||||
reboot Reboot the device
|
|
||||||
help Print this message or the help of the given subcommand(s)
|
|
||||||
|
|
||||||
Options:
|
|
||||||
-v, --vendor-id <VID> Hexadecimal vendor id of this USB device
|
|
||||||
-p, --product-id <PID> Hexadecimal product id of this USB device
|
|
||||||
-k, --private-key <PATH_TO_PRIVATE_KEY> Path to a custom private key to use for authentication
|
|
||||||
-h, --help Print help
|
|
||||||
```
|
|
||||||
12
adb_cli/src/commands/emu.rs
Normal file
12
adb_cli/src/commands/emu.rs
Normal file
@@ -0,0 +1,12 @@
|
|||||||
|
use clap::Parser;
|
||||||
|
|
||||||
|
#[derive(Parser, Debug)]
|
||||||
|
pub enum EmuCommand {
|
||||||
|
/// Send a SMS with given phone number and given content
|
||||||
|
Sms {
|
||||||
|
phone_number: String,
|
||||||
|
content: String,
|
||||||
|
},
|
||||||
|
/// Rotate device screen from 90°
|
||||||
|
Rotate,
|
||||||
|
}
|
||||||
@@ -16,24 +16,9 @@ pub enum HostCommand {
|
|||||||
/// Track new devices showing up.
|
/// Track new devices showing up.
|
||||||
TrackDevices,
|
TrackDevices,
|
||||||
/// Pair device with a given code
|
/// Pair device with a given code
|
||||||
Pair { address: SocketAddrV4, code: String },
|
Pair { address: SocketAddrV4, code: u32 },
|
||||||
/// Connect device over WI-FI
|
/// Connect device over WI-FI
|
||||||
Connect { address: SocketAddrV4 },
|
Connect { address: SocketAddrV4 },
|
||||||
/// Disconnect device over WI-FI
|
/// Disconnect device over WI-FI
|
||||||
Disconnect { address: SocketAddrV4 },
|
Disconnect { address: SocketAddrV4 },
|
||||||
/// MDNS services
|
|
||||||
Mdns {
|
|
||||||
#[clap(subcommand)]
|
|
||||||
subcommand: MdnsCommand,
|
|
||||||
},
|
|
||||||
/// Display server status
|
|
||||||
ServerStatus,
|
|
||||||
}
|
|
||||||
|
|
||||||
#[derive(Parser, Debug)]
|
|
||||||
pub enum MdnsCommand {
|
|
||||||
/// Check mdns status
|
|
||||||
Check,
|
|
||||||
/// List mdns services available
|
|
||||||
Services,
|
|
||||||
}
|
}
|
||||||
31
adb_cli/src/commands/local.rs
Normal file
31
adb_cli/src/commands/local.rs
Normal file
@@ -0,0 +1,31 @@
|
|||||||
|
use clap::Parser;
|
||||||
|
|
||||||
|
use crate::models::RebootTypeCommand;
|
||||||
|
|
||||||
|
#[derive(Parser, Debug)]
|
||||||
|
pub enum LocalCommand {
|
||||||
|
/// List available server features.
|
||||||
|
HostFeatures,
|
||||||
|
/// Push a file on device
|
||||||
|
Push { filename: String, path: String },
|
||||||
|
/// Pull a file from device
|
||||||
|
Pull { path: String, filename: String },
|
||||||
|
/// List a directory on device
|
||||||
|
List { path: String },
|
||||||
|
/// Stat a file specified on device
|
||||||
|
Stat { path: String },
|
||||||
|
/// Spawn an interactive shell or run a list of commands on the device
|
||||||
|
Shell { command: Vec<String> },
|
||||||
|
/// Reboot the device
|
||||||
|
Reboot {
|
||||||
|
#[clap(subcommand)]
|
||||||
|
sub_command: RebootTypeCommand,
|
||||||
|
},
|
||||||
|
/// Dump framebuffer of device
|
||||||
|
Framebuffer { path: String },
|
||||||
|
/// Get logs of device
|
||||||
|
Logcat {
|
||||||
|
/// Path to output file (created if not exists)
|
||||||
|
path: Option<String>,
|
||||||
|
},
|
||||||
|
}
|
||||||
7
adb_cli/src/commands/mod.rs
Normal file
7
adb_cli/src/commands/mod.rs
Normal file
@@ -0,0 +1,7 @@
|
|||||||
|
mod emu;
|
||||||
|
mod host;
|
||||||
|
mod local;
|
||||||
|
|
||||||
|
pub use emu::EmuCommand;
|
||||||
|
pub use host::HostCommand;
|
||||||
|
pub use local::LocalCommand;
|
||||||
@@ -1,20 +0,0 @@
|
|||||||
use adb_client::ADBEmulatorDevice;
|
|
||||||
|
|
||||||
use crate::models::{EmuCommand, EmulatorCommand};
|
|
||||||
|
|
||||||
pub fn handle_emulator_commands(emulator_command: EmulatorCommand) -> anyhow::Result<()> {
|
|
||||||
let mut emulator = ADBEmulatorDevice::new(emulator_command.serial, None)?;
|
|
||||||
|
|
||||||
match emulator_command.command {
|
|
||||||
EmuCommand::Sms {
|
|
||||||
phone_number,
|
|
||||||
content,
|
|
||||||
} => {
|
|
||||||
emulator.send_sms(&phone_number, &content)?;
|
|
||||||
log::info!("SMS sent to {phone_number}");
|
|
||||||
}
|
|
||||||
EmuCommand::Rotate => emulator.rotate()?,
|
|
||||||
}
|
|
||||||
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
@@ -1,78 +0,0 @@
|
|||||||
use adb_client::{ADBServer, DeviceShort, MDNSBackend, Result};
|
|
||||||
|
|
||||||
use crate::models::{HostCommand, MdnsCommand, ServerCommand};
|
|
||||||
|
|
||||||
pub fn handle_host_commands(server_command: ServerCommand<HostCommand>) -> Result<()> {
|
|
||||||
let mut adb_server = ADBServer::new(server_command.address);
|
|
||||||
|
|
||||||
match server_command.command {
|
|
||||||
HostCommand::Version => {
|
|
||||||
let version = adb_server.version()?;
|
|
||||||
log::info!("Android Debug Bridge version {}", version);
|
|
||||||
log::info!("Package version {}-rust", std::env!("CARGO_PKG_VERSION"));
|
|
||||||
}
|
|
||||||
HostCommand::Kill => {
|
|
||||||
adb_server.kill()?;
|
|
||||||
}
|
|
||||||
HostCommand::Devices { long } => {
|
|
||||||
if long {
|
|
||||||
log::info!("List of devices attached (extended)");
|
|
||||||
for device in adb_server.devices_long()? {
|
|
||||||
log::info!("{}", device);
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
log::info!("List of devices attached");
|
|
||||||
for device in adb_server.devices()? {
|
|
||||||
log::info!("{}", device);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
HostCommand::TrackDevices => {
|
|
||||||
let callback = |device: DeviceShort| {
|
|
||||||
log::info!("{}", device);
|
|
||||||
Ok(())
|
|
||||||
};
|
|
||||||
log::info!("Live list of devices attached");
|
|
||||||
adb_server.track_devices(callback)?;
|
|
||||||
}
|
|
||||||
HostCommand::Pair { address, code } => {
|
|
||||||
adb_server.pair(address, code)?;
|
|
||||||
log::info!("Paired device {address}");
|
|
||||||
}
|
|
||||||
HostCommand::Connect { address } => {
|
|
||||||
adb_server.connect_device(address)?;
|
|
||||||
log::info!("Connected to {address}");
|
|
||||||
}
|
|
||||||
HostCommand::Disconnect { address } => {
|
|
||||||
adb_server.disconnect_device(address)?;
|
|
||||||
log::info!("Disconnected {address}");
|
|
||||||
}
|
|
||||||
HostCommand::Mdns { subcommand } => match subcommand {
|
|
||||||
MdnsCommand::Check => {
|
|
||||||
let check = adb_server.mdns_check()?;
|
|
||||||
let server_status = adb_server.server_status()?;
|
|
||||||
match server_status.mdns_backend {
|
|
||||||
MDNSBackend::Unknown => log::info!("unknown mdns backend..."),
|
|
||||||
MDNSBackend::Bonjour => match check {
|
|
||||||
true => log::info!("mdns daemon version [Bonjour]"),
|
|
||||||
false => log::info!("ERROR: mdns daemon unavailable"),
|
|
||||||
},
|
|
||||||
MDNSBackend::OpenScreen => {
|
|
||||||
log::info!("mdns daemon version [Openscreen discovery 0.0.0]")
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
MdnsCommand::Services => {
|
|
||||||
log::info!("List of discovered mdns services");
|
|
||||||
for service in adb_server.mdns_services()? {
|
|
||||||
log::info!("{}", service);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
},
|
|
||||||
HostCommand::ServerStatus => {
|
|
||||||
log::info!("{}", adb_server.server_status()?);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
@@ -1,35 +0,0 @@
|
|||||||
use std::{fs::File, io::Write};
|
|
||||||
|
|
||||||
use adb_client::ADBServerDevice;
|
|
||||||
use anyhow::{anyhow, Result};
|
|
||||||
|
|
||||||
use crate::models::LocalDeviceCommand;
|
|
||||||
|
|
||||||
pub fn handle_local_commands(
|
|
||||||
mut device: ADBServerDevice,
|
|
||||||
local_device_commands: LocalDeviceCommand,
|
|
||||||
) -> Result<()> {
|
|
||||||
match local_device_commands {
|
|
||||||
LocalDeviceCommand::HostFeatures => {
|
|
||||||
let features = device
|
|
||||||
.host_features()?
|
|
||||||
.iter()
|
|
||||||
.map(|v| v.to_string())
|
|
||||||
.reduce(|a, b| format!("{a},{b}"))
|
|
||||||
.ok_or(anyhow!("cannot list features"))?;
|
|
||||||
log::info!("Available host features: {features}");
|
|
||||||
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
LocalDeviceCommand::List { path } => Ok(device.list(path)?),
|
|
||||||
LocalDeviceCommand::Logcat { path } => {
|
|
||||||
let writer: Box<dyn Write> = if let Some(path) = path {
|
|
||||||
let f = File::create(path)?;
|
|
||||||
Box::new(f)
|
|
||||||
} else {
|
|
||||||
Box::new(std::io::stdout())
|
|
||||||
};
|
|
||||||
Ok(device.get_logs(writer)?)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
mod emulator_commands;
|
|
||||||
mod host_commands;
|
|
||||||
mod local_commands;
|
|
||||||
|
|
||||||
pub use emulator_commands::handle_emulator_commands;
|
|
||||||
pub use host_commands::handle_host_commands;
|
|
||||||
pub use local_commands::handle_local_commands;
|
|
||||||
@@ -1,142 +1,155 @@
|
|||||||
#![doc = include_str!("../README.md")]
|
mod commands;
|
||||||
|
|
||||||
#[cfg(any(target_os = "linux", target_os = "macos"))]
|
|
||||||
mod adb_termios;
|
|
||||||
|
|
||||||
mod handlers;
|
|
||||||
mod models;
|
mod models;
|
||||||
mod utils;
|
|
||||||
|
|
||||||
use adb_client::{ADBDeviceExt, ADBServer, ADBTcpDevice, ADBUSBDevice, MDNSDiscoveryService};
|
use adb_client::{ADBEmulatorDevice, ADBServer, DeviceShort};
|
||||||
use adb_termios::ADBTermios;
|
use anyhow::{anyhow, Result};
|
||||||
use anyhow::Result;
|
|
||||||
use clap::Parser;
|
use clap::Parser;
|
||||||
use handlers::{handle_emulator_commands, handle_host_commands, handle_local_commands};
|
use commands::{EmuCommand, HostCommand, LocalCommand};
|
||||||
use models::{DeviceCommands, LocalCommand, MainCommand, Opts};
|
use env_logger::Builder;
|
||||||
|
use log::LevelFilter;
|
||||||
|
use models::{Command, Opts};
|
||||||
use std::fs::File;
|
use std::fs::File;
|
||||||
use std::io::Write;
|
use std::io::Write;
|
||||||
use std::path::Path;
|
use std::path::Path;
|
||||||
use utils::setup_logger;
|
|
||||||
|
|
||||||
fn main() -> Result<()> {
|
fn main() -> Result<()> {
|
||||||
let opts = Opts::parse();
|
let opt = Opts::parse();
|
||||||
|
|
||||||
setup_logger(opts.debug);
|
let max_level = if opt.verbose {
|
||||||
|
LevelFilter::Trace
|
||||||
|
} else {
|
||||||
|
LevelFilter::Info
|
||||||
|
};
|
||||||
|
let mut builder = Builder::default();
|
||||||
|
builder.filter_level(max_level);
|
||||||
|
builder.init();
|
||||||
|
|
||||||
// Directly handling methods / commands that aren't linked to [`ADBDeviceExt`] trait.
|
match opt.command {
|
||||||
// Other methods just have to create a concrete [`ADBDeviceExt`] instance, and return it.
|
Command::Local(local) => {
|
||||||
// This instance will then be used to execute desired command.
|
let mut adb_server = ADBServer::new(opt.address);
|
||||||
let (mut device, commands) = match opts.command {
|
|
||||||
MainCommand::Host(server_command) => return Ok(handle_host_commands(server_command)?),
|
|
||||||
MainCommand::Emu(emulator_command) => return handle_emulator_commands(emulator_command),
|
|
||||||
MainCommand::Local(server_command) => {
|
|
||||||
let mut adb_server = ADBServer::new(server_command.address);
|
|
||||||
|
|
||||||
let device = match server_command.serial {
|
let mut device = match opt.serial {
|
||||||
Some(serial) => adb_server.get_device_by_name(&serial)?,
|
Some(serial) => adb_server.get_device_by_name(&serial)?,
|
||||||
None => adb_server.get_device()?,
|
None => adb_server.get_device()?,
|
||||||
};
|
};
|
||||||
|
|
||||||
match server_command.command {
|
match local {
|
||||||
LocalCommand::DeviceCommands(device_commands) => (device.boxed(), device_commands),
|
LocalCommand::Pull { path, filename } => {
|
||||||
LocalCommand::LocalDeviceCommand(local_device_command) => {
|
let mut output = File::create(Path::new(&filename))?;
|
||||||
return handle_local_commands(device, local_device_command)
|
device.recv(&path, &mut output)?;
|
||||||
|
log::info!("Downloaded {path} as {filename}");
|
||||||
|
}
|
||||||
|
LocalCommand::Push { filename, path } => {
|
||||||
|
let mut input = File::open(Path::new(&filename))?;
|
||||||
|
device.send(&mut input, &path)?;
|
||||||
|
log::info!("Uploaded {filename} to {path}");
|
||||||
|
}
|
||||||
|
LocalCommand::List { path } => {
|
||||||
|
device.list(path)?;
|
||||||
|
}
|
||||||
|
LocalCommand::Stat { path } => {
|
||||||
|
let stat_response = device.stat(path)?;
|
||||||
|
log::info!("{}", stat_response);
|
||||||
|
}
|
||||||
|
LocalCommand::Shell { command } => {
|
||||||
|
if command.is_empty() {
|
||||||
|
device.shell()?;
|
||||||
|
} else {
|
||||||
|
device.shell_command(command, std::io::stdout())?;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
LocalCommand::HostFeatures => {
|
||||||
|
let features = device
|
||||||
|
.host_features()?
|
||||||
|
.iter()
|
||||||
|
.map(|v| v.to_string())
|
||||||
|
.reduce(|a, b| format!("{a},{b}"))
|
||||||
|
.ok_or(anyhow!("cannot list features"))?;
|
||||||
|
log::info!("Available host features: {features}");
|
||||||
|
}
|
||||||
|
LocalCommand::Reboot { sub_command } => {
|
||||||
|
log::info!("Reboots device");
|
||||||
|
device.reboot(sub_command.into())?
|
||||||
|
}
|
||||||
|
LocalCommand::Framebuffer { path } => {
|
||||||
|
device.framebuffer(&path)?;
|
||||||
|
log::info!("Framebuffer dropped: {path}");
|
||||||
|
}
|
||||||
|
LocalCommand::Logcat { path } => {
|
||||||
|
let writer: Box<dyn Write> = if let Some(path) = path {
|
||||||
|
let f = File::create(path)?;
|
||||||
|
Box::new(f)
|
||||||
|
} else {
|
||||||
|
Box::new(std::io::stdout())
|
||||||
|
};
|
||||||
|
device.get_logs(writer)?;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
MainCommand::Usb(usb_command) => {
|
Command::Host(host) => {
|
||||||
let device = match (usb_command.vendor_id, usb_command.product_id) {
|
let mut adb_server = ADBServer::new(opt.address);
|
||||||
(Some(vid), Some(pid)) => match usb_command.path_to_private_key {
|
|
||||||
Some(pk) => ADBUSBDevice::new_with_custom_private_key(vid, pid, pk)?,
|
match host {
|
||||||
None => ADBUSBDevice::new(vid, pid)?,
|
HostCommand::Version => {
|
||||||
},
|
let version = adb_server.version()?;
|
||||||
(None, None) => match usb_command.path_to_private_key {
|
log::info!("Android Debug Bridge version {}", version);
|
||||||
Some(pk) => ADBUSBDevice::autodetect_with_custom_private_key(pk)?,
|
log::info!("Package version {}-rust", std::env!("CARGO_PKG_VERSION"));
|
||||||
None => ADBUSBDevice::autodetect()?,
|
|
||||||
},
|
|
||||||
_ => {
|
|
||||||
anyhow::bail!("please either supply values for both the --vendor-id and --product-id flags or none.");
|
|
||||||
}
|
}
|
||||||
|
HostCommand::Kill => {
|
||||||
|
adb_server.kill()?;
|
||||||
|
}
|
||||||
|
HostCommand::Devices { long } => {
|
||||||
|
if long {
|
||||||
|
log::info!("List of devices attached (extended)");
|
||||||
|
for device in adb_server.devices_long()? {
|
||||||
|
log::info!("{}", device);
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
log::info!("List of devices attached");
|
||||||
|
for device in adb_server.devices()? {
|
||||||
|
log::info!("{}", device);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
HostCommand::TrackDevices => {
|
||||||
|
let callback = |device: DeviceShort| {
|
||||||
|
log::info!("{}", device);
|
||||||
|
Ok(())
|
||||||
|
};
|
||||||
|
log::info!("Live list of devices attached");
|
||||||
|
adb_server.track_devices(callback)?;
|
||||||
|
}
|
||||||
|
HostCommand::Pair { address, code } => {
|
||||||
|
adb_server.pair(address, code)?;
|
||||||
|
log::info!("Paired device {address}");
|
||||||
|
}
|
||||||
|
HostCommand::Connect { address } => {
|
||||||
|
adb_server.connect_device(address)?;
|
||||||
|
log::info!("Connected to {address}");
|
||||||
|
}
|
||||||
|
HostCommand::Disconnect { address } => {
|
||||||
|
adb_server.disconnect_device(address)?;
|
||||||
|
log::info!("Disconnected {address}");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
Command::Emu(emu) => {
|
||||||
|
let mut emulator = match opt.serial {
|
||||||
|
Some(serial) => ADBEmulatorDevice::new(serial, None)?,
|
||||||
|
None => return Err(anyhow!("Serial must be set to use emulators !")),
|
||||||
};
|
};
|
||||||
(device.boxed(), usb_command.commands)
|
|
||||||
}
|
|
||||||
MainCommand::Tcp(tcp_command) => {
|
|
||||||
let device = ADBTcpDevice::new(tcp_command.address)?;
|
|
||||||
(device.boxed(), tcp_command.commands)
|
|
||||||
}
|
|
||||||
MainCommand::Mdns => {
|
|
||||||
let mut service = MDNSDiscoveryService::new()?;
|
|
||||||
|
|
||||||
let (tx, rx) = std::sync::mpsc::channel();
|
match emu {
|
||||||
service.start(tx)?;
|
EmuCommand::Sms {
|
||||||
|
phone_number,
|
||||||
log::info!("Starting mdns discovery...");
|
content,
|
||||||
while let Ok(device) = rx.recv() {
|
} => {
|
||||||
log::info!(
|
emulator.send_sms(&phone_number, &content)?;
|
||||||
"Found device {} with addresses {:?}",
|
log::info!("SMS sent to {phone_number}");
|
||||||
device.fullname,
|
|
||||||
device.addresses
|
|
||||||
)
|
|
||||||
}
|
|
||||||
|
|
||||||
return Ok(service.shutdown()?);
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
match commands {
|
|
||||||
DeviceCommands::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 = ADBTermios::new(std::io::stdin())?;
|
|
||||||
adb_termios.set_adb_termios()?;
|
|
||||||
device.shell(&mut std::io::stdin(), Box::new(std::io::stdout()))?;
|
|
||||||
}
|
}
|
||||||
|
EmuCommand::Rotate => emulator.rotate()?,
|
||||||
#[cfg(not(any(target_os = "linux", target_os = "macos")))]
|
|
||||||
{
|
|
||||||
device.shell(std::io::stdin(), std::io::stdout())?;
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
let commands: Vec<&str> = commands.iter().map(|v| v.as_str()).collect();
|
|
||||||
device.shell_command(&commands, &mut std::io::stdout())?;
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
DeviceCommands::Pull {
|
|
||||||
source,
|
|
||||||
destination,
|
|
||||||
} => {
|
|
||||||
let mut output = File::create(Path::new(&destination))?;
|
|
||||||
device.pull(&source, &mut output)?;
|
|
||||||
log::info!("Downloaded {source} as {destination}");
|
|
||||||
}
|
|
||||||
DeviceCommands::Stat { path } => {
|
|
||||||
let stat_response = device.stat(&path)?;
|
|
||||||
println!("{}", stat_response);
|
|
||||||
}
|
|
||||||
DeviceCommands::Reboot { reboot_type } => {
|
|
||||||
log::info!("Reboots device in mode {:?}", reboot_type);
|
|
||||||
device.reboot(reboot_type.into())?
|
|
||||||
}
|
|
||||||
DeviceCommands::Push { filename, path } => {
|
|
||||||
let mut input = File::open(Path::new(&filename))?;
|
|
||||||
device.push(&mut input, &path)?;
|
|
||||||
log::info!("Uploaded {filename} to {path}");
|
|
||||||
}
|
|
||||||
DeviceCommands::Run { package, activity } => {
|
|
||||||
let output = device.run_activity(&package, &activity)?;
|
|
||||||
std::io::stdout().write_all(&output)?;
|
|
||||||
}
|
|
||||||
DeviceCommands::Install { path } => {
|
|
||||||
log::info!("Starting installation of APK {}...", path.display());
|
|
||||||
device.install(&path)?;
|
|
||||||
}
|
|
||||||
DeviceCommands::Framebuffer { path } => {
|
|
||||||
device.framebuffer(&path)?;
|
|
||||||
log::info!("Successfully dumped framebuffer at path {path}");
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
Ok(())
|
Ok(())
|
||||||
|
|||||||
@@ -1,41 +0,0 @@
|
|||||||
use std::path::PathBuf;
|
|
||||||
|
|
||||||
use clap::Parser;
|
|
||||||
|
|
||||||
use super::RebootTypeCommand;
|
|
||||||
|
|
||||||
#[derive(Parser, Debug)]
|
|
||||||
pub enum DeviceCommands {
|
|
||||||
/// 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,
|
|
||||||
},
|
|
||||||
/// Dump framebuffer of device
|
|
||||||
Framebuffer {
|
|
||||||
/// Framebuffer image destination path
|
|
||||||
path: String,
|
|
||||||
},
|
|
||||||
}
|
|
||||||
@@ -1,20 +0,0 @@
|
|||||||
use clap::{Parser, Subcommand};
|
|
||||||
|
|
||||||
#[derive(Debug, Parser)]
|
|
||||||
pub struct EmulatorCommand {
|
|
||||||
#[clap(short = 's', long = "serial")]
|
|
||||||
pub serial: String,
|
|
||||||
#[clap(subcommand)]
|
|
||||||
pub command: EmuCommand,
|
|
||||||
}
|
|
||||||
|
|
||||||
#[derive(Debug, Subcommand)]
|
|
||||||
pub enum EmuCommand {
|
|
||||||
/// Send a SMS with given phone number and given content
|
|
||||||
Sms {
|
|
||||||
phone_number: String,
|
|
||||||
content: String,
|
|
||||||
},
|
|
||||||
/// Rotate device screen from 90°
|
|
||||||
Rotate,
|
|
||||||
}
|
|
||||||
@@ -1,24 +0,0 @@
|
|||||||
use clap::Parser;
|
|
||||||
|
|
||||||
use super::DeviceCommands;
|
|
||||||
|
|
||||||
#[derive(Parser, Debug)]
|
|
||||||
pub enum LocalCommand {
|
|
||||||
#[clap(flatten)]
|
|
||||||
DeviceCommands(DeviceCommands),
|
|
||||||
#[clap(flatten)]
|
|
||||||
LocalDeviceCommand(LocalDeviceCommand),
|
|
||||||
}
|
|
||||||
|
|
||||||
#[derive(Parser, Debug)]
|
|
||||||
pub enum LocalDeviceCommand {
|
|
||||||
/// List available server features.
|
|
||||||
HostFeatures,
|
|
||||||
/// List a directory on device
|
|
||||||
List { path: String },
|
|
||||||
/// Get logs of device
|
|
||||||
Logcat {
|
|
||||||
/// Path to output file (created if not exists)
|
|
||||||
path: Option<String>,
|
|
||||||
},
|
|
||||||
}
|
|
||||||
@@ -1,17 +1,5 @@
|
|||||||
mod device;
|
|
||||||
mod emu;
|
|
||||||
mod host;
|
|
||||||
mod local;
|
|
||||||
mod opts;
|
mod opts;
|
||||||
mod reboot_type;
|
mod reboot_type;
|
||||||
mod tcp;
|
|
||||||
mod usb;
|
|
||||||
|
|
||||||
pub use device::DeviceCommands;
|
pub use opts::{Command, Opts};
|
||||||
pub use emu::{EmuCommand, EmulatorCommand};
|
|
||||||
pub use host::{HostCommand, MdnsCommand};
|
|
||||||
pub use local::{LocalCommand, LocalDeviceCommand};
|
|
||||||
pub use opts::{MainCommand, Opts, ServerCommand};
|
|
||||||
pub use reboot_type::RebootTypeCommand;
|
pub use reboot_type::RebootTypeCommand;
|
||||||
pub use tcp::TcpCommand;
|
|
||||||
pub use usb::UsbCommand;
|
|
||||||
|
|||||||
@@ -1,41 +1,29 @@
|
|||||||
use std::net::SocketAddrV4;
|
use std::net::SocketAddrV4;
|
||||||
|
|
||||||
use clap::{Parser, Subcommand};
|
use clap::Parser;
|
||||||
|
|
||||||
use super::{EmulatorCommand, HostCommand, LocalCommand, TcpCommand, UsbCommand};
|
use crate::commands::{EmuCommand, HostCommand, LocalCommand};
|
||||||
|
|
||||||
#[derive(Debug, Parser)]
|
#[derive(Parser, Debug)]
|
||||||
#[clap(about, version, author)]
|
#[clap(about, version, author)]
|
||||||
pub struct Opts {
|
pub struct Opts {
|
||||||
#[clap(long = "debug")]
|
#[clap(short = 'v', long = "verbose")]
|
||||||
pub debug: bool,
|
pub verbose: bool,
|
||||||
#[clap(subcommand)]
|
|
||||||
pub command: MainCommand,
|
|
||||||
}
|
|
||||||
|
|
||||||
#[derive(Debug, Parser)]
|
|
||||||
pub enum MainCommand {
|
|
||||||
/// Server related commands
|
|
||||||
Host(ServerCommand<HostCommand>),
|
|
||||||
/// Device related commands using server
|
|
||||||
Local(ServerCommand<LocalCommand>),
|
|
||||||
/// Emulator related commands
|
|
||||||
Emu(EmulatorCommand),
|
|
||||||
/// USB device related commands
|
|
||||||
Usb(UsbCommand),
|
|
||||||
/// TCP device related commands
|
|
||||||
Tcp(TcpCommand),
|
|
||||||
/// MDNS discovery related commands
|
|
||||||
Mdns,
|
|
||||||
}
|
|
||||||
|
|
||||||
#[derive(Debug, Parser)]
|
|
||||||
pub struct ServerCommand<T: Subcommand> {
|
|
||||||
#[clap(short = 'a', long = "address", default_value = "127.0.0.1:5037")]
|
#[clap(short = 'a', long = "address", default_value = "127.0.0.1:5037")]
|
||||||
pub address: SocketAddrV4,
|
pub address: SocketAddrV4,
|
||||||
/// Serial id of a specific device. Every request will be sent to this device.
|
/// Serial id of a specific device. Every request will be sent to this device.
|
||||||
#[clap(short = 's', long = "serial")]
|
#[clap(short = 's', long = "serial")]
|
||||||
pub serial: Option<String>,
|
pub serial: Option<String>,
|
||||||
#[clap(subcommand)]
|
#[clap(subcommand)]
|
||||||
pub command: T,
|
pub command: Command,
|
||||||
|
}
|
||||||
|
|
||||||
|
#[derive(Parser, Debug)]
|
||||||
|
pub enum Command {
|
||||||
|
#[clap(flatten)]
|
||||||
|
Local(LocalCommand),
|
||||||
|
#[clap(flatten)]
|
||||||
|
Host(HostCommand),
|
||||||
|
#[clap(flatten)]
|
||||||
|
Emu(EmuCommand),
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,11 +0,0 @@
|
|||||||
use clap::Parser;
|
|
||||||
use std::net::SocketAddr;
|
|
||||||
|
|
||||||
use super::DeviceCommands;
|
|
||||||
|
|
||||||
#[derive(Parser, Debug)]
|
|
||||||
pub struct TcpCommand {
|
|
||||||
pub address: SocketAddr,
|
|
||||||
#[clap(subcommand)]
|
|
||||||
pub commands: DeviceCommands,
|
|
||||||
}
|
|
||||||
@@ -1,25 +0,0 @@
|
|||||||
use std::num::ParseIntError;
|
|
||||||
use std::path::PathBuf;
|
|
||||||
|
|
||||||
use clap::Parser;
|
|
||||||
|
|
||||||
use super::DeviceCommands;
|
|
||||||
|
|
||||||
fn parse_hex_id(id: &str) -> Result<u16, ParseIntError> {
|
|
||||||
u16::from_str_radix(id, 16)
|
|
||||||
}
|
|
||||||
|
|
||||||
#[derive(Parser, Debug)]
|
|
||||||
pub struct UsbCommand {
|
|
||||||
/// Hexadecimal vendor id of this USB device
|
|
||||||
#[clap(short = 'v', long = "vendor-id", value_parser=parse_hex_id, value_name="VID")]
|
|
||||||
pub vendor_id: Option<u16>,
|
|
||||||
/// Hexadecimal product id of this USB device
|
|
||||||
#[clap(short = 'p', long = "product-id", value_parser=parse_hex_id, value_name="PID")]
|
|
||||||
pub product_id: Option<u16>,
|
|
||||||
/// Path to a custom private key to use for authentication
|
|
||||||
#[clap(short = 'k', long = "private-key")]
|
|
||||||
pub path_to_private_key: Option<PathBuf>,
|
|
||||||
#[clap(subcommand)]
|
|
||||||
pub commands: DeviceCommands,
|
|
||||||
}
|
|
||||||
@@ -1,13 +0,0 @@
|
|||||||
pub fn setup_logger(debug: bool) {
|
|
||||||
// RUST_LOG variable has more priority then "--debug" flag
|
|
||||||
if std::env::var("RUST_LOG").is_err() {
|
|
||||||
let level = match debug {
|
|
||||||
true => "trace",
|
|
||||||
false => "info",
|
|
||||||
};
|
|
||||||
|
|
||||||
std::env::set_var("RUST_LOG", level);
|
|
||||||
}
|
|
||||||
|
|
||||||
env_logger::init();
|
|
||||||
}
|
|
||||||
@@ -1,8 +1,7 @@
|
|||||||
[package]
|
[package]
|
||||||
authors.workspace = true
|
|
||||||
description = "Rust ADB (Android Debug Bridge) client library"
|
description = "Rust ADB (Android Debug Bridge) client library"
|
||||||
edition.workspace = true
|
edition.workspace = true
|
||||||
keywords.workspace = true
|
keywords = ["adb", "android"]
|
||||||
license.workspace = true
|
license.workspace = true
|
||||||
name = "adb_client"
|
name = "adb_client"
|
||||||
readme = "README.md"
|
readme = "README.md"
|
||||||
@@ -10,35 +9,13 @@ repository.workspace = true
|
|||||||
version.workspace = true
|
version.workspace = true
|
||||||
|
|
||||||
[dependencies]
|
[dependencies]
|
||||||
base64 = { version = "0.22.1" }
|
|
||||||
bincode = { version = "1.3.3" }
|
|
||||||
byteorder = { version = "1.5.0" }
|
byteorder = { version = "1.5.0" }
|
||||||
chrono = { version = "0.4.39" }
|
chrono = { version = "0.4.38" }
|
||||||
homedir = { version = "0.3.4" }
|
homedir = "0.3.3"
|
||||||
image = { version = "0.25.5" }
|
image = { version = "0.25.2" }
|
||||||
lazy_static = { version = "1.5.0" }
|
lazy_static = { version = "1.5.0" }
|
||||||
log = { version = "0.4.22" }
|
log = "0.4.22"
|
||||||
mdns-sd = { version = "0.13.1" }
|
mio = { version = "1.0.2", features = ["os-ext", "os-poll"] }
|
||||||
num-bigint = { version = "0.8.4", package = "num-bigint-dig" }
|
regex = { version = "1.10.6", features = ["perf", "std", "unicode"] }
|
||||||
num-traits = { version = "0.2.19" }
|
termios = { version = "0.3.3" }
|
||||||
quick-protobuf = { version = "0.8.1" }
|
thiserror = { version = "1.0.63" }
|
||||||
rand = { version = "0.8.5" }
|
|
||||||
rcgen = { version = "0.13.1" }
|
|
||||||
regex = { version = "1.11.1", features = ["perf", "std", "unicode"] }
|
|
||||||
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.216", features = ["derive"] }
|
|
||||||
serde_repr = { version = "0.1.19" }
|
|
||||||
sha1 = { version = "0.10.6", features = ["oid"] }
|
|
||||||
thiserror = { version = "2.0.7" }
|
|
||||||
|
|
||||||
[dev-dependencies]
|
|
||||||
anyhow = { version = "1.0.93" }
|
|
||||||
criterion = { version = "0.5.1" } # Used for benchmarks
|
|
||||||
|
|
||||||
[[bench]]
|
|
||||||
harness = false
|
|
||||||
name = "benchmark_adb_push"
|
|
||||||
path = "../benches/benchmark_adb_push.rs"
|
|
||||||
|
|||||||
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
[](./LICENSE-MIT)
|
[](./LICENSE-MIT)
|
||||||
[](https://docs.rs/adb_client)
|
[](https://docs.rs/adb_client)
|
||||||
[](https://crates.io/crates/adb_client)
|

|
||||||
|
|
||||||
Rust library implementing ADB protocol.
|
Rust library implementing ADB protocol.
|
||||||
|
|
||||||
@@ -15,25 +15,21 @@ Add `adb_client` crate as a dependency by simply adding it to your `Cargo.toml`:
|
|||||||
adb_client = "*"
|
adb_client = "*"
|
||||||
```
|
```
|
||||||
|
|
||||||
## Benchmarks
|
|
||||||
|
|
||||||
Benchmarks run on `v2.0.6`, on a **Samsung S10 SM-G973F** device and an **Intel i7-1265U** CPU laptop
|
|
||||||
|
|
||||||
### `ADBServerDevice` push vs `adb push`
|
|
||||||
|
|
||||||
`ADBServerDevice` performs all operations by using adb server as a bridge.
|
|
||||||
|
|
||||||
|File size|Sample size|`ADBServerDevice`|`adb`|Difference|
|
|
||||||
|:-------:|:---------:|:----------:|:---:|:-----:|
|
|
||||||
|10 MB|100|350,79 ms|356,30 ms|<div style="color:green">-1,57 %</div>|
|
|
||||||
|500 MB|50|15,60 s|15,64 s|<div style="color:green">-0,25 %</div>|
|
|
||||||
|1 GB|20|31,09 s|31,12 s|<div style="color:green">-0,10 %</div>|
|
|
||||||
|
|
||||||
## Examples
|
## Examples
|
||||||
|
|
||||||
|
### Launch a command on device via ADB server
|
||||||
|
|
||||||
|
```rust
|
||||||
|
use adb_client::ADBServer;
|
||||||
|
|
||||||
|
let mut server = ADBServer::default();
|
||||||
|
let mut device = server.get_device().expect("cannot get device");
|
||||||
|
device.shell_command(["df", "-h"]);
|
||||||
|
```
|
||||||
|
|
||||||
### Get available ADB devices
|
### Get available ADB devices
|
||||||
|
|
||||||
```rust no_run
|
```rust
|
||||||
use adb_client::ADBServer;
|
use adb_client::ADBServer;
|
||||||
use std::net::{SocketAddrV4, Ipv4Addr};
|
use std::net::{SocketAddrV4, Ipv4Addr};
|
||||||
|
|
||||||
@@ -45,21 +41,9 @@ let mut server = ADBServer::new(SocketAddrV4::new(server_ip, server_port));
|
|||||||
server.devices();
|
server.devices();
|
||||||
```
|
```
|
||||||
|
|
||||||
### Using ADB server as bridge
|
### Push a file to the device
|
||||||
|
|
||||||
#### Launch a command on device
|
```rust
|
||||||
|
|
||||||
```rust no_run
|
|
||||||
use adb_client::{ADBServer, ADBDeviceExt};
|
|
||||||
|
|
||||||
let mut server = ADBServer::default();
|
|
||||||
let mut device = server.get_device().expect("cannot get device");
|
|
||||||
device.shell_command(&["df", "-h"], &mut std::io::stdout());
|
|
||||||
```
|
|
||||||
|
|
||||||
#### Push a file to the device
|
|
||||||
|
|
||||||
```rust no_run
|
|
||||||
use adb_client::ADBServer;
|
use adb_client::ADBServer;
|
||||||
use std::net::Ipv4Addr;
|
use std::net::Ipv4Addr;
|
||||||
use std::fs::File;
|
use std::fs::File;
|
||||||
@@ -67,45 +51,6 @@ use std::path::Path;
|
|||||||
|
|
||||||
let mut server = ADBServer::default();
|
let mut server = ADBServer::default();
|
||||||
let mut device = server.get_device().expect("cannot get device");
|
let mut device = server.get_device().expect("cannot get device");
|
||||||
let mut input = File::open(Path::new("/tmp/f")).expect("Cannot open file");
|
let mut input = File::open(Path::new("/tmp")).unwrap();
|
||||||
device.push(&mut input, "/data/local/tmp");
|
device.send(&mut input, "/data/local/tmp");
|
||||||
```
|
|
||||||
|
|
||||||
### Interact directly with end devices
|
|
||||||
|
|
||||||
#### (USB) Launch a command on device
|
|
||||||
|
|
||||||
```rust no_run
|
|
||||||
use adb_client::{ADBUSBDevice, ADBDeviceExt};
|
|
||||||
|
|
||||||
let vendor_id = 0x04e8;
|
|
||||||
let product_id = 0x6860;
|
|
||||||
let mut device = ADBUSBDevice::new(vendor_id, product_id).expect("cannot find device");
|
|
||||||
device.shell_command(&["df", "-h"], &mut std::io::stdout());
|
|
||||||
```
|
|
||||||
|
|
||||||
#### (USB) Push a file to the device
|
|
||||||
|
|
||||||
```rust no_run
|
|
||||||
use adb_client::{ADBUSBDevice, ADBDeviceExt};
|
|
||||||
use std::fs::File;
|
|
||||||
use std::path::Path;
|
|
||||||
|
|
||||||
let vendor_id = 0x04e8;
|
|
||||||
let product_id = 0x6860;
|
|
||||||
let mut device = ADBUSBDevice::new(vendor_id, product_id).expect("cannot find device");
|
|
||||||
let mut input = File::open(Path::new("/tmp/f")).expect("Cannot open file");
|
|
||||||
device.push(&mut input, &"/data/local/tmp");
|
|
||||||
```
|
|
||||||
|
|
||||||
#### (TCP) Get a shell from device
|
|
||||||
|
|
||||||
```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(&mut std::io::stdin(), Box::new(std::io::stdout()));
|
|
||||||
```
|
```
|
||||||
|
|||||||
@@ -1,73 +0,0 @@
|
|||||||
use std::io::{Cursor, Read, Write};
|
|
||||||
use std::path::Path;
|
|
||||||
|
|
||||||
use image::{ImageBuffer, ImageFormat, Rgba};
|
|
||||||
|
|
||||||
use crate::models::AdbStatResponse;
|
|
||||||
use crate::{RebootType, Result};
|
|
||||||
|
|
||||||
/// Trait representing all features available on both [`crate::ADBServerDevice`] and [`crate::ADBUSBDevice`]
|
|
||||||
pub trait ADBDeviceExt {
|
|
||||||
/// Runs command in a shell on the device, and write its output and error streams into output.
|
|
||||||
fn shell_command(&mut self, command: &[&str], output: &mut dyn Write) -> Result<()>;
|
|
||||||
|
|
||||||
/// Starts an interactive shell session on the device.
|
|
||||||
/// Input data is read from reader and write to writer.
|
|
||||||
fn shell(&mut self, reader: &mut dyn Read, writer: Box<(dyn Write + Send)>) -> 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`
|
|
||||||
fn pull(&mut self, source: &dyn AsRef<str>, output: &mut dyn Write) -> Result<()>;
|
|
||||||
|
|
||||||
/// Push `stream` to `path` on the device.
|
|
||||||
fn push(&mut self, stream: &mut dyn Read, path: &dyn AsRef<str>) -> Result<()>;
|
|
||||||
|
|
||||||
/// 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.
|
|
||||||
fn run_activity(&mut self, package: &str, activity: &str) -> Result<Vec<u8>> {
|
|
||||||
let mut output = Vec::new();
|
|
||||||
self.shell_command(
|
|
||||||
&["am", "start", &format!("{package}/{package}.{activity}")],
|
|
||||||
&mut output,
|
|
||||||
)?;
|
|
||||||
|
|
||||||
Ok(output)
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Install an APK pointed to by `apk_path` on device.
|
|
||||||
fn install(&mut self, apk_path: &dyn AsRef<Path>) -> Result<()>;
|
|
||||||
|
|
||||||
/// Inner method requesting framebuffer from an Android device
|
|
||||||
fn framebuffer_inner(&mut self) -> Result<ImageBuffer<Rgba<u8>, Vec<u8>>>;
|
|
||||||
|
|
||||||
/// Dump framebuffer of this device into given path
|
|
||||||
fn framebuffer(&mut self, path: &dyn AsRef<Path>) -> Result<()> {
|
|
||||||
// Big help from AOSP source code (<https://android.googlesource.com/platform/system/adb/+/refs/heads/main/framebuffer_service.cpp>)
|
|
||||||
let img = self.framebuffer_inner()?;
|
|
||||||
Ok(img.save(path.as_ref())?)
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Dump framebuffer of this device and return corresponding bytes.
|
|
||||||
///
|
|
||||||
/// Output data format is currently only `PNG`.
|
|
||||||
fn framebuffer_bytes(&mut self) -> Result<Vec<u8>> {
|
|
||||||
let img = self.framebuffer_inner()?;
|
|
||||||
let mut vec = Cursor::new(Vec::new());
|
|
||||||
img.write_to(&mut vec, ImageFormat::Png)?;
|
|
||||||
|
|
||||||
Ok(vec.into_inner())
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Return a boxed instance representing this trait
|
|
||||||
fn boxed(self) -> Box<dyn ADBDeviceExt>
|
|
||||||
where
|
|
||||||
Self: Sized,
|
|
||||||
Self: 'static,
|
|
||||||
{
|
|
||||||
Box::new(self)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,5 +1,3 @@
|
|||||||
#![cfg(any(target_os = "linux", target_os = "macos"))]
|
|
||||||
|
|
||||||
use std::os::unix::prelude::{AsRawFd, RawFd};
|
use std::os::unix::prelude::{AsRawFd, RawFd};
|
||||||
|
|
||||||
use termios::{tcsetattr, Termios, TCSANOW, VMIN, VTIME};
|
use termios::{tcsetattr, Termios, TCSANOW, VMIN, VTIME};
|
||||||
@@ -35,8 +33,6 @@ impl ADBTermios {
|
|||||||
impl Drop for ADBTermios {
|
impl Drop for ADBTermios {
|
||||||
fn drop(&mut self) {
|
fn drop(&mut self) {
|
||||||
// Custom drop implementation, restores previous termios structure.
|
// Custom drop implementation, restores previous termios structure.
|
||||||
if let Err(e) = tcsetattr(self.fd, TCSANOW, &self.old_termios) {
|
tcsetattr(self.fd, TCSANOW, &self.old_termios).unwrap();
|
||||||
log::error!("Error while droping ADBTermios: {e}")
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -1 +0,0 @@
|
|||||||
pub const BUFFER_SIZE: usize = 65536;
|
|
||||||
@@ -1,245 +0,0 @@
|
|||||||
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,
|
|
||||||
local_id: Option<u32>,
|
|
||||||
remote_id: Option<u32>,
|
|
||||||
}
|
|
||||||
|
|
||||||
impl<T: ADBMessageTransport> ADBMessageDevice<T> {
|
|
||||||
/// Instantiate a new [`ADBMessageTransport`]
|
|
||||||
pub fn new(transport: T) -> Self {
|
|
||||||
Self {
|
|
||||||
transport,
|
|
||||||
local_id: None,
|
|
||||||
remote_id: None,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
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) -> Result<ADBTransportMessage> {
|
|
||||||
let message = self.transport.read_message()?;
|
|
||||||
self.transport.write_message(ADBTransportMessage::new(
|
|
||||||
MessageCommand::Okay,
|
|
||||||
self.get_local_id()?,
|
|
||||||
self.get_remote_id()?,
|
|
||||||
&[],
|
|
||||||
))?;
|
|
||||||
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)?;
|
|
||||||
|
|
||||||
self.transport.read_message().and_then(|message| {
|
|
||||||
message.assert_command(MessageCommand::Okay)?;
|
|
||||||
Ok(message)
|
|
||||||
})
|
|
||||||
}
|
|
||||||
|
|
||||||
pub(crate) fn recv_file<W: std::io::Write>(
|
|
||||||
&mut self,
|
|
||||||
mut output: W,
|
|
||||||
) -> std::result::Result<(), RustADBError> {
|
|
||||||
let mut len: Option<u64> = None;
|
|
||||||
loop {
|
|
||||||
let payload = self.recv_and_reply_okay()?.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<()> {
|
|
||||||
self.open_session(b"sync:\0")?;
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
|
|
||||||
pub(crate) fn stat_with_explicit_ids(&mut self, remote_path: &str) -> Result<AdbStatResponse> {
|
|
||||||
let stat_buffer = MessageSubcommand::Stat.with_arg(remote_path.len() as u32);
|
|
||||||
let message = ADBTransportMessage::new(
|
|
||||||
MessageCommand::Write,
|
|
||||||
self.get_local_id()?,
|
|
||||||
self.get_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,
|
|
||||||
self.get_local_id()?,
|
|
||||||
self.get_remote_id()?,
|
|
||||||
remote_path.as_bytes(),
|
|
||||||
))?;
|
|
||||||
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) -> Result<()> {
|
|
||||||
let quit_buffer = MessageSubcommand::Quit.with_arg(0u32);
|
|
||||||
self.send_and_expect_okay(ADBTransportMessage::new(
|
|
||||||
MessageCommand::Write,
|
|
||||||
self.get_local_id()?,
|
|
||||||
self.get_remote_id()?,
|
|
||||||
&bincode::serialize(&quit_buffer).map_err(|_e| RustADBError::ConversionError)?,
|
|
||||||
))?;
|
|
||||||
let _discard_close = self.transport.read_message()?;
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
|
|
||||||
pub(crate) fn open_session(&mut self, data: &[u8]) -> Result<ADBTransportMessage> {
|
|
||||||
let mut rng = rand::thread_rng();
|
|
||||||
|
|
||||||
let message = ADBTransportMessage::new(
|
|
||||||
MessageCommand::Open,
|
|
||||||
rng.gen(), // Our 'local-id'
|
|
||||||
0,
|
|
||||||
data,
|
|
||||||
);
|
|
||||||
self.get_transport_mut().write_message(message)?;
|
|
||||||
|
|
||||||
let response = self.get_transport_mut().read_message()?;
|
|
||||||
|
|
||||||
self.local_id = Some(response.header().arg1());
|
|
||||||
self.remote_id = Some(response.header().arg0());
|
|
||||||
|
|
||||||
Ok(response)
|
|
||||||
}
|
|
||||||
|
|
||||||
pub(crate) fn get_local_id(&self) -> Result<u32> {
|
|
||||||
self.local_id.ok_or(RustADBError::ADBRequestFailed(
|
|
||||||
"connection not opened, no local_id".into(),
|
|
||||||
))
|
|
||||||
}
|
|
||||||
|
|
||||||
pub(crate) fn get_remote_id(&self) -> Result<u32> {
|
|
||||||
self.remote_id.ok_or(RustADBError::ADBRequestFailed(
|
|
||||||
"connection not opened, no remote_id".into(),
|
|
||||||
))
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,41 +0,0 @@
|
|||||||
use crate::{models::AdbStatResponse, ADBDeviceExt, ADBMessageTransport, RebootType, Result};
|
|
||||||
use std::{
|
|
||||||
io::{Read, Write},
|
|
||||||
path::Path,
|
|
||||||
};
|
|
||||||
|
|
||||||
use super::ADBMessageDevice;
|
|
||||||
|
|
||||||
impl<T: ADBMessageTransport> ADBDeviceExt for ADBMessageDevice<T> {
|
|
||||||
fn shell_command(&mut self, command: &[&str], output: &mut dyn Write) -> Result<()> {
|
|
||||||
self.shell_command(command, output)
|
|
||||||
}
|
|
||||||
|
|
||||||
fn shell(&mut self, reader: &mut dyn Read, writer: Box<(dyn Write + Send)>) -> Result<()> {
|
|
||||||
self.shell(reader, writer)
|
|
||||||
}
|
|
||||||
|
|
||||||
fn stat(&mut self, remote_path: &str) -> Result<AdbStatResponse> {
|
|
||||||
self.stat(remote_path)
|
|
||||||
}
|
|
||||||
|
|
||||||
fn pull(&mut self, source: &dyn AsRef<str>, output: &mut dyn Write) -> Result<()> {
|
|
||||||
self.pull(source, output)
|
|
||||||
}
|
|
||||||
|
|
||||||
fn push(&mut self, stream: &mut dyn Read, path: &dyn AsRef<str>) -> Result<()> {
|
|
||||||
self.push(stream, path)
|
|
||||||
}
|
|
||||||
|
|
||||||
fn reboot(&mut self, reboot_type: RebootType) -> Result<()> {
|
|
||||||
self.reboot(reboot_type)
|
|
||||||
}
|
|
||||||
|
|
||||||
fn install(&mut self, apk_path: &dyn AsRef<Path>) -> Result<()> {
|
|
||||||
self.install(apk_path)
|
|
||||||
}
|
|
||||||
|
|
||||||
fn framebuffer_inner(&mut self) -> Result<image::ImageBuffer<image::Rgba<u8>, Vec<u8>>> {
|
|
||||||
self.framebuffer_inner()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,110 +0,0 @@
|
|||||||
use std::io::Write;
|
|
||||||
use std::path::Path;
|
|
||||||
use std::{io::Read, net::SocketAddr};
|
|
||||||
|
|
||||||
use super::adb_message_device::ADBMessageDevice;
|
|
||||||
use super::models::MessageCommand;
|
|
||||||
use super::ADBTransportMessage;
|
|
||||||
use crate::{ADBDeviceExt, ADBMessageTransport, ADBTransport, Result, 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(),
|
|
||||||
);
|
|
||||||
|
|
||||||
self.get_transport_mut().write_message(message)?;
|
|
||||||
|
|
||||||
// At this point, we should have received a STLS command indicating that the device wants to upgrade connection with TLS
|
|
||||||
self.get_transport_mut()
|
|
||||||
.read_message()
|
|
||||||
.and_then(|message| message.assert_command(MessageCommand::Stls))?;
|
|
||||||
|
|
||||||
self.get_transport_mut()
|
|
||||||
.write_message(ADBTransportMessage::new(MessageCommand::Stls, 1, 0, &[]))?;
|
|
||||||
|
|
||||||
// Upgrade TCP connection to TLS
|
|
||||||
self.get_transport_mut().upgrade_connection()?;
|
|
||||||
|
|
||||||
log::debug!("Connection successfully upgraded from TCP to TLS");
|
|
||||||
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
|
|
||||||
#[inline]
|
|
||||||
fn get_transport_mut(&mut self) -> &mut TcpTransport {
|
|
||||||
self.inner.get_transport_mut()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl ADBDeviceExt for ADBTcpDevice {
|
|
||||||
#[inline]
|
|
||||||
fn shell_command(&mut self, command: &[&str], output: &mut dyn Write) -> Result<()> {
|
|
||||||
self.inner.shell_command(command, output)
|
|
||||||
}
|
|
||||||
|
|
||||||
#[inline]
|
|
||||||
fn shell(&mut self, reader: &mut dyn Read, writer: Box<(dyn Write + Send)>) -> Result<()> {
|
|
||||||
self.inner.shell(reader, writer)
|
|
||||||
}
|
|
||||||
|
|
||||||
#[inline]
|
|
||||||
fn stat(&mut self, remote_path: &str) -> Result<crate::AdbStatResponse> {
|
|
||||||
self.inner.stat(remote_path)
|
|
||||||
}
|
|
||||||
|
|
||||||
#[inline]
|
|
||||||
fn pull(&mut self, source: &dyn AsRef<str>, output: &mut dyn Write) -> Result<()> {
|
|
||||||
self.inner.pull(source, output)
|
|
||||||
}
|
|
||||||
|
|
||||||
#[inline]
|
|
||||||
fn push(&mut self, stream: &mut dyn Read, path: &dyn AsRef<str>) -> Result<()> {
|
|
||||||
self.inner.push(stream, path)
|
|
||||||
}
|
|
||||||
|
|
||||||
#[inline]
|
|
||||||
fn reboot(&mut self, reboot_type: crate::RebootType) -> Result<()> {
|
|
||||||
self.inner.reboot(reboot_type)
|
|
||||||
}
|
|
||||||
|
|
||||||
#[inline]
|
|
||||||
fn install(&mut self, apk_path: &dyn AsRef<Path>) -> Result<()> {
|
|
||||||
self.inner.install(apk_path)
|
|
||||||
}
|
|
||||||
|
|
||||||
#[inline]
|
|
||||||
fn framebuffer_inner(&mut self) -> Result<image::ImageBuffer<image::Rgba<u8>, Vec<u8>>> {
|
|
||||||
self.inner.framebuffer_inner()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl Drop for ADBTcpDevice {
|
|
||||||
fn drop(&mut self) {
|
|
||||||
// Best effort here
|
|
||||||
let _ = self.get_transport_mut().disconnect();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,122 +0,0 @@
|
|||||||
use serde::{Deserialize, Serialize};
|
|
||||||
|
|
||||||
use crate::{Result, 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 ADBTransportMessage {
|
|
||||||
header: ADBTransportMessageHeader,
|
|
||||||
payload: Vec<u8>,
|
|
||||||
}
|
|
||||||
|
|
||||||
#[derive(Debug, Serialize, Deserialize)]
|
|
||||||
#[repr(C)]
|
|
||||||
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 ADBTransportMessageHeader {
|
|
||||||
pub fn new(command: MessageCommand, arg0: u32, arg1: u32, data: &[u8]) -> Self {
|
|
||||||
Self {
|
|
||||||
command,
|
|
||||||
arg0,
|
|
||||||
arg1,
|
|
||||||
data_length: data.len() as u32,
|
|
||||||
data_crc32: Self::compute_crc32(data),
|
|
||||||
magic: Self::compute_magic(command),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn command(&self) -> MessageCommand {
|
|
||||||
self.command
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn arg0(&self) -> u32 {
|
|
||||||
self.arg0
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn arg1(&self) -> u32 {
|
|
||||||
self.arg1
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn data_length(&self) -> u32 {
|
|
||||||
self.data_length
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn data_crc32(&self) -> u32 {
|
|
||||||
self.data_crc32
|
|
||||||
}
|
|
||||||
|
|
||||||
pub(crate) fn compute_crc32(data: &[u8]) -> u32 {
|
|
||||||
data.iter().map(|&x| x as u32).sum()
|
|
||||||
}
|
|
||||||
|
|
||||||
fn compute_magic(command: MessageCommand) -> u32 {
|
|
||||||
let command_u32 = command as u32;
|
|
||||||
command_u32 ^ 0xFFFFFFFF
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn as_bytes(&self) -> Result<Vec<u8>> {
|
|
||||||
bincode::serialize(&self).map_err(|_e| RustADBError::ConversionError)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl ADBTransportMessage {
|
|
||||||
pub fn new(command: MessageCommand, arg0: u32, arg1: u32, data: &[u8]) -> Self {
|
|
||||||
Self {
|
|
||||||
header: ADBTransportMessageHeader::new(command, arg0, arg1, data),
|
|
||||||
payload: data.to_vec(),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn from_header_and_payload(header: ADBTransportMessageHeader, payload: Vec<u8>) -> Self {
|
|
||||||
Self { header, payload }
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn check_message_integrity(&self) -> bool {
|
|
||||||
ADBTransportMessageHeader::compute_magic(self.header.command) == self.header.magic
|
|
||||||
&& ADBTransportMessageHeader::compute_crc32(&self.payload) == self.header.data_crc32
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn assert_command(&self, expected_command: MessageCommand) -> Result<()> {
|
|
||||||
let our_command = self.header().command();
|
|
||||||
if expected_command == our_command {
|
|
||||||
return Ok(());
|
|
||||||
}
|
|
||||||
|
|
||||||
Err(RustADBError::WrongResponseReceived(
|
|
||||||
our_command.to_string(),
|
|
||||||
expected_command.to_string(),
|
|
||||||
))
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn header(&self) -> &ADBTransportMessageHeader {
|
|
||||||
&self.header
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn payload(&self) -> &Vec<u8> {
|
|
||||||
&self.payload
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn into_payload(self) -> Vec<u8> {
|
|
||||||
self.payload
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl TryFrom<[u8; 24]> for ADBTransportMessageHeader {
|
|
||||||
type Error = RustADBError;
|
|
||||||
|
|
||||||
fn try_from(value: [u8; 24]) -> Result<Self> {
|
|
||||||
bincode::deserialize(&value).map_err(|_e| RustADBError::ConversionError)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,287 +0,0 @@
|
|||||||
use rusb::constants::LIBUSB_CLASS_VENDOR_SPEC;
|
|
||||||
use rusb::Device;
|
|
||||||
use rusb::DeviceDescriptor;
|
|
||||||
use rusb::UsbContext;
|
|
||||||
use std::fs::read_to_string;
|
|
||||||
use std::io::Read;
|
|
||||||
use std::io::Write;
|
|
||||||
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};
|
|
||||||
|
|
||||||
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_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 == LIBUSB_CLASS_VENDOR_SPEC && 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)
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Represent a device reached and available over USB.
|
|
||||||
#[derive(Debug)]
|
|
||||||
pub struct ADBUSBDevice {
|
|
||||||
private_key: ADBRsaKey,
|
|
||||||
inner: ADBMessageDevice<USBTransport>,
|
|
||||||
}
|
|
||||||
|
|
||||||
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> {
|
|
||||||
Self::new_from_transport_inner(USBTransport::new(vendor_id, product_id)?, private_key_path)
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Instantiate a new [`ADBUSBDevice`] from a [`USBTransport`] and an optional private key path.
|
|
||||||
pub fn new_from_transport(
|
|
||||||
transport: USBTransport,
|
|
||||||
private_key_path: Option<PathBuf>,
|
|
||||||
) -> Result<Self> {
|
|
||||||
let private_key_path = match private_key_path {
|
|
||||||
Some(private_key_path) => private_key_path,
|
|
||||||
None => get_default_adb_key_path()?,
|
|
||||||
};
|
|
||||||
|
|
||||||
Self::new_from_transport_inner(transport, private_key_path)
|
|
||||||
}
|
|
||||||
|
|
||||||
fn new_from_transport_inner(
|
|
||||||
transport: USBTransport,
|
|
||||||
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(transport),
|
|
||||||
};
|
|
||||||
|
|
||||||
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(),
|
|
||||||
);
|
|
||||||
|
|
||||||
self.get_transport_mut().write_message(message)?;
|
|
||||||
|
|
||||||
let message = self.get_transport_mut().read_message()?;
|
|
||||||
message.assert_command(MessageCommand::Auth)?;
|
|
||||||
|
|
||||||
// At this point, we should have receive an AUTH message with arg0 == 1
|
|
||||||
let auth_message = match message.header().arg0() {
|
|
||||||
AUTH_TOKEN => message,
|
|
||||||
v => {
|
|
||||||
return Err(RustADBError::ADBRequestFailed(format!(
|
|
||||||
"Received AUTH message with type != 1 ({v})"
|
|
||||||
)))
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
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))
|
|
||||||
.and_then(|message| {
|
|
||||||
message.assert_command(MessageCommand::Cnxn)?;
|
|
||||||
Ok(message)
|
|
||||||
})?;
|
|
||||||
|
|
||||||
log::info!(
|
|
||||||
"Authentication OK, device info {}",
|
|
||||||
String::from_utf8(response.into_payload())?
|
|
||||||
);
|
|
||||||
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
|
|
||||||
#[inline]
|
|
||||||
fn get_transport_mut(&mut self) -> &mut USBTransport {
|
|
||||||
self.inner.get_transport_mut()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl ADBDeviceExt for ADBUSBDevice {
|
|
||||||
#[inline]
|
|
||||||
fn shell_command(&mut self, command: &[&str], output: &mut dyn Write) -> Result<()> {
|
|
||||||
self.inner.shell_command(command, output)
|
|
||||||
}
|
|
||||||
|
|
||||||
#[inline]
|
|
||||||
fn shell<'a>(&mut self, reader: &mut dyn Read, writer: Box<(dyn Write + Send)>) -> Result<()> {
|
|
||||||
self.inner.shell(reader, writer)
|
|
||||||
}
|
|
||||||
|
|
||||||
#[inline]
|
|
||||||
fn stat(&mut self, remote_path: &str) -> Result<crate::AdbStatResponse> {
|
|
||||||
self.inner.stat(remote_path)
|
|
||||||
}
|
|
||||||
|
|
||||||
#[inline]
|
|
||||||
fn pull(&mut self, source: &dyn AsRef<str>, output: &mut dyn Write) -> Result<()> {
|
|
||||||
self.inner.pull(source, output)
|
|
||||||
}
|
|
||||||
|
|
||||||
#[inline]
|
|
||||||
fn push(&mut self, stream: &mut dyn Read, path: &dyn AsRef<str>) -> Result<()> {
|
|
||||||
self.inner.push(stream, path)
|
|
||||||
}
|
|
||||||
|
|
||||||
#[inline]
|
|
||||||
fn reboot(&mut self, reboot_type: crate::RebootType) -> Result<()> {
|
|
||||||
self.inner.reboot(reboot_type)
|
|
||||||
}
|
|
||||||
|
|
||||||
#[inline]
|
|
||||||
fn install(&mut self, apk_path: &dyn AsRef<Path>) -> Result<()> {
|
|
||||||
self.inner.install(apk_path)
|
|
||||||
}
|
|
||||||
|
|
||||||
#[inline]
|
|
||||||
fn framebuffer_inner(&mut self) -> Result<image::ImageBuffer<image::Rgba<u8>, Vec<u8>>> {
|
|
||||||
self.inner.framebuffer_inner()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl Drop for ADBUSBDevice {
|
|
||||||
fn drop(&mut self) {
|
|
||||||
// Best effort here
|
|
||||||
let _ = self.get_transport_mut().disconnect();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,98 +0,0 @@
|
|||||||
use std::io::{Cursor, Read};
|
|
||||||
|
|
||||||
use byteorder::{LittleEndian, ReadBytesExt};
|
|
||||||
use image::{ImageBuffer, Rgba};
|
|
||||||
|
|
||||||
use crate::{
|
|
||||||
device::{adb_message_device::ADBMessageDevice, MessageCommand},
|
|
||||||
models::{FrameBufferInfoV1, FrameBufferInfoV2},
|
|
||||||
ADBMessageTransport, Result, RustADBError,
|
|
||||||
};
|
|
||||||
|
|
||||||
impl<T: ADBMessageTransport> ADBMessageDevice<T> {
|
|
||||||
pub(crate) fn framebuffer_inner(&mut self) -> Result<ImageBuffer<Rgba<u8>, Vec<u8>>> {
|
|
||||||
self.open_session(b"framebuffer:\0")?;
|
|
||||||
|
|
||||||
let response = self.recv_and_reply_okay()?;
|
|
||||||
|
|
||||||
let mut payload_cursor = Cursor::new(response.payload());
|
|
||||||
|
|
||||||
let version = payload_cursor.read_u32::<LittleEndian>()?;
|
|
||||||
|
|
||||||
let img = match version {
|
|
||||||
// RGBA_8888
|
|
||||||
1 => {
|
|
||||||
let mut buf = [0u8; std::mem::size_of::<FrameBufferInfoV1>()];
|
|
||||||
|
|
||||||
payload_cursor.read_exact(&mut buf)?;
|
|
||||||
|
|
||||||
let framebuffer_info: FrameBufferInfoV1 = buf.try_into()?;
|
|
||||||
|
|
||||||
let mut framebuffer_data = Vec::new();
|
|
||||||
payload_cursor.read_to_end(&mut framebuffer_data)?;
|
|
||||||
|
|
||||||
loop {
|
|
||||||
if framebuffer_data.len() as u32 == framebuffer_info.size {
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
|
|
||||||
let response = self.recv_and_reply_okay()?;
|
|
||||||
|
|
||||||
framebuffer_data.extend_from_slice(&response.into_payload());
|
|
||||||
|
|
||||||
log::debug!(
|
|
||||||
"received framebuffer data. new size {}",
|
|
||||||
framebuffer_data.len()
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
ImageBuffer::<Rgba<u8>, Vec<u8>>::from_vec(
|
|
||||||
framebuffer_info.width,
|
|
||||||
framebuffer_info.height,
|
|
||||||
framebuffer_data,
|
|
||||||
)
|
|
||||||
.ok_or_else(|| RustADBError::FramebufferConversionError)?
|
|
||||||
}
|
|
||||||
// RGBX_8888
|
|
||||||
2 => {
|
|
||||||
let mut buf = [0u8; std::mem::size_of::<FrameBufferInfoV2>()];
|
|
||||||
|
|
||||||
payload_cursor.read_exact(&mut buf)?;
|
|
||||||
|
|
||||||
let framebuffer_info: FrameBufferInfoV2 = buf.try_into()?;
|
|
||||||
|
|
||||||
let mut framebuffer_data = Vec::new();
|
|
||||||
payload_cursor.read_to_end(&mut framebuffer_data)?;
|
|
||||||
|
|
||||||
loop {
|
|
||||||
if framebuffer_data.len() as u32 == framebuffer_info.size {
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
|
|
||||||
let response = self.recv_and_reply_okay()?;
|
|
||||||
|
|
||||||
framebuffer_data.extend_from_slice(&response.into_payload());
|
|
||||||
|
|
||||||
log::debug!(
|
|
||||||
"received framebuffer data. new size {}",
|
|
||||||
framebuffer_data.len()
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
ImageBuffer::<Rgba<u8>, Vec<u8>>::from_vec(
|
|
||||||
framebuffer_info.width,
|
|
||||||
framebuffer_info.height,
|
|
||||||
framebuffer_data,
|
|
||||||
)
|
|
||||||
.ok_or_else(|| RustADBError::FramebufferConversionError)?
|
|
||||||
}
|
|
||||||
v => return Err(RustADBError::UnimplementedFramebufferImageVersion(v)),
|
|
||||||
};
|
|
||||||
|
|
||||||
self.get_transport_mut()
|
|
||||||
.read_message()
|
|
||||||
.and_then(|message| message.assert_command(MessageCommand::Clse))?;
|
|
||||||
|
|
||||||
Ok(img)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,46 +0,0 @@
|
|||||||
use std::{fs::File, path::Path};
|
|
||||||
|
|
||||||
use rand::Rng;
|
|
||||||
|
|
||||||
use crate::{
|
|
||||||
device::{adb_message_device::ADBMessageDevice, MessageWriter},
|
|
||||||
utils::check_extension_is_apk,
|
|
||||||
ADBMessageTransport, Result,
|
|
||||||
};
|
|
||||||
|
|
||||||
impl<T: ADBMessageTransport> ADBMessageDevice<T> {
|
|
||||||
pub(crate) fn install(&mut self, apk_path: &dyn AsRef<Path>) -> 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();
|
|
||||||
|
|
||||||
self.open_session(format!("exec:cmd package 'install' -S {}\0", file_size).as_bytes())?;
|
|
||||||
|
|
||||||
let transport = self.get_transport().clone();
|
|
||||||
|
|
||||||
let mut writer = MessageWriter::new(transport, local_id, self.get_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(),
|
|
||||||
)?)),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
mod framebuffer;
|
|
||||||
mod install;
|
|
||||||
mod pull;
|
|
||||||
mod push;
|
|
||||||
mod reboot;
|
|
||||||
mod shell;
|
|
||||||
mod stat;
|
|
||||||
@@ -1,52 +0,0 @@
|
|||||||
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<()> {
|
|
||||||
self.begin_synchronization()?;
|
|
||||||
let source = source.as_ref();
|
|
||||||
|
|
||||||
let adb_stat_response = self.stat_with_explicit_ids(source)?;
|
|
||||||
|
|
||||||
if adb_stat_response.file_perm == 0 {
|
|
||||||
return Err(RustADBError::UnknownResponseType(
|
|
||||||
"mode is 0: source file does not exist".to_string(),
|
|
||||||
));
|
|
||||||
}
|
|
||||||
|
|
||||||
let local_id = self.get_local_id()?;
|
|
||||||
let remote_id = self.get_remote_id()?;
|
|
||||||
|
|
||||||
self.get_transport_mut().write_message_with_timeout(
|
|
||||||
ADBTransportMessage::new(MessageCommand::Okay, local_id, remote_id, &[]),
|
|
||||||
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,
|
|
||||||
self.get_local_id()?,
|
|
||||||
self.get_remote_id()?,
|
|
||||||
&recv_buffer,
|
|
||||||
))?;
|
|
||||||
self.send_and_expect_okay(ADBTransportMessage::new(
|
|
||||||
MessageCommand::Write,
|
|
||||||
self.get_local_id()?,
|
|
||||||
self.get_remote_id()?,
|
|
||||||
source.as_bytes(),
|
|
||||||
))?;
|
|
||||||
|
|
||||||
self.recv_file(output)?;
|
|
||||||
self.end_transaction()?;
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,35 +0,0 @@
|
|||||||
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<()> {
|
|
||||||
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,
|
|
||||||
self.get_local_id()?,
|
|
||||||
self.get_remote_id()?,
|
|
||||||
&send_buffer,
|
|
||||||
))?;
|
|
||||||
|
|
||||||
self.push_file(self.get_local_id()?, self.get_remote_id()?, stream)?;
|
|
||||||
|
|
||||||
self.end_transaction()?;
|
|
||||||
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,14 +0,0 @@
|
|||||||
use crate::{
|
|
||||||
device::{adb_message_device::ADBMessageDevice, MessageCommand},
|
|
||||||
ADBMessageTransport, RebootType, Result,
|
|
||||||
};
|
|
||||||
|
|
||||||
impl<T: ADBMessageTransport> ADBMessageDevice<T> {
|
|
||||||
pub(crate) fn reboot(&mut self, reboot_type: RebootType) -> Result<()> {
|
|
||||||
self.open_session(format!("reboot:{}\0", reboot_type).as_bytes())?;
|
|
||||||
|
|
||||||
self.get_transport_mut()
|
|
||||||
.read_message()
|
|
||||||
.and_then(|message| message.assert_command(MessageCommand::Okay))
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,82 +0,0 @@
|
|||||||
use std::io::{ErrorKind, 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(&mut self, command: &[&str], output: &mut dyn Write) -> Result<()> {
|
|
||||||
let response = self.open_session(format!("shell:{}\0", command.join(" "),).as_bytes())?;
|
|
||||||
|
|
||||||
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].
|
|
||||||
pub(crate) fn shell(
|
|
||||||
&mut self,
|
|
||||||
mut reader: &mut dyn Read,
|
|
||||||
mut writer: Box<(dyn Write + Send)>,
|
|
||||||
) -> Result<()> {
|
|
||||||
self.open_session(b"shell:\0")?;
|
|
||||||
|
|
||||||
let mut transport = self.get_transport().clone();
|
|
||||||
|
|
||||||
let local_id = self.get_local_id()?;
|
|
||||||
let remote_id = self.get_remote_id()?;
|
|
||||||
|
|
||||||
// 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, &[]);
|
|
||||||
transport.write_message(response)?;
|
|
||||||
|
|
||||||
match message.header().command() {
|
|
||||||
MessageCommand::Write => {
|
|
||||||
writer.write_all(&message.into_payload())?;
|
|
||||||
writer.flush()?;
|
|
||||||
}
|
|
||||||
MessageCommand::Okay => continue,
|
|
||||||
_ => return Err(RustADBError::ADBShellNotSupported),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
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() {
|
|
||||||
ErrorKind::BrokenPipe => return Ok(()),
|
|
||||||
_ => return Err(RustADBError::IOError(e)),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
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> {
|
|
||||||
self.begin_synchronization()?;
|
|
||||||
let adb_stat_response = self.stat_with_explicit_ids(remote_path)?;
|
|
||||||
self.end_transaction()?;
|
|
||||||
Ok(adb_stat_response)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,48 +0,0 @@
|
|||||||
use std::io::{Error, ErrorKind, Result, Write};
|
|
||||||
|
|
||||||
use crate::ADBMessageTransport;
|
|
||||||
|
|
||||||
use super::{ADBTransportMessage, MessageCommand};
|
|
||||||
|
|
||||||
/// [`Write`] trait implementation to hide underlying ADB protocol write logic.
|
|
||||||
///
|
|
||||||
/// 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<T: ADBMessageTransport> MessageWriter<T> {
|
|
||||||
pub fn new(transport: T, local_id: u32, remote_id: u32) -> Self {
|
|
||||||
Self {
|
|
||||||
transport,
|
|
||||||
local_id,
|
|
||||||
remote_id,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl<T: ADBMessageTransport> Write for MessageWriter<T> {
|
|
||||||
fn write(&mut self, buf: &[u8]) -> Result<usize> {
|
|
||||||
let message =
|
|
||||||
ADBTransportMessage::new(MessageCommand::Write, self.local_id, self.remote_id, buf);
|
|
||||||
self.transport
|
|
||||||
.write_message(message)
|
|
||||||
.map_err(|e| Error::new(ErrorKind::InvalidData, e))?;
|
|
||||||
|
|
||||||
match self.transport.read_message() {
|
|
||||||
Ok(response) => {
|
|
||||||
response
|
|
||||||
.assert_command(MessageCommand::Okay)
|
|
||||||
.map_err(|e| Error::new(ErrorKind::Other, e))?;
|
|
||||||
Ok(buf.len())
|
|
||||||
}
|
|
||||||
Err(e) => Err(Error::new(ErrorKind::Other, e)),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
fn flush(&mut self) -> Result<()> {
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,17 +0,0 @@
|
|||||||
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;
|
|
||||||
@@ -1,175 +0,0 @@
|
|||||||
use crate::{Result, RustADBError};
|
|
||||||
use base64::{engine::general_purpose::STANDARD, Engine};
|
|
||||||
use num_bigint::{BigUint, ModInverse};
|
|
||||||
use num_traits::cast::ToPrimitive;
|
|
||||||
use num_traits::FromPrimitive;
|
|
||||||
use rand::rngs::OsRng;
|
|
||||||
use rsa::pkcs8::DecodePrivateKey;
|
|
||||||
use rsa::traits::PublicKeyParts;
|
|
||||||
use rsa::{Pkcs1v15Sign, RsaPrivateKey};
|
|
||||||
|
|
||||||
const ADB_PRIVATE_KEY_SIZE: usize = 2048;
|
|
||||||
const ANDROID_PUBKEY_MODULUS_SIZE_WORDS: u32 = 64;
|
|
||||||
|
|
||||||
#[repr(C)]
|
|
||||||
#[derive(Debug, Default)]
|
|
||||||
/// Internal ADB representation of a public key
|
|
||||||
struct ADBRsaInternalPublicKey {
|
|
||||||
pub modulus_size_words: u32,
|
|
||||||
pub n0inv: u32,
|
|
||||||
pub modulus: BigUint,
|
|
||||||
pub rr: Vec<u8>,
|
|
||||||
pub exponent: u32,
|
|
||||||
}
|
|
||||||
|
|
||||||
impl ADBRsaInternalPublicKey {
|
|
||||||
pub fn new(exponent: &BigUint, modulus: &BigUint) -> Result<Self> {
|
|
||||||
Ok(Self {
|
|
||||||
modulus_size_words: ANDROID_PUBKEY_MODULUS_SIZE_WORDS,
|
|
||||||
exponent: exponent.to_u32().ok_or(RustADBError::ConversionError)?,
|
|
||||||
modulus: modulus.clone(),
|
|
||||||
..Default::default()
|
|
||||||
})
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn into_bytes(mut self) -> Vec<u8> {
|
|
||||||
let mut bytes: Vec<u8> = Vec::new();
|
|
||||||
bytes.append(&mut self.modulus_size_words.to_le_bytes().to_vec());
|
|
||||||
bytes.append(&mut self.n0inv.to_le_bytes().to_vec());
|
|
||||||
bytes.append(&mut self.modulus.to_bytes_le());
|
|
||||||
bytes.append(&mut self.rr);
|
|
||||||
bytes.append(&mut self.exponent.to_le_bytes().to_vec());
|
|
||||||
|
|
||||||
bytes
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
#[derive(Debug, Clone)]
|
|
||||||
pub struct ADBRsaKey {
|
|
||||||
private_key: RsaPrivateKey,
|
|
||||||
}
|
|
||||||
|
|
||||||
impl ADBRsaKey {
|
|
||||||
pub fn new_random() -> Result<Self> {
|
|
||||||
Ok(Self {
|
|
||||||
private_key: RsaPrivateKey::new(&mut OsRng, ADB_PRIVATE_KEY_SIZE)?,
|
|
||||||
})
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn new_from_pkcs8(pkcs8_content: &str) -> Result<Self> {
|
|
||||||
Ok(ADBRsaKey {
|
|
||||||
private_key: RsaPrivateKey::from_pkcs8_pem(pkcs8_content)?,
|
|
||||||
})
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn android_pubkey_encode(&self) -> Result<String> {
|
|
||||||
// Helped from project: https://github.com/hajifkd/webadb
|
|
||||||
// Source code: https://android.googlesource.com/platform/system/core/+/refs/heads/main/libcrypto_utils/android_pubkey.cpp
|
|
||||||
// Useful function `android_pubkey_encode()`
|
|
||||||
let mut adb_rsa_pubkey =
|
|
||||||
ADBRsaInternalPublicKey::new(self.private_key.e(), self.private_key.n())?;
|
|
||||||
|
|
||||||
// r32 = 2 ^ 32
|
|
||||||
let r32 = BigUint::from_u64(1 << 32).ok_or(RustADBError::ConversionError)?;
|
|
||||||
|
|
||||||
// r = 2 ^ rsa_size = 2 ^ 2048
|
|
||||||
let r = set_bit(ADB_PRIVATE_KEY_SIZE)?;
|
|
||||||
|
|
||||||
// rr = r ^ 2 mod N
|
|
||||||
let rr = r.modpow(&BigUint::from(2u32), &adb_rsa_pubkey.modulus);
|
|
||||||
adb_rsa_pubkey.rr = rr.to_bytes_le();
|
|
||||||
|
|
||||||
// rem = N[0]
|
|
||||||
let rem = &adb_rsa_pubkey.modulus % &r32;
|
|
||||||
|
|
||||||
// n0inv = -1 / rem mod r32
|
|
||||||
let n0inv = rem
|
|
||||||
.mod_inverse(&r32)
|
|
||||||
.and_then(|v| v.to_biguint())
|
|
||||||
.ok_or(RustADBError::ConversionError)?;
|
|
||||||
|
|
||||||
// BN_sub(n0inv, r32, n0inv)
|
|
||||||
adb_rsa_pubkey.n0inv = (r32 - n0inv)
|
|
||||||
.to_u32()
|
|
||||||
.ok_or(RustADBError::ConversionError)?;
|
|
||||||
|
|
||||||
Ok(self.encode_public_key(adb_rsa_pubkey.into_bytes()))
|
|
||||||
}
|
|
||||||
|
|
||||||
fn encode_public_key(&self, pub_key: Vec<u8>) -> String {
|
|
||||||
let mut encoded = STANDARD.encode(pub_key);
|
|
||||||
encoded.push(' ');
|
|
||||||
encoded.push_str(&format!("adb_client@{}", env!("CARGO_PKG_VERSION")));
|
|
||||||
|
|
||||||
encoded
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn sign(&self, msg: impl AsRef<[u8]>) -> Result<Vec<u8>> {
|
|
||||||
Ok(self
|
|
||||||
.private_key
|
|
||||||
.sign(Pkcs1v15Sign::new::<sha1::Sha1>(), msg.as_ref())?)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
fn set_bit(n: usize) -> Result<BigUint> {
|
|
||||||
BigUint::parse_bytes(
|
|
||||||
&{
|
|
||||||
let mut bits = vec![b'1'];
|
|
||||||
bits.append(&mut vec![b'0'; n]);
|
|
||||||
bits
|
|
||||||
}[..],
|
|
||||||
2,
|
|
||||||
)
|
|
||||||
.ok_or(RustADBError::ConversionError)
|
|
||||||
}
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn test_pubkey_gen() {
|
|
||||||
const DEFAULT_PRIV_KEY: &'static str = r"-----BEGIN PRIVATE KEY-----
|
|
||||||
MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQC4Dyn85cxDJnjM
|
|
||||||
uYXQl/w469MDKdlGdviLfmFMWeYLVfL2Mz1AVyvKqscrtlhbbgMQ/M+3lDvEdHS0
|
|
||||||
14RIGAwWRtrlTTmhLvM2/IO+eSKSYeCrCVc4KLG3E3WRryUXbs2ynA29xjTJVw+Z
|
|
||||||
xYxDyn/tAYPEyMm4v+HIJHcOtRzxtO2vjMJ2vBT/ywYxjhncXbFSO09q2E4XrHli
|
|
||||||
SIPyO82hZgCkpzTZRp+nyA17TYuV9++mvUr9lWH9RbC+o8EF3yitlBsE2uXr97EV
|
|
||||||
i2Qy8CE7FIxsihXlukppwKRuz+1rJrvmZPTn49ZS+sIS99WE9GoCpsyQvTpvehrM
|
|
||||||
SIDRsVZPAgMBAAECggEAWNXAzzXeS36zCSR1yILCknqHotw86Pyc4z7BGUe+dzQp
|
|
||||||
itiaNIaeNTgN3zQoGyDSzA0o+BLMcfo/JdVrHBy3IL1cAxYtvXTaoGxp7bGrlPk2
|
|
||||||
pXZhqVJCy/jRYtokzdWF5DHbk/+pFJA3kGE/XKzM54g2n/DFI61A/QdUiz2w1ZtI
|
|
||||||
vc5cM08EM8B/TSI3SeWB8zkh5SlIuLsFO2J2+tCak6PdFfKOVIrFv9dKJYLxx+59
|
|
||||||
+edZamw2EvNlnl/sewgUk0gaZvQKVf4ivHyM+KSHuV4RFfiLvGuVcyA6XhSjztsG
|
|
||||||
EA++jDHP5ib/Izes7UK09v9y7kow+z6vUtnDDQOvgQKBgQD8WWAn7FQt9aziCw19
|
|
||||||
gZynzHG1bXI7uuEVSneuA3UwJImmDu8W+Qb9YL9Dc2nV0M5pGGdXKi2jzq8gPar6
|
|
||||||
GPAmy7TOlov6Nm0pbMXTAfuovG+gIXxelp3US3FvyRupi0/7UQRRwvetFYbDFwJX
|
|
||||||
ydF5uEtZdGSHAjPeU5FLq6tBwQKBgQC6uN0JwwZn+eaxguyKOXvp0KykhFI0HI1A
|
|
||||||
MBDZ1uuKt6OW5+r9NeQtTLctGlNKVQ8wz+Wr0C/nLGIIv4lySS9WFyc5/FnFhDdy
|
|
||||||
LsEi6whcca4vq3jsMOukvQGFnERsou4LqBEI1Es7jjeeEq+/8WnNTi6Y1flZ6UAp
|
|
||||||
YAOeFI98DwKBgQDvyfHgHeajwZalOQF5qGb24AOQ9c4dyefGNnvhA/IgbCfMftZc
|
|
||||||
iwhETuGQM6R3A7KQFRtlrXOu+2BYD6Ffg8D37IwD3vRmL7+tJGoapwC/B0g+7nLi
|
|
||||||
4tZY+9Nv+LbrdbDry8GB+/UkKJdk3IFicCk4M5KOD1bTH5mwAtLHB/p1QQKBgDHi
|
|
||||||
k8M45GxA+p4wMUvYgb987bLiWyfq/N3KOaZJYhJkb4MwoLpXfIeRuFqHbvsr8GwF
|
|
||||||
DwIxE6s6U1KtAWaUIN5qPyOhxMYdRcbusNDIZCp2gKfhsuO/SiVwDYkJr8oqWVip
|
|
||||||
5SsrtJHLtBY6PdQVBkRAf/h7KiwYQfkL2suQCKmHAoGBAJAkYImBYPHuRcnSXikn
|
|
||||||
xGDK/moPvzs0CjdPlRcEN+Myy/G0FUrOaC0FcpNoJOdQSYz3F6URA4nX+zj6Ie7G
|
|
||||||
CNkECiepaGyquQaffwR1CAi8dH6biJjlTQWQPFcCLA0hvernWo3eaSfiL7fHyym+
|
|
||||||
ile69MHFENUePSpuRSiF3Z02
|
|
||||||
-----END PRIVATE KEY-----";
|
|
||||||
let priv_key =
|
|
||||||
ADBRsaKey::new_from_pkcs8(DEFAULT_PRIV_KEY).expect("cannot create rsa key from data");
|
|
||||||
let pub_key = priv_key
|
|
||||||
.android_pubkey_encode()
|
|
||||||
.expect("cannot encode public key");
|
|
||||||
let pub_key_adb = "\
|
|
||||||
QAAAAFH/pU9PVrHRgEjMGnpvOr2QzKYCavSE1fcSwvpS1uPn9GTmuyZr7c9up\
|
|
||||||
MBpSrrlFYpsjBQ7IfAyZIsVsffr5doEG5StKN8FwaO+sEX9YZX9Sr2m7/eVi0\
|
|
||||||
17Dcinn0bZNKekAGahzTvyg0hieawXTthqTztSsV3cGY4xBsv/FLx2woyv7bT\
|
|
||||||
xHLUOdyTI4b+4ycjEgwHtf8pDjMWZD1fJNMa9DZyyzW4XJa+RdRO3sSg4Vwmr\
|
|
||||||
4GGSInm+g/w28y6hOU3l2kYWDBhIhNe0dHTEO5S3z/wQA25bWLYrx6rKK1dAP\
|
|
||||||
TP28lUL5llMYX6L+HZG2SkD0+s4/JfQhbnMeCZDzOX8KQ+4ThLy/gDTqCSTjj\
|
|
||||||
ic8BykdUIqYPwAjBMgQwLOLY5WNJMpjGlFINRcCGhvFFZ73sJTLerECuV/Oae\
|
|
||||||
nFRcORwnGIRgMrYXj4tjmxJC7sq3cfNX96YIcSCDE9SZFdlKXVK8Jc4YMLGF3\
|
|
||||||
MI8k1KoTby34uaIyxPJvwM1WR4Rdj60fwMyikFXNaOR2fPteZ3UMBA7CMrOEm\
|
|
||||||
9iYjntyEppA4hQXIO1TWTzkA/Kfl1i67k5NuLIQdhPFEc5ox5IYVHusauPQ7d\
|
|
||||||
Awu6BlgK37TUn0JdK0Z6Z4RaEIaNiEI0d5CoP6zQKV2QQnlscYpdsaUW5t9/F\
|
|
||||||
LioVXPwrz0tx35JyIUZPPYwEAAQA= ";
|
|
||||||
assert_eq!(&pub_key[..pub_key_adb.len()], pub_key_adb);
|
|
||||||
}
|
|
||||||
@@ -1,64 +0,0 @@
|
|||||||
use serde::{Deserialize, Serialize};
|
|
||||||
use serde_repr::{Deserialize_repr, Serialize_repr};
|
|
||||||
use std::fmt::Display;
|
|
||||||
|
|
||||||
#[derive(Clone, Copy, Debug, Eq, PartialEq, Serialize_repr, Deserialize_repr)]
|
|
||||||
#[repr(u32)]
|
|
||||||
pub enum MessageCommand {
|
|
||||||
/// Connect to a device
|
|
||||||
Cnxn = 0x4E584E43,
|
|
||||||
/// Close connection to a device
|
|
||||||
Clse = 0x45534C43,
|
|
||||||
/// Device ask for authentication
|
|
||||||
Auth = 0x48545541,
|
|
||||||
/// Open a data connection
|
|
||||||
Open = 0x4E45504F,
|
|
||||||
/// Write data to connection
|
|
||||||
Write = 0x45545257,
|
|
||||||
/// Server understood the message
|
|
||||||
Okay = 0x59414B4F,
|
|
||||||
/// Start a connection using TLS
|
|
||||||
Stls = 0x534C5453,
|
|
||||||
}
|
|
||||||
|
|
||||||
#[derive(Debug, Eq, PartialEq, Copy, Clone, Serialize_repr, Deserialize_repr)]
|
|
||||||
#[repr(u32)]
|
|
||||||
pub enum MessageSubcommand {
|
|
||||||
Stat = 0x54415453,
|
|
||||||
Send = 0x444E4553,
|
|
||||||
Recv = 0x56434552,
|
|
||||||
Quit = 0x54495551,
|
|
||||||
Fail = 0x4C494146,
|
|
||||||
Done = 0x454E4F44,
|
|
||||||
Data = 0x41544144,
|
|
||||||
List = 0x5453494C,
|
|
||||||
}
|
|
||||||
|
|
||||||
#[derive(Debug, Serialize, Deserialize)]
|
|
||||||
pub struct SubcommandWithArg {
|
|
||||||
subcommand: MessageSubcommand,
|
|
||||||
arg: u32,
|
|
||||||
}
|
|
||||||
|
|
||||||
impl MessageSubcommand {
|
|
||||||
pub fn with_arg(self, arg: u32) -> SubcommandWithArg {
|
|
||||||
SubcommandWithArg {
|
|
||||||
subcommand: self,
|
|
||||||
arg,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl Display for MessageCommand {
|
|
||||||
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
|
|
||||||
match self {
|
|
||||||
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"),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,5 +0,0 @@
|
|||||||
mod adb_rsa_key;
|
|
||||||
mod message_commands;
|
|
||||||
|
|
||||||
pub use adb_rsa_key::ADBRsaKey;
|
|
||||||
pub use message_commands::{MessageCommand, MessageSubcommand};
|
|
||||||
@@ -1,37 +0,0 @@
|
|||||||
use std::io::Write;
|
|
||||||
|
|
||||||
use crate::ADBMessageTransport;
|
|
||||||
|
|
||||||
use super::{models::MessageCommand, ADBTransportMessage};
|
|
||||||
|
|
||||||
/// [`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<T: ADBMessageTransport> ShellMessageWriter<T> {
|
|
||||||
pub fn new(transport: T, local_id: u32, remote_id: u32) -> Self {
|
|
||||||
Self {
|
|
||||||
transport,
|
|
||||||
local_id,
|
|
||||||
remote_id,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl<T: ADBMessageTransport> Write for ShellMessageWriter<T> {
|
|
||||||
fn write(&mut self, buf: &[u8]) -> std::io::Result<usize> {
|
|
||||||
let message =
|
|
||||||
ADBTransportMessage::new(MessageCommand::Write, self.local_id, self.remote_id, buf);
|
|
||||||
self.transport
|
|
||||||
.write_message(message)
|
|
||||||
.map_err(|e| std::io::Error::new(std::io::ErrorKind::InvalidData, e))?;
|
|
||||||
Ok(buf.len())
|
|
||||||
}
|
|
||||||
|
|
||||||
fn flush(&mut self) -> std::io::Result<()> {
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
10
adb_client/src/emulator/rotate.rs
Normal file
10
adb_client/src/emulator/rotate.rs
Normal file
@@ -0,0 +1,10 @@
|
|||||||
|
use crate::{models::ADBEmulatorCommand, ADBEmulatorDevice, Result};
|
||||||
|
|
||||||
|
impl ADBEmulatorDevice {
|
||||||
|
/// Send a SMS to this emulator with given content with given phone number
|
||||||
|
pub fn rotate(&mut self) -> Result<()> {
|
||||||
|
let transport = self.connect()?;
|
||||||
|
transport.send_command(ADBEmulatorCommand::Rotate)?;
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,11 +1,13 @@
|
|||||||
use crate::{emulator_device::ADBEmulatorCommand, ADBEmulatorDevice, Result};
|
use crate::{models::ADBEmulatorCommand, ADBEmulatorDevice, Result};
|
||||||
|
|
||||||
impl ADBEmulatorDevice {
|
impl ADBEmulatorDevice {
|
||||||
/// Send a SMS to this emulator with given content with given phone number
|
/// Send a SMS to this emulator with given content with given phone number
|
||||||
pub fn send_sms(&mut self, phone_number: &str, content: &str) -> Result<()> {
|
pub fn send_sms(&mut self, phone_number: &str, content: &str) -> Result<()> {
|
||||||
self.connect()?.send_command(ADBEmulatorCommand::Sms(
|
let transport = self.connect()?;
|
||||||
|
transport.send_command(ADBEmulatorCommand::Sms(
|
||||||
phone_number.to_string(),
|
phone_number.to_string(),
|
||||||
content.to_string(),
|
content.to_string(),
|
||||||
))
|
))?;
|
||||||
|
Ok(())
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -1,8 +0,0 @@
|
|||||||
use crate::{emulator_device::ADBEmulatorCommand, ADBEmulatorDevice, Result};
|
|
||||||
|
|
||||||
impl ADBEmulatorDevice {
|
|
||||||
/// Send a SMS to this emulator with given content with given phone number
|
|
||||||
pub fn rotate(&mut self) -> Result<()> {
|
|
||||||
self.connect()?.send_command(ADBEmulatorCommand::Rotate)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,5 +0,0 @@
|
|||||||
mod adb_emulator_device;
|
|
||||||
mod commands;
|
|
||||||
mod models;
|
|
||||||
pub use adb_emulator_device::ADBEmulatorDevice;
|
|
||||||
pub(crate) use models::ADBEmulatorCommand;
|
|
||||||
@@ -1,2 +0,0 @@
|
|||||||
mod adb_emulator_command;
|
|
||||||
pub use adb_emulator_command::ADBEmulatorCommand;
|
|
||||||
@@ -15,9 +15,6 @@ pub enum RustADBError {
|
|||||||
/// Indicates that ADB server responded an unknown response type.
|
/// Indicates that ADB server responded an unknown response type.
|
||||||
#[error("Unknown response type {0}")]
|
#[error("Unknown response type {0}")]
|
||||||
UnknownResponseType(String),
|
UnknownResponseType(String),
|
||||||
/// Indicated that an unexpected command has been received
|
|
||||||
#[error("Wrong response command received: {0}. Expected {1}")]
|
|
||||||
WrongResponseReceived(String, String),
|
|
||||||
/// Indicates that ADB server responses an unknown device state.
|
/// Indicates that ADB server responses an unknown device state.
|
||||||
#[error("Unknown device state {0}")]
|
#[error("Unknown device state {0}")]
|
||||||
UnknownDeviceState(String),
|
UnknownDeviceState(String),
|
||||||
@@ -57,70 +54,7 @@ pub enum RustADBError {
|
|||||||
/// An error occurred when converting framebuffer content
|
/// An error occurred when converting framebuffer content
|
||||||
#[error("Cannot convert framebuffer into image")]
|
#[error("Cannot convert framebuffer into image")]
|
||||||
FramebufferConversionError,
|
FramebufferConversionError,
|
||||||
/// Unimplemented framebuffer image version
|
|
||||||
#[error("Unimplemented framebuffer image version: {0}")]
|
|
||||||
UnimplementedFramebufferImageVersion(u32),
|
|
||||||
/// An error occurred while getting user's home directory
|
/// An error occurred while getting user's home directory
|
||||||
#[error(transparent)]
|
#[error(transparent)]
|
||||||
HomeError(#[from] homedir::GetHomeError),
|
HomeError(#[from] homedir::GetHomeError),
|
||||||
/// Cannot get home directory
|
|
||||||
#[error("Cannot get home directory")]
|
|
||||||
NoHomeDirectory,
|
|
||||||
/// Generic USB error
|
|
||||||
#[error("USB Error: {0}")]
|
|
||||||
UsbError(#[from] rusb::Error),
|
|
||||||
/// USB device not found
|
|
||||||
#[error("USB Device not found: {0} {1}")]
|
|
||||||
USBDeviceNotFound(u16, u16),
|
|
||||||
/// No descriptor found
|
|
||||||
#[error("No USB descriptor found")]
|
|
||||||
USBNoDescriptorFound,
|
|
||||||
/// Integrity of the received message cannot be validated
|
|
||||||
#[error("Invalid integrity. Expected CRC32 {0}, got {1}")]
|
|
||||||
InvalidIntegrity(u32, u32),
|
|
||||||
/// Error while decoding base64 data
|
|
||||||
#[error(transparent)]
|
|
||||||
Base64DecodeError(#[from] base64::DecodeError),
|
|
||||||
/// Error while encoding base64 data
|
|
||||||
#[error(transparent)]
|
|
||||||
Base64EncodeError(#[from] base64::EncodeSliceError),
|
|
||||||
/// An error occurred with RSA engine
|
|
||||||
#[error(transparent)]
|
|
||||||
RSAError(#[from] rsa::errors::Error),
|
|
||||||
/// Cannot convert given data from slice
|
|
||||||
#[error(transparent)]
|
|
||||||
TryFromSliceError(#[from] std::array::TryFromSliceError),
|
|
||||||
/// Given path does not represent an APK
|
|
||||||
#[error("wrong file extension: {0}")]
|
|
||||||
WrongFileExtension(String),
|
|
||||||
/// 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),
|
|
||||||
/// An error occurred while getting mdns devices
|
|
||||||
#[error(transparent)]
|
|
||||||
MDNSError(#[from] mdns_sd::Error),
|
|
||||||
/// An error occurred while sending data to channel
|
|
||||||
#[error(transparent)]
|
|
||||||
SendError(#[from] std::sync::mpsc::SendError<crate::MDNSDevice>),
|
|
||||||
}
|
|
||||||
|
|
||||||
impl<T> From<std::sync::PoisonError<T>> for RustADBError {
|
|
||||||
fn from(_err: std::sync::PoisonError<T>) -> Self {
|
|
||||||
Self::PoisonError
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -4,24 +4,15 @@
|
|||||||
#![forbid(missing_docs)]
|
#![forbid(missing_docs)]
|
||||||
#![doc = include_str!("../README.md")]
|
#![doc = include_str!("../README.md")]
|
||||||
|
|
||||||
mod adb_device_ext;
|
mod adb_termios;
|
||||||
mod constants;
|
mod emulator;
|
||||||
mod device;
|
|
||||||
mod emulator_device;
|
|
||||||
mod error;
|
mod error;
|
||||||
mod mdns;
|
|
||||||
mod models;
|
mod models;
|
||||||
mod server;
|
mod server;
|
||||||
mod server_device;
|
|
||||||
mod transports;
|
mod transports;
|
||||||
mod utils;
|
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 error::{Result, RustADBError};
|
||||||
pub use mdns::*;
|
pub use models::{AdbVersion, DeviceLong, DeviceShort, DeviceState, RebootType};
|
||||||
pub use models::{AdbStatResponse, RebootType};
|
|
||||||
pub use server::*;
|
pub use server::*;
|
||||||
pub use server_device::ADBServerDevice;
|
|
||||||
pub use transports::*;
|
pub use transports::*;
|
||||||
|
|||||||
@@ -1,19 +0,0 @@
|
|||||||
use std::{collections::HashSet, net::IpAddr};
|
|
||||||
|
|
||||||
/// Represent a device found from mdns search
|
|
||||||
#[derive(Debug)]
|
|
||||||
pub struct MDNSDevice {
|
|
||||||
/// Full device address when resolved
|
|
||||||
pub fullname: String,
|
|
||||||
/// Device IP addresses
|
|
||||||
pub addresses: HashSet<IpAddr>,
|
|
||||||
}
|
|
||||||
|
|
||||||
impl From<mdns_sd::ServiceInfo> for MDNSDevice {
|
|
||||||
fn from(value: mdns_sd::ServiceInfo) -> Self {
|
|
||||||
Self {
|
|
||||||
fullname: value.get_fullname().to_string(),
|
|
||||||
addresses: value.get_addresses().to_owned(),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,73 +0,0 @@
|
|||||||
use mdns_sd::{ServiceDaemon, ServiceEvent};
|
|
||||||
use std::{sync::mpsc::Sender, thread::JoinHandle};
|
|
||||||
|
|
||||||
use crate::{MDNSDevice, Result, RustADBError};
|
|
||||||
|
|
||||||
const ADB_SERVICE_NAME: &str = "_adb-tls-connect._tcp.local.";
|
|
||||||
|
|
||||||
/// Structure holding responsibility over mdns discovery
|
|
||||||
pub struct MDNSDiscoveryService {
|
|
||||||
daemon: ServiceDaemon,
|
|
||||||
thread_handle: Option<JoinHandle<Result<()>>>,
|
|
||||||
}
|
|
||||||
|
|
||||||
impl std::fmt::Debug for MDNSDiscoveryService {
|
|
||||||
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
|
|
||||||
f.debug_struct("MDNSDiscoveryService")
|
|
||||||
.field("daemon", &self.daemon.get_metrics())
|
|
||||||
.field("handle", &self.thread_handle)
|
|
||||||
.finish()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl MDNSDiscoveryService {
|
|
||||||
/// Instantiate a new discovery service to find devices over mdns
|
|
||||||
pub fn new() -> Result<Self> {
|
|
||||||
Ok(MDNSDiscoveryService {
|
|
||||||
daemon: ServiceDaemon::new()?,
|
|
||||||
thread_handle: None,
|
|
||||||
})
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Start discovery by spawning a new thread responsible of getting events.
|
|
||||||
pub fn start(&mut self, sender: Sender<MDNSDevice>) -> Result<()> {
|
|
||||||
let receiver = self.daemon.browse(ADB_SERVICE_NAME)?;
|
|
||||||
|
|
||||||
let handle: JoinHandle<Result<()>> = std::thread::spawn(move || loop {
|
|
||||||
while let Ok(event) = receiver.recv() {
|
|
||||||
match event {
|
|
||||||
ServiceEvent::SearchStarted(_)
|
|
||||||
| ServiceEvent::ServiceRemoved(_, _)
|
|
||||||
| ServiceEvent::ServiceFound(_, _)
|
|
||||||
| ServiceEvent::SearchStopped(_) => {
|
|
||||||
// Ignoring these events. We are only interesting in found devices
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
ServiceEvent::ServiceResolved(service_info) => {
|
|
||||||
if let Err(e) = sender.send(MDNSDevice::from(service_info)) {
|
|
||||||
return Err(e.into());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
self.thread_handle = Some(handle);
|
|
||||||
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Shutdown discovery engines.
|
|
||||||
pub fn shutdown(&mut self) -> Result<()> {
|
|
||||||
match self.daemon.shutdown() {
|
|
||||||
Ok(_) => Ok(()),
|
|
||||||
Err(e) => match e {
|
|
||||||
mdns_sd::Error::Again => {
|
|
||||||
self.daemon.shutdown()?;
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
e => Err(RustADBError::MDNSError(e)),
|
|
||||||
},
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,5 +0,0 @@
|
|||||||
mod mdns_device;
|
|
||||||
mod mdns_discovery;
|
|
||||||
|
|
||||||
pub use mdns_device::MDNSDevice;
|
|
||||||
pub use mdns_discovery::MDNSDiscoveryService;
|
|
||||||
@@ -1,6 +1,6 @@
|
|||||||
use std::fmt::Display;
|
use std::fmt::Display;
|
||||||
|
|
||||||
pub enum ADBEmulatorCommand {
|
pub(crate) enum ADBEmulatorCommand {
|
||||||
Authenticate(String),
|
Authenticate(String),
|
||||||
Sms(String, String),
|
Sms(String, String),
|
||||||
Rotate,
|
Rotate,
|
||||||
@@ -13,27 +13,15 @@ pub(crate) enum AdbServerCommand {
|
|||||||
HostFeatures,
|
HostFeatures,
|
||||||
Connect(SocketAddrV4),
|
Connect(SocketAddrV4),
|
||||||
Disconnect(SocketAddrV4),
|
Disconnect(SocketAddrV4),
|
||||||
Pair(SocketAddrV4, String),
|
Pair(SocketAddrV4, u32),
|
||||||
TransportAny,
|
TransportAny,
|
||||||
TransportSerial(String),
|
TransportSerial(String),
|
||||||
MDNSCheck,
|
|
||||||
MDNSServices,
|
|
||||||
ServerStatus,
|
|
||||||
ReconnectOffline,
|
|
||||||
Install(u64),
|
|
||||||
// Local commands
|
// Local commands
|
||||||
ShellCommand(String),
|
ShellCommand(String),
|
||||||
Shell,
|
Shell,
|
||||||
FrameBuffer,
|
FrameBuffer,
|
||||||
Sync,
|
Sync,
|
||||||
Reboot(RebootType),
|
Reboot(RebootType),
|
||||||
Forward(String, String),
|
|
||||||
ForwardRemoveAll,
|
|
||||||
Reverse(String, String),
|
|
||||||
ReverseRemoveAll,
|
|
||||||
Reconnect,
|
|
||||||
TcpIp(u16),
|
|
||||||
Usb,
|
|
||||||
}
|
}
|
||||||
|
|
||||||
impl Display for AdbServerCommand {
|
impl Display for AdbServerCommand {
|
||||||
@@ -62,38 +50,9 @@ impl Display for AdbServerCommand {
|
|||||||
AdbServerCommand::Connect(addr) => write!(f, "host:connect:{}", addr),
|
AdbServerCommand::Connect(addr) => write!(f, "host:connect:{}", addr),
|
||||||
AdbServerCommand::Disconnect(addr) => write!(f, "host:disconnect:{}", addr),
|
AdbServerCommand::Disconnect(addr) => write!(f, "host:disconnect:{}", addr),
|
||||||
AdbServerCommand::Pair(addr, code) => {
|
AdbServerCommand::Pair(addr, code) => {
|
||||||
write!(f, "host:pair:{code}:{addr}")
|
write!(f, "host:pair:{code}:{}", addr)
|
||||||
}
|
}
|
||||||
AdbServerCommand::FrameBuffer => write!(f, "framebuffer:"),
|
AdbServerCommand::FrameBuffer => write!(f, "framebuffer:"),
|
||||||
AdbServerCommand::Forward(remote, local) => {
|
|
||||||
write!(f, "host:forward:{local};{remote}")
|
|
||||||
}
|
|
||||||
AdbServerCommand::ForwardRemoveAll => write!(f, "host:killforward-all"),
|
|
||||||
AdbServerCommand::Reverse(remote, local) => {
|
|
||||||
write!(f, "reverse:forward:{remote};{local}")
|
|
||||||
}
|
|
||||||
AdbServerCommand::ReverseRemoveAll => write!(f, "reverse:killforward-all"),
|
|
||||||
AdbServerCommand::MDNSCheck => write!(f, "host:mdns:check"),
|
|
||||||
AdbServerCommand::MDNSServices => write!(f, "host:mdns:services"),
|
|
||||||
AdbServerCommand::ServerStatus => write!(f, "host:server-status"),
|
|
||||||
AdbServerCommand::Reconnect => write!(f, "reconnect"),
|
|
||||||
AdbServerCommand::ReconnectOffline => write!(f, "host:reconnect-offline"),
|
|
||||||
AdbServerCommand::TcpIp(port) => {
|
|
||||||
write!(f, "tcpip:{port}")
|
|
||||||
}
|
|
||||||
AdbServerCommand::Usb => write!(f, "usb:"),
|
|
||||||
AdbServerCommand::Install(size) => write!(f, "exec:cmd package 'install' -S {size}"),
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn test_pair_command() {
|
|
||||||
let host = "192.168.0.197:34783";
|
|
||||||
let code = "091102";
|
|
||||||
let code_u32 = code.parse::<u32>().expect("cannot parse u32");
|
|
||||||
let pair = AdbServerCommand::Pair(host.parse().expect("cannot parse host"), code.into());
|
|
||||||
|
|
||||||
assert_eq!(pair.to_string(), format!("host:pair:{code}:{host}"));
|
|
||||||
assert_ne!(pair.to_string(), format!("host:pair:{code_u32}:{host}"))
|
|
||||||
}
|
|
||||||
|
|||||||
@@ -1,47 +0,0 @@
|
|||||||
use byteorder::ByteOrder;
|
|
||||||
use chrono::{DateTime, Utc};
|
|
||||||
use std::{
|
|
||||||
fmt::Display,
|
|
||||||
time::{Duration, UNIX_EPOCH},
|
|
||||||
};
|
|
||||||
|
|
||||||
use byteorder::LittleEndian;
|
|
||||||
use serde::{Deserialize, Serialize};
|
|
||||||
|
|
||||||
/// Represents a `stat` response
|
|
||||||
#[derive(Debug, Deserialize, Serialize)]
|
|
||||||
pub struct AdbStatResponse {
|
|
||||||
/// File permissions
|
|
||||||
pub file_perm: u32,
|
|
||||||
/// File size, in bytes
|
|
||||||
pub file_size: u32,
|
|
||||||
/// File modification time
|
|
||||||
pub mod_time: u32,
|
|
||||||
}
|
|
||||||
|
|
||||||
impl From<[u8; 12]> for AdbStatResponse {
|
|
||||||
fn from(value: [u8; 12]) -> Self {
|
|
||||||
Self {
|
|
||||||
file_perm: LittleEndian::read_u32(&value[0..4]),
|
|
||||||
file_size: LittleEndian::read_u32(&value[4..8]),
|
|
||||||
mod_time: LittleEndian::read_u32(&value[8..]),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl Display for AdbStatResponse {
|
|
||||||
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
|
|
||||||
let d = UNIX_EPOCH + Duration::from_secs(self.mod_time.into());
|
|
||||||
// Create DateTime from SystemTime
|
|
||||||
let datetime = DateTime::<Utc>::from(d);
|
|
||||||
|
|
||||||
writeln!(f, "File permissions: {}", self.file_perm)?;
|
|
||||||
writeln!(f, "File size: {} bytes", self.file_size)?;
|
|
||||||
write!(
|
|
||||||
f,
|
|
||||||
"Modification time: {}",
|
|
||||||
datetime.format("%Y-%m-%d %H:%M:%S.%f %Z")
|
|
||||||
)?;
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,15 +1,16 @@
|
|||||||
|
use lazy_static::lazy_static;
|
||||||
use std::str::FromStr;
|
use std::str::FromStr;
|
||||||
use std::sync::LazyLock;
|
|
||||||
use std::{fmt::Display, str};
|
use std::{fmt::Display, str};
|
||||||
|
|
||||||
use crate::{DeviceState, RustADBError};
|
use crate::{DeviceState, RustADBError};
|
||||||
use regex::bytes::Regex;
|
use regex::bytes::Regex;
|
||||||
|
|
||||||
static DEVICES_LONG_REGEX: LazyLock<Regex> = LazyLock::new(|| {
|
lazy_static! {
|
||||||
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 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");
|
||||||
});
|
|
||||||
|
|
||||||
/// Represents a new device with more informations.
|
}
|
||||||
|
|
||||||
|
/// Represents a new device with more informations helded.
|
||||||
#[derive(Debug)]
|
#[derive(Debug)]
|
||||||
pub struct DeviceLong {
|
pub struct DeviceLong {
|
||||||
/// Unique device identifier.
|
/// Unique device identifier.
|
||||||
@@ -67,13 +68,14 @@ impl TryFrom<Vec<u8>> for DeviceLong {
|
|||||||
.as_bytes()
|
.as_bytes()
|
||||||
.to_vec(),
|
.to_vec(),
|
||||||
)?)?,
|
)?)?,
|
||||||
usb: match groups.name("usb1") {
|
usb: String::from_utf8(
|
||||||
None => match groups.name("usb2") {
|
groups
|
||||||
None => "Unk".to_string(),
|
.name("usb1")
|
||||||
Some(usb) => String::from_utf8(usb.as_bytes().to_vec())?,
|
.or_else(|| groups.name("usb2"))
|
||||||
},
|
.ok_or(RustADBError::RegexParsingError)?
|
||||||
Some(usb) => String::from_utf8(usb.as_bytes().to_vec())?,
|
.as_bytes()
|
||||||
},
|
.to_vec(),
|
||||||
|
)?,
|
||||||
product: match groups.name("product") {
|
product: match groups.name("product") {
|
||||||
None => "Unk".to_string(),
|
None => "Unk".to_string(),
|
||||||
Some(product) => String::from_utf8(product.as_bytes().to_vec())?,
|
Some(product) => String::from_utf8(product.as_bytes().to_vec())?,
|
||||||
@@ -1,10 +1,12 @@
|
|||||||
|
use lazy_static::lazy_static;
|
||||||
use regex::bytes::Regex;
|
use regex::bytes::Regex;
|
||||||
use std::{fmt::Display, str::FromStr, sync::LazyLock};
|
use std::{fmt::Display, str::FromStr};
|
||||||
|
|
||||||
use crate::{DeviceState, RustADBError};
|
use crate::{DeviceState, RustADBError};
|
||||||
|
|
||||||
static DEVICES_REGEX: LazyLock<Regex> =
|
lazy_static! {
|
||||||
LazyLock::new(|| Regex::new("^(\\S+)\t(\\w+)\n?$").expect("Cannot build devices regex"));
|
static ref DEVICES_REGEX: Regex = Regex::new("^(\\S+)\t(\\w+)\n?$").unwrap();
|
||||||
|
}
|
||||||
|
|
||||||
/// Represents a device connected to the ADB server.
|
/// Represents a device connected to the ADB server.
|
||||||
#[derive(Debug, Clone)]
|
#[derive(Debug, Clone)]
|
||||||
@@ -26,9 +28,7 @@ impl TryFrom<Vec<u8>> for DeviceShort {
|
|||||||
|
|
||||||
fn try_from(value: Vec<u8>) -> Result<Self, Self::Error> {
|
fn try_from(value: Vec<u8>) -> Result<Self, Self::Error> {
|
||||||
// Optional final '\n' is used to match TrackDevices inputs
|
// Optional final '\n' is used to match TrackDevices inputs
|
||||||
let groups = DEVICES_REGEX
|
let groups = DEVICES_REGEX.captures(&value).unwrap();
|
||||||
.captures(&value)
|
|
||||||
.ok_or(RustADBError::RegexParsingError)?;
|
|
||||||
Ok(DeviceShort {
|
Ok(DeviceShort {
|
||||||
identifier: String::from_utf8(
|
identifier: String::from_utf8(
|
||||||
groups
|
groups
|
||||||
@@ -15,22 +15,6 @@ pub enum DeviceState {
|
|||||||
Authorizing,
|
Authorizing,
|
||||||
/// The device is unauthorized.
|
/// The device is unauthorized.
|
||||||
Unauthorized,
|
Unauthorized,
|
||||||
/// Haven't received a response from the device yet.
|
|
||||||
Connecting,
|
|
||||||
/// Insufficient permissions to communicate with the device.
|
|
||||||
NoPerm,
|
|
||||||
/// USB device detached from the adb server (known but not opened/claimed).
|
|
||||||
Detached,
|
|
||||||
/// Device running fastboot OS (fastboot) or userspace fastboot (fastbootd).
|
|
||||||
Bootloader,
|
|
||||||
/// What a device sees from its end of a Transport (adb host).
|
|
||||||
Host,
|
|
||||||
/// Device with bootloader loaded but no ROM OS loaded (adbd).
|
|
||||||
Recovery,
|
|
||||||
/// Device running Android OS Sideload mode (minadbd sideload mode).
|
|
||||||
Sideload,
|
|
||||||
/// Device running Android OS Rescue mode (minadbd rescue mode).
|
|
||||||
Rescue,
|
|
||||||
}
|
}
|
||||||
|
|
||||||
impl Display for DeviceState {
|
impl Display for DeviceState {
|
||||||
@@ -41,14 +25,6 @@ impl Display for DeviceState {
|
|||||||
DeviceState::NoDevice => write!(f, "no device"),
|
DeviceState::NoDevice => write!(f, "no device"),
|
||||||
DeviceState::Authorizing => write!(f, "authorizing"),
|
DeviceState::Authorizing => write!(f, "authorizing"),
|
||||||
DeviceState::Unauthorized => write!(f, "unauthorized"),
|
DeviceState::Unauthorized => write!(f, "unauthorized"),
|
||||||
DeviceState::Connecting => write!(f, "connecting"),
|
|
||||||
DeviceState::NoPerm => write!(f, "noperm"),
|
|
||||||
DeviceState::Detached => write!(f, "detached"),
|
|
||||||
DeviceState::Bootloader => write!(f, "bootloader"),
|
|
||||||
DeviceState::Host => write!(f, "host"),
|
|
||||||
DeviceState::Recovery => write!(f, "recovery"),
|
|
||||||
DeviceState::Sideload => write!(f, "sideload"),
|
|
||||||
DeviceState::Rescue => write!(f, "rescue"),
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -64,14 +40,6 @@ impl FromStr for DeviceState {
|
|||||||
"no device" => Ok(Self::NoDevice),
|
"no device" => Ok(Self::NoDevice),
|
||||||
"authorizing" => Ok(Self::Authorizing),
|
"authorizing" => Ok(Self::Authorizing),
|
||||||
"unauthorized" => Ok(Self::Unauthorized),
|
"unauthorized" => Ok(Self::Unauthorized),
|
||||||
"connecting" => Ok(Self::Connecting),
|
|
||||||
"noperm" => Ok(Self::NoPerm),
|
|
||||||
"detached" => Ok(Self::Detached),
|
|
||||||
"bootloader" => Ok(Self::Bootloader),
|
|
||||||
"host" => Ok(Self::Host),
|
|
||||||
"recovery" => Ok(Self::Recovery),
|
|
||||||
"sideload" => Ok(Self::Sideload),
|
|
||||||
"rescue" => Ok(Self::Rescue),
|
|
||||||
_ => Err(RustADBError::UnknownDeviceState(lowercased)),
|
_ => Err(RustADBError::UnknownDeviceState(lowercased)),
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -1,97 +0,0 @@
|
|||||||
use std::{iter::Map, slice::ChunksExact};
|
|
||||||
|
|
||||||
use byteorder::{ByteOrder, LittleEndian};
|
|
||||||
|
|
||||||
use crate::{Result, RustADBError};
|
|
||||||
|
|
||||||
type U32ChunkIter<'a> = Map<ChunksExact<'a, u8>, fn(&[u8]) -> Result<u32>>;
|
|
||||||
|
|
||||||
fn read_next(chunks: &mut U32ChunkIter) -> Result<u32> {
|
|
||||||
chunks
|
|
||||||
.next()
|
|
||||||
.ok_or(RustADBError::FramebufferConversionError)?
|
|
||||||
}
|
|
||||||
|
|
||||||
#[derive(Debug)]
|
|
||||||
pub(crate) struct FrameBufferInfoV1 {
|
|
||||||
pub _bpp: u32,
|
|
||||||
pub size: u32,
|
|
||||||
pub width: u32,
|
|
||||||
pub height: u32,
|
|
||||||
pub _red_offset: u32,
|
|
||||||
pub _red_length: u32,
|
|
||||||
pub _blue_offset: u32,
|
|
||||||
pub _blue_length: u32,
|
|
||||||
pub _green_offset: u32,
|
|
||||||
pub _green_length: u32,
|
|
||||||
pub _alpha_offset: u32,
|
|
||||||
pub _alpha_length: u32,
|
|
||||||
}
|
|
||||||
|
|
||||||
impl TryFrom<[u8; std::mem::size_of::<Self>()]> for FrameBufferInfoV1 {
|
|
||||||
type Error = RustADBError;
|
|
||||||
|
|
||||||
fn try_from(
|
|
||||||
value: [u8; std::mem::size_of::<Self>()],
|
|
||||||
) -> std::result::Result<Self, Self::Error> {
|
|
||||||
let mut chunks: U32ChunkIter = value.chunks_exact(4).map(|v| Ok(LittleEndian::read_u32(v)));
|
|
||||||
|
|
||||||
Ok(Self {
|
|
||||||
_bpp: read_next(&mut chunks)?,
|
|
||||||
size: read_next(&mut chunks)?,
|
|
||||||
width: read_next(&mut chunks)?,
|
|
||||||
height: read_next(&mut chunks)?,
|
|
||||||
_red_offset: read_next(&mut chunks)?,
|
|
||||||
_red_length: read_next(&mut chunks)?,
|
|
||||||
_blue_offset: read_next(&mut chunks)?,
|
|
||||||
_blue_length: read_next(&mut chunks)?,
|
|
||||||
_green_offset: read_next(&mut chunks)?,
|
|
||||||
_green_length: read_next(&mut chunks)?,
|
|
||||||
_alpha_offset: read_next(&mut chunks)?,
|
|
||||||
_alpha_length: read_next(&mut chunks)?,
|
|
||||||
})
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
#[derive(Debug)]
|
|
||||||
pub(crate) struct FrameBufferInfoV2 {
|
|
||||||
pub _bpp: u32,
|
|
||||||
pub _color_space: u32,
|
|
||||||
pub size: u32,
|
|
||||||
pub width: u32,
|
|
||||||
pub height: u32,
|
|
||||||
pub _red_offset: u32,
|
|
||||||
pub _red_length: u32,
|
|
||||||
pub _blue_offset: u32,
|
|
||||||
pub _blue_length: u32,
|
|
||||||
pub _green_offset: u32,
|
|
||||||
pub _green_length: u32,
|
|
||||||
pub _alpha_offset: u32,
|
|
||||||
pub _alpha_length: u32,
|
|
||||||
}
|
|
||||||
|
|
||||||
impl TryFrom<[u8; std::mem::size_of::<Self>()]> for FrameBufferInfoV2 {
|
|
||||||
type Error = RustADBError;
|
|
||||||
|
|
||||||
fn try_from(
|
|
||||||
value: [u8; std::mem::size_of::<Self>()],
|
|
||||||
) -> std::result::Result<Self, Self::Error> {
|
|
||||||
let mut chunks: U32ChunkIter = value.chunks_exact(4).map(|v| Ok(LittleEndian::read_u32(v)));
|
|
||||||
|
|
||||||
Ok(Self {
|
|
||||||
_bpp: read_next(&mut chunks)?,
|
|
||||||
_color_space: read_next(&mut chunks)?,
|
|
||||||
size: read_next(&mut chunks)?,
|
|
||||||
width: read_next(&mut chunks)?,
|
|
||||||
height: read_next(&mut chunks)?,
|
|
||||||
_red_offset: read_next(&mut chunks)?,
|
|
||||||
_red_length: read_next(&mut chunks)?,
|
|
||||||
_blue_offset: read_next(&mut chunks)?,
|
|
||||||
_blue_length: read_next(&mut chunks)?,
|
|
||||||
_green_offset: read_next(&mut chunks)?,
|
|
||||||
_green_length: read_next(&mut chunks)?,
|
|
||||||
_alpha_offset: read_next(&mut chunks)?,
|
|
||||||
_alpha_length: read_next(&mut chunks)?,
|
|
||||||
})
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,15 +1,21 @@
|
|||||||
|
mod adb_emulator_command;
|
||||||
mod adb_request_status;
|
mod adb_request_status;
|
||||||
mod adb_server_command;
|
mod adb_server_command;
|
||||||
mod adb_stat_response;
|
mod adb_version;
|
||||||
mod framebuffer_info;
|
mod device_long;
|
||||||
|
mod device_short;
|
||||||
|
mod device_state;
|
||||||
mod host_features;
|
mod host_features;
|
||||||
mod reboot_type;
|
mod reboot_type;
|
||||||
mod sync_command;
|
mod sync_command;
|
||||||
|
|
||||||
|
pub(crate) use adb_emulator_command::ADBEmulatorCommand;
|
||||||
pub use adb_request_status::AdbRequestStatus;
|
pub use adb_request_status::AdbRequestStatus;
|
||||||
pub(crate) use adb_server_command::AdbServerCommand;
|
pub(crate) use adb_server_command::AdbServerCommand;
|
||||||
pub use adb_stat_response::AdbStatResponse;
|
pub use adb_version::AdbVersion;
|
||||||
pub(crate) use framebuffer_info::{FrameBufferInfoV1, FrameBufferInfoV2};
|
pub use device_long::DeviceLong;
|
||||||
|
pub use device_short::DeviceShort;
|
||||||
|
pub use device_state::DeviceState;
|
||||||
pub use host_features::HostFeatures;
|
pub use host_features::HostFeatures;
|
||||||
pub use reboot_type::RebootType;
|
pub use reboot_type::RebootType;
|
||||||
pub use sync_command::SyncCommand;
|
pub use sync_command::SyncCommand;
|
||||||
|
|||||||
@@ -1,14 +1,15 @@
|
|||||||
use std::{
|
use std::net::{Ipv4Addr, SocketAddrV4};
|
||||||
net::{Ipv4Addr, SocketAddrV4},
|
|
||||||
sync::LazyLock,
|
|
||||||
};
|
|
||||||
|
|
||||||
use crate::{ADBServerDevice, ADBTransport, Result, RustADBError, TCPEmulatorTransport};
|
use crate::{ADBTransport, Result, RustADBError, TCPEmulatorTransport};
|
||||||
|
use lazy_static::lazy_static;
|
||||||
use regex::Regex;
|
use regex::Regex;
|
||||||
|
|
||||||
static EMULATOR_REGEX: LazyLock<Regex> = LazyLock::new(|| {
|
use super::ADBServerDevice;
|
||||||
Regex::new("^emulator-(?P<port>\\d+)$").expect("wrong syntax for emulator regex")
|
|
||||||
});
|
lazy_static! {
|
||||||
|
pub static ref EMULATOR_REGEX: Regex =
|
||||||
|
Regex::new("^emulator-(?P<port>\\d+)$").expect("wrong syntax for emulator regex");
|
||||||
|
}
|
||||||
|
|
||||||
/// Represents an emulator connected to the ADB server.
|
/// Represents an emulator connected to the ADB server.
|
||||||
#[derive(Debug)]
|
#[derive(Debug)]
|
||||||
@@ -67,7 +68,7 @@ impl TryFrom<ADBServerDevice> for ADBEmulatorDevice {
|
|||||||
fn try_from(value: ADBServerDevice) -> std::result::Result<Self, Self::Error> {
|
fn try_from(value: ADBServerDevice) -> std::result::Result<Self, Self::Error> {
|
||||||
ADBEmulatorDevice::new(
|
ADBEmulatorDevice::new(
|
||||||
value.identifier.clone(),
|
value.identifier.clone(),
|
||||||
Some(*value.transport.get_socketaddr().ip()),
|
Some(*value.get_transport().get_socketaddr().ip()),
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -2,7 +2,6 @@ use crate::ADBTransport;
|
|||||||
use crate::Result;
|
use crate::Result;
|
||||||
use crate::RustADBError;
|
use crate::RustADBError;
|
||||||
use crate::TCPServerTransport;
|
use crate::TCPServerTransport;
|
||||||
use std::collections::HashMap;
|
|
||||||
use std::net::SocketAddrV4;
|
use std::net::SocketAddrV4;
|
||||||
use std::process::Command;
|
use std::process::Command;
|
||||||
|
|
||||||
@@ -13,8 +12,6 @@ pub struct ADBServer {
|
|||||||
pub(crate) transport: Option<TCPServerTransport>,
|
pub(crate) transport: Option<TCPServerTransport>,
|
||||||
/// Address to connect to
|
/// Address to connect to
|
||||||
pub(crate) socket_addr: Option<SocketAddrV4>,
|
pub(crate) socket_addr: Option<SocketAddrV4>,
|
||||||
/// adb-server start envs
|
|
||||||
pub(crate) envs: HashMap<String, String>,
|
|
||||||
}
|
}
|
||||||
|
|
||||||
impl ADBServer {
|
impl ADBServer {
|
||||||
@@ -23,7 +20,6 @@ impl ADBServer {
|
|||||||
Self {
|
Self {
|
||||||
transport: None,
|
transport: None,
|
||||||
socket_addr: Some(address),
|
socket_addr: Some(address),
|
||||||
envs: HashMap::new(),
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -53,13 +49,7 @@ impl ADBServer {
|
|||||||
|
|
||||||
if is_local_ip {
|
if is_local_ip {
|
||||||
// ADB Server is local, we start it if not already running
|
// ADB Server is local, we start it if not already running
|
||||||
let mut command = Command::new("adb");
|
let child = Command::new("adb").arg("start-server").spawn();
|
||||||
command.arg("start-server");
|
|
||||||
for (env_k, env_v) in self.envs.iter() {
|
|
||||||
command.env(env_k, env_v);
|
|
||||||
}
|
|
||||||
|
|
||||||
let child = command.spawn();
|
|
||||||
match child {
|
match child {
|
||||||
Ok(mut child) => {
|
Ok(mut child) => {
|
||||||
if let Err(e) = child.wait() {
|
if let Err(e) = child.wait() {
|
||||||
|
|||||||
@@ -7,7 +7,7 @@ pub struct ADBServerDevice {
|
|||||||
/// Unique device identifier.
|
/// Unique device identifier.
|
||||||
pub identifier: String,
|
pub identifier: String,
|
||||||
/// Internal [TCPServerTransport]
|
/// Internal [TCPServerTransport]
|
||||||
pub(crate) transport: TCPServerTransport,
|
transport: TCPServerTransport,
|
||||||
}
|
}
|
||||||
|
|
||||||
impl ADBServerDevice {
|
impl ADBServerDevice {
|
||||||
@@ -25,11 +25,19 @@ impl ADBServerDevice {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
pub(crate) fn get_transport(&self) -> &TCPServerTransport {
|
||||||
|
&self.transport
|
||||||
|
}
|
||||||
|
|
||||||
|
pub(crate) fn get_transport_mut(&mut self) -> &mut TCPServerTransport {
|
||||||
|
&mut self.transport
|
||||||
|
}
|
||||||
|
|
||||||
/// Connect to underlying transport
|
/// Connect to underlying transport
|
||||||
pub(crate) fn connect(&mut self) -> Result<&mut TCPServerTransport> {
|
pub(crate) fn connect(&mut self) -> Result<&mut TCPServerTransport> {
|
||||||
self.transport.connect()?;
|
self.transport.connect()?;
|
||||||
|
|
||||||
Ok(&mut self.transport)
|
Ok(self.get_transport_mut())
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -1,61 +0,0 @@
|
|||||||
use std::io::BufRead;
|
|
||||||
|
|
||||||
use crate::{
|
|
||||||
models::AdbServerCommand, server::models::MDNSBackend, ADBServer, MDNSServices, Result,
|
|
||||||
};
|
|
||||||
|
|
||||||
const OPENSCREEN_MDNS_BACKEND: &str = "ADB_MDNS_OPENSCREEN";
|
|
||||||
|
|
||||||
impl ADBServer {
|
|
||||||
/// Check if mdns discovery is available
|
|
||||||
pub fn mdns_check(&mut self) -> Result<bool> {
|
|
||||||
let response = self
|
|
||||||
.connect()?
|
|
||||||
.proxy_connection(AdbServerCommand::MDNSCheck, true)?;
|
|
||||||
|
|
||||||
match String::from_utf8(response) {
|
|
||||||
Ok(s) if s.starts_with("mdns daemon version") => Ok(true),
|
|
||||||
Ok(_) => Ok(false),
|
|
||||||
Err(e) => Err(e.into()),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// List all discovered mdns services
|
|
||||||
pub fn mdns_services(&mut self) -> Result<Vec<MDNSServices>> {
|
|
||||||
let services = self
|
|
||||||
.connect()?
|
|
||||||
.proxy_connection(AdbServerCommand::MDNSServices, true)?;
|
|
||||||
|
|
||||||
let mut vec_services: Vec<MDNSServices> = vec![];
|
|
||||||
for service in services.lines() {
|
|
||||||
match service {
|
|
||||||
Ok(service) => {
|
|
||||||
vec_services.push(MDNSServices::try_from(service.as_bytes())?);
|
|
||||||
}
|
|
||||||
Err(e) => log::error!("{}", e),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
Ok(vec_services)
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Check if specified backend mdns service is used, otherwise restart adb server with envs
|
|
||||||
pub fn mdns_force_backend(&mut self, backend: MDNSBackend) -> Result<()> {
|
|
||||||
let server_status = self.server_status()?;
|
|
||||||
if server_status.mdns_backend != backend {
|
|
||||||
self.kill()?;
|
|
||||||
self.envs.insert(
|
|
||||||
OPENSCREEN_MDNS_BACKEND.to_string(),
|
|
||||||
(if backend == MDNSBackend::OpenScreen {
|
|
||||||
"1"
|
|
||||||
} else {
|
|
||||||
"0"
|
|
||||||
})
|
|
||||||
.to_string(),
|
|
||||||
);
|
|
||||||
self.connect()?;
|
|
||||||
}
|
|
||||||
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,10 +0,0 @@
|
|||||||
use crate::{models::AdbServerCommand, ADBServer, Result};
|
|
||||||
|
|
||||||
impl ADBServer {
|
|
||||||
/// Reconnect the device
|
|
||||||
pub fn reconnect_offline(&mut self) -> Result<()> {
|
|
||||||
self.connect()?
|
|
||||||
.proxy_connection(AdbServerCommand::ReconnectOffline, false)
|
|
||||||
.map(|_| ())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
use crate::{models::AdbServerCommand, server::models::ServerStatus, ADBServer, Result};
|
|
||||||
|
|
||||||
impl ADBServer {
|
|
||||||
/// Check ADB server status
|
|
||||||
pub fn server_status(&mut self) -> Result<ServerStatus> {
|
|
||||||
let status = self
|
|
||||||
.connect()?
|
|
||||||
.proxy_connection(AdbServerCommand::ServerStatus, true)?;
|
|
||||||
|
|
||||||
ServerStatus::try_from(status)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
176
adb_client/src/server/device_commands/framebuffer.rs
Normal file
176
adb_client/src/server/device_commands/framebuffer.rs
Normal file
@@ -0,0 +1,176 @@
|
|||||||
|
use std::{io::Read, iter::Map, path::Path, slice::ChunksExact};
|
||||||
|
|
||||||
|
use byteorder::{LittleEndian, ReadBytesExt};
|
||||||
|
use image::{ImageBuffer, Rgba};
|
||||||
|
|
||||||
|
use crate::{models::AdbServerCommand, utils, ADBServerDevice, Result, RustADBError};
|
||||||
|
|
||||||
|
type U32ChunkIter<'a> = Map<ChunksExact<'a, u8>, fn(&[u8]) -> Result<u32>>;
|
||||||
|
|
||||||
|
fn read_next(chunks: &mut U32ChunkIter) -> Result<u32> {
|
||||||
|
chunks
|
||||||
|
.next()
|
||||||
|
.ok_or(RustADBError::FramebufferConversionError)?
|
||||||
|
}
|
||||||
|
|
||||||
|
#[derive(Debug)]
|
||||||
|
struct FrameBufferInfoV1 {
|
||||||
|
pub _bpp: u32,
|
||||||
|
pub size: u32,
|
||||||
|
pub width: u32,
|
||||||
|
pub height: u32,
|
||||||
|
pub _red_offset: u32,
|
||||||
|
pub _red_length: u32,
|
||||||
|
pub _blue_offset: u32,
|
||||||
|
pub _blue_length: u32,
|
||||||
|
pub _green_offset: u32,
|
||||||
|
pub _green_length: u32,
|
||||||
|
pub _alpha_offset: u32,
|
||||||
|
pub _alpha_length: u32,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl TryFrom<[u8; std::mem::size_of::<Self>()]> for FrameBufferInfoV1 {
|
||||||
|
type Error = RustADBError;
|
||||||
|
|
||||||
|
fn try_from(
|
||||||
|
value: [u8; std::mem::size_of::<Self>()],
|
||||||
|
) -> std::result::Result<Self, Self::Error> {
|
||||||
|
let mut chunks: U32ChunkIter = value.chunks_exact(4).map(utils::u32_from_le);
|
||||||
|
|
||||||
|
Ok(Self {
|
||||||
|
_bpp: read_next(&mut chunks)?,
|
||||||
|
size: read_next(&mut chunks)?,
|
||||||
|
width: read_next(&mut chunks)?,
|
||||||
|
height: read_next(&mut chunks)?,
|
||||||
|
_red_offset: read_next(&mut chunks)?,
|
||||||
|
_red_length: read_next(&mut chunks)?,
|
||||||
|
_blue_offset: read_next(&mut chunks)?,
|
||||||
|
_blue_length: read_next(&mut chunks)?,
|
||||||
|
_green_offset: read_next(&mut chunks)?,
|
||||||
|
_green_length: read_next(&mut chunks)?,
|
||||||
|
_alpha_offset: read_next(&mut chunks)?,
|
||||||
|
_alpha_length: read_next(&mut chunks)?,
|
||||||
|
})
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[derive(Debug)]
|
||||||
|
struct FrameBufferInfoV2 {
|
||||||
|
pub _bpp: u32,
|
||||||
|
pub _color_space: u32,
|
||||||
|
pub size: u32,
|
||||||
|
pub width: u32,
|
||||||
|
pub height: u32,
|
||||||
|
pub _red_offset: u32,
|
||||||
|
pub _red_length: u32,
|
||||||
|
pub _blue_offset: u32,
|
||||||
|
pub _blue_length: u32,
|
||||||
|
pub _green_offset: u32,
|
||||||
|
pub _green_length: u32,
|
||||||
|
pub _alpha_offset: u32,
|
||||||
|
pub _alpha_length: u32,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl TryFrom<[u8; std::mem::size_of::<Self>()]> for FrameBufferInfoV2 {
|
||||||
|
type Error = RustADBError;
|
||||||
|
|
||||||
|
fn try_from(
|
||||||
|
value: [u8; std::mem::size_of::<Self>()],
|
||||||
|
) -> std::result::Result<Self, Self::Error> {
|
||||||
|
let mut chunks: U32ChunkIter = value.chunks_exact(4).map(utils::u32_from_le);
|
||||||
|
|
||||||
|
Ok(Self {
|
||||||
|
_bpp: read_next(&mut chunks)?,
|
||||||
|
_color_space: read_next(&mut chunks)?,
|
||||||
|
size: read_next(&mut chunks)?,
|
||||||
|
width: read_next(&mut chunks)?,
|
||||||
|
height: read_next(&mut chunks)?,
|
||||||
|
_red_offset: read_next(&mut chunks)?,
|
||||||
|
_red_length: read_next(&mut chunks)?,
|
||||||
|
_blue_offset: read_next(&mut chunks)?,
|
||||||
|
_blue_length: read_next(&mut chunks)?,
|
||||||
|
_green_offset: read_next(&mut chunks)?,
|
||||||
|
_green_length: read_next(&mut chunks)?,
|
||||||
|
_alpha_offset: read_next(&mut chunks)?,
|
||||||
|
_alpha_length: read_next(&mut chunks)?,
|
||||||
|
})
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl ADBServerDevice {
|
||||||
|
/// Dump framebuffer of this device
|
||||||
|
/// 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())?)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Inner method requesting framebuffer from Android device
|
||||||
|
fn framebuffer_inner(&mut self) -> Result<ImageBuffer<Rgba<u8>, Vec<u8>>> {
|
||||||
|
let serial: String = self.identifier.clone();
|
||||||
|
self.connect()?
|
||||||
|
.send_adb_request(AdbServerCommand::TransportSerial(serial))?;
|
||||||
|
|
||||||
|
self.get_transport_mut()
|
||||||
|
.send_adb_request(AdbServerCommand::FrameBuffer)?;
|
||||||
|
|
||||||
|
let version = self
|
||||||
|
.get_transport_mut()
|
||||||
|
.get_raw_connection()?
|
||||||
|
.read_u32::<LittleEndian>()?;
|
||||||
|
|
||||||
|
match version {
|
||||||
|
// RGBA_8888
|
||||||
|
1 => {
|
||||||
|
let mut buf = [0u8; std::mem::size_of::<FrameBufferInfoV1>()];
|
||||||
|
|
||||||
|
self.get_transport_mut()
|
||||||
|
.get_raw_connection()?
|
||||||
|
.read_exact(&mut buf)?;
|
||||||
|
|
||||||
|
let h: FrameBufferInfoV1 = buf.try_into()?;
|
||||||
|
|
||||||
|
let mut data = vec![
|
||||||
|
0_u8;
|
||||||
|
h.size
|
||||||
|
.try_into()
|
||||||
|
.map_err(|_| RustADBError::ConversionError)?
|
||||||
|
];
|
||||||
|
self.get_transport_mut()
|
||||||
|
.get_raw_connection()?
|
||||||
|
.read_exact(&mut data)?;
|
||||||
|
|
||||||
|
Ok(
|
||||||
|
ImageBuffer::<Rgba<u8>, Vec<u8>>::from_vec(h.width, h.height, data)
|
||||||
|
.ok_or_else(|| RustADBError::FramebufferConversionError)?,
|
||||||
|
)
|
||||||
|
}
|
||||||
|
// RGBX_8888
|
||||||
|
2 => {
|
||||||
|
let mut buf = [0u8; std::mem::size_of::<FrameBufferInfoV2>()];
|
||||||
|
|
||||||
|
self.get_transport_mut()
|
||||||
|
.get_raw_connection()?
|
||||||
|
.read_exact(&mut buf)?;
|
||||||
|
|
||||||
|
let h: FrameBufferInfoV2 = buf.try_into()?;
|
||||||
|
|
||||||
|
let mut data = vec![
|
||||||
|
0_u8;
|
||||||
|
h.size
|
||||||
|
.try_into()
|
||||||
|
.map_err(|_| RustADBError::ConversionError)?
|
||||||
|
];
|
||||||
|
self.get_transport_mut()
|
||||||
|
.get_raw_connection()?
|
||||||
|
.read_exact(&mut data)?;
|
||||||
|
|
||||||
|
Ok(
|
||||||
|
ImageBuffer::<Rgba<u8>, Vec<u8>>::from_vec(h.width, h.height, data)
|
||||||
|
.ok_or_else(|| RustADBError::FramebufferConversionError)?,
|
||||||
|
)
|
||||||
|
}
|
||||||
|
v => unimplemented!("Version {} not implemented", v),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -11,7 +11,7 @@ impl ADBServerDevice {
|
|||||||
.send_adb_request(AdbServerCommand::TransportSerial(serial))?;
|
.send_adb_request(AdbServerCommand::TransportSerial(serial))?;
|
||||||
|
|
||||||
let features = self
|
let features = self
|
||||||
.transport
|
.get_transport_mut()
|
||||||
.proxy_connection(AdbServerCommand::HostFeatures, true)?;
|
.proxy_connection(AdbServerCommand::HostFeatures, true)?;
|
||||||
|
|
||||||
Ok(features
|
Ok(features
|
||||||
@@ -9,17 +9,19 @@ use std::{
|
|||||||
};
|
};
|
||||||
|
|
||||||
impl ADBServerDevice {
|
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<()> {
|
pub fn list<A: AsRef<str>>(&mut self, path: A) -> Result<()> {
|
||||||
let serial = self.identifier.clone();
|
let serial = self.identifier.clone();
|
||||||
self.connect()?
|
self.connect()?
|
||||||
.send_adb_request(AdbServerCommand::TransportSerial(serial))?;
|
.send_adb_request(AdbServerCommand::TransportSerial(serial))?;
|
||||||
|
|
||||||
// Set device in SYNC mode
|
// Set device in SYNC mode
|
||||||
self.transport.send_adb_request(AdbServerCommand::Sync)?;
|
self.get_transport_mut()
|
||||||
|
.send_adb_request(AdbServerCommand::Sync)?;
|
||||||
|
|
||||||
// Send a list command
|
// Send a list command
|
||||||
self.transport.send_sync_request(SyncCommand::List)?;
|
self.get_transport_mut()
|
||||||
|
.send_sync_request(SyncCommand::List)?;
|
||||||
|
|
||||||
self.handle_list_command(path)
|
self.handle_list_command(path)
|
||||||
}
|
}
|
||||||
@@ -31,17 +33,19 @@ impl ADBServerDevice {
|
|||||||
LittleEndian::write_u32(&mut len_buf, path.as_ref().len() as u32);
|
LittleEndian::write_u32(&mut len_buf, path.as_ref().len() as u32);
|
||||||
|
|
||||||
// 4 bytes of command name is already sent by send_sync_request
|
// 4 bytes of command name is already sent by send_sync_request
|
||||||
self.transport.get_raw_connection()?.write_all(&len_buf)?;
|
self.get_transport_mut()
|
||||||
|
.get_raw_connection()?
|
||||||
|
.write_all(&len_buf)?;
|
||||||
|
|
||||||
// List send the string of the directory to list, and then the server send a list of files
|
// List send the string of the directory to list, and then the server send a list of files
|
||||||
self.transport
|
self.get_transport_mut()
|
||||||
.get_raw_connection()?
|
.get_raw_connection()?
|
||||||
.write_all(path.as_ref().to_string().as_bytes())?;
|
.write_all(path.as_ref().to_string().as_bytes())?;
|
||||||
|
|
||||||
// Reads returned status code from ADB server
|
// Reads returned status code from ADB server
|
||||||
let mut response = [0_u8; 4];
|
let mut response = [0_u8; 4];
|
||||||
loop {
|
loop {
|
||||||
self.transport
|
self.get_transport_mut()
|
||||||
.get_raw_connection()?
|
.get_raw_connection()?
|
||||||
.read_exact(&mut response)?;
|
.read_exact(&mut response)?;
|
||||||
match str::from_utf8(response.as_ref())? {
|
match str::from_utf8(response.as_ref())? {
|
||||||
@@ -53,7 +57,7 @@ impl ADBServerDevice {
|
|||||||
let mut mod_time = [0_u8; 4];
|
let mut mod_time = [0_u8; 4];
|
||||||
let mut name_len = [0_u8; 4];
|
let mut name_len = [0_u8; 4];
|
||||||
|
|
||||||
let mut connection = self.transport.get_raw_connection()?;
|
let mut connection = self.get_transport_mut().get_raw_connection()?;
|
||||||
connection.read_exact(&mut file_mod)?;
|
connection.read_exact(&mut file_mod)?;
|
||||||
connection.read_exact(&mut file_size)?;
|
connection.read_exact(&mut file_size)?;
|
||||||
connection.read_exact(&mut mod_time)?;
|
connection.read_exact(&mut mod_time)?;
|
||||||
@@ -1,6 +1,6 @@
|
|||||||
use std::io::{self, Write};
|
use std::io::{self, Write};
|
||||||
|
|
||||||
use crate::{ADBDeviceExt, ADBServerDevice, Result};
|
use crate::{ADBServerDevice, Result};
|
||||||
|
|
||||||
struct LogFilter<W: Write> {
|
struct LogFilter<W: Write> {
|
||||||
writer: W,
|
writer: W,
|
||||||
@@ -51,6 +51,6 @@ impl<W: Write> Write for LogFilter<W> {
|
|||||||
impl ADBServerDevice {
|
impl ADBServerDevice {
|
||||||
/// Get logs from device
|
/// Get logs from device
|
||||||
pub fn get_logs<W: Write>(&mut self, output: W) -> Result<()> {
|
pub fn get_logs<W: Write>(&mut self, output: W) -> Result<()> {
|
||||||
self.shell_command(&["exec logcat"], &mut LogFilter::new(output))
|
self.shell_command(["exec logcat"], LogFilter::new(output))
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -1,15 +1,10 @@
|
|||||||
mod forward;
|
|
||||||
mod framebuffer;
|
mod framebuffer;
|
||||||
mod host_features;
|
mod host_features;
|
||||||
mod install;
|
|
||||||
mod list;
|
mod list;
|
||||||
mod logcat;
|
mod logcat;
|
||||||
mod reboot;
|
mod reboot;
|
||||||
mod reconnect;
|
|
||||||
mod recv;
|
mod recv;
|
||||||
mod reverse;
|
|
||||||
mod send;
|
mod send;
|
||||||
|
mod shell;
|
||||||
mod stat;
|
mod stat;
|
||||||
mod tcpip;
|
|
||||||
mod transport;
|
mod transport;
|
||||||
mod usb;
|
|
||||||
@@ -10,7 +10,7 @@ impl ADBServerDevice {
|
|||||||
self.connect()?
|
self.connect()?
|
||||||
.send_adb_request(AdbServerCommand::TransportSerial(serial))?;
|
.send_adb_request(AdbServerCommand::TransportSerial(serial))?;
|
||||||
|
|
||||||
self.transport
|
self.get_transport_mut()
|
||||||
.proxy_connection(AdbServerCommand::Reboot(reboot_type), false)
|
.proxy_connection(AdbServerCommand::Reboot(reboot_type), false)
|
||||||
.map(|_| ())
|
.map(|_| ())
|
||||||
}
|
}
|
||||||
85
adb_client/src/server/device_commands/recv.rs
Normal file
85
adb_client/src/server/device_commands/recv.rs
Normal file
@@ -0,0 +1,85 @@
|
|||||||
|
use crate::{
|
||||||
|
models::{AdbServerCommand, SyncCommand},
|
||||||
|
ADBServerDevice, Result, RustADBError,
|
||||||
|
};
|
||||||
|
use byteorder::{ByteOrder, LittleEndian};
|
||||||
|
use std::io::{Read, Write};
|
||||||
|
|
||||||
|
impl ADBServerDevice {
|
||||||
|
/// Receives [path] to [stream] from the device.
|
||||||
|
pub fn recv<A: AsRef<str>>(&mut self, path: A, stream: &mut dyn Write) -> Result<()> {
|
||||||
|
let serial = self.identifier.clone();
|
||||||
|
self.connect()?
|
||||||
|
.send_adb_request(AdbServerCommand::TransportSerial(serial))?;
|
||||||
|
|
||||||
|
// Set device in SYNC mode
|
||||||
|
self.get_transport_mut()
|
||||||
|
.send_adb_request(AdbServerCommand::Sync)?;
|
||||||
|
|
||||||
|
// Send a recv command
|
||||||
|
self.get_transport_mut()
|
||||||
|
.send_sync_request(SyncCommand::Recv)?;
|
||||||
|
|
||||||
|
self.handle_recv_command(path, stream)
|
||||||
|
}
|
||||||
|
|
||||||
|
fn handle_recv_command<S: AsRef<str>>(
|
||||||
|
&mut self,
|
||||||
|
from: S,
|
||||||
|
output: &mut dyn Write,
|
||||||
|
) -> Result<()> {
|
||||||
|
// First send 8 byte common header
|
||||||
|
let mut len_buf = [0_u8; 4];
|
||||||
|
LittleEndian::write_u32(&mut len_buf, from.as_ref().len() as u32);
|
||||||
|
self.get_transport_mut()
|
||||||
|
.get_raw_connection()?
|
||||||
|
.write_all(&len_buf)?;
|
||||||
|
self.get_transport_mut()
|
||||||
|
.get_raw_connection()?
|
||||||
|
.write_all(from.as_ref().as_bytes())?;
|
||||||
|
|
||||||
|
// Then we receive the byte data in chunks of up to 64k
|
||||||
|
// Chunk looks like 'DATA' <length> <data>
|
||||||
|
let mut buffer = [0_u8; 64 * 1024]; // Should this be Boxed?
|
||||||
|
let mut data_header = [0_u8; 4]; // DATA
|
||||||
|
loop {
|
||||||
|
self.get_transport_mut()
|
||||||
|
.get_raw_connection()?
|
||||||
|
.read_exact(&mut data_header)?;
|
||||||
|
// Check if data_header is DATA or DONE or FAIL
|
||||||
|
match &data_header {
|
||||||
|
b"DATA" => {
|
||||||
|
// Handle received data
|
||||||
|
let length: usize = self
|
||||||
|
.get_transport_mut()
|
||||||
|
.get_body_length()?
|
||||||
|
.try_into()
|
||||||
|
.unwrap();
|
||||||
|
self.get_transport_mut()
|
||||||
|
.get_raw_connection()?
|
||||||
|
.read_exact(&mut buffer[..length])?;
|
||||||
|
output.write_all(&buffer[..length])?;
|
||||||
|
}
|
||||||
|
b"DONE" => break, // We're done here
|
||||||
|
b"FAIL" => {
|
||||||
|
// Handle fail
|
||||||
|
let length: usize = self
|
||||||
|
.get_transport_mut()
|
||||||
|
.get_body_length()?
|
||||||
|
.try_into()
|
||||||
|
.unwrap();
|
||||||
|
self.get_transport_mut()
|
||||||
|
.get_raw_connection()?
|
||||||
|
.read_exact(&mut buffer[..length])?;
|
||||||
|
Err(RustADBError::ADBRequestFailed(String::from_utf8(
|
||||||
|
buffer[..length].to_vec(),
|
||||||
|
)?))?;
|
||||||
|
}
|
||||||
|
_ => panic!("Unknown response from device {:#?}", data_header),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Connection should've left SYNC by now
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
}
|
||||||
110
adb_client/src/server/device_commands/send.rs
Normal file
110
adb_client/src/server/device_commands/send.rs
Normal file
@@ -0,0 +1,110 @@
|
|||||||
|
use crate::{
|
||||||
|
models::{AdbRequestStatus, AdbServerCommand, SyncCommand},
|
||||||
|
ADBServerDevice, Result, RustADBError,
|
||||||
|
};
|
||||||
|
use byteorder::{ByteOrder, LittleEndian};
|
||||||
|
use std::{
|
||||||
|
convert::TryInto,
|
||||||
|
io::{Read, Write},
|
||||||
|
str::{self, FromStr},
|
||||||
|
time::SystemTime,
|
||||||
|
};
|
||||||
|
|
||||||
|
impl ADBServerDevice {
|
||||||
|
/// Send [stream] to [path] on the device.
|
||||||
|
pub fn send<A: AsRef<str>>(&mut self, stream: &mut dyn Read, path: A) -> Result<()> {
|
||||||
|
let serial = self.identifier.clone();
|
||||||
|
self.connect()?
|
||||||
|
.send_adb_request(AdbServerCommand::TransportSerial(serial))?;
|
||||||
|
|
||||||
|
// Set device in SYNC mode
|
||||||
|
self.get_transport_mut()
|
||||||
|
.send_adb_request(AdbServerCommand::Sync)?;
|
||||||
|
|
||||||
|
// Send a send command
|
||||||
|
self.get_transport_mut()
|
||||||
|
.send_sync_request(SyncCommand::Send)?;
|
||||||
|
|
||||||
|
self.handle_send_command(stream, path)
|
||||||
|
}
|
||||||
|
|
||||||
|
fn handle_send_command<S: AsRef<str>>(&mut self, input: &mut dyn Read, to: S) -> Result<()> {
|
||||||
|
// Append the permission flags to the filename
|
||||||
|
let to = to.as_ref().to_string() + ",0777";
|
||||||
|
|
||||||
|
// The name of command is already sent by get_transport()?.send_sync_request
|
||||||
|
let mut len_buf = [0_u8; 4];
|
||||||
|
LittleEndian::write_u32(&mut len_buf, to.len() as u32);
|
||||||
|
self.get_transport_mut()
|
||||||
|
.get_raw_connection()?
|
||||||
|
.write_all(&len_buf)?;
|
||||||
|
|
||||||
|
// Send appends the filemode to the string sent
|
||||||
|
self.get_transport_mut()
|
||||||
|
.get_raw_connection()?
|
||||||
|
.write_all(to.as_bytes())?;
|
||||||
|
|
||||||
|
// Then we send the byte data in chunks of up to 64k
|
||||||
|
// Chunk looks like 'DATA' <length> <data>
|
||||||
|
let mut buffer = [0_u8; 64 * 1024];
|
||||||
|
loop {
|
||||||
|
let bytes_read = input.read(&mut buffer)?;
|
||||||
|
if bytes_read == 0 {
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
let mut chunk_len_buf = [0_u8; 4];
|
||||||
|
LittleEndian::write_u32(&mut chunk_len_buf, bytes_read as u32);
|
||||||
|
self.get_transport_mut()
|
||||||
|
.get_raw_connection()?
|
||||||
|
.write_all(b"DATA")?;
|
||||||
|
self.get_transport_mut()
|
||||||
|
.get_raw_connection()?
|
||||||
|
.write_all(&chunk_len_buf)?;
|
||||||
|
self.get_transport_mut()
|
||||||
|
.get_raw_connection()?
|
||||||
|
.write_all(&buffer[..bytes_read])?;
|
||||||
|
}
|
||||||
|
|
||||||
|
// When we are done sending, we send 'DONE' <last modified time>
|
||||||
|
// Re-use len_buf to send the last modified time
|
||||||
|
let last_modified = match SystemTime::now().duration_since(SystemTime::UNIX_EPOCH) {
|
||||||
|
Ok(n) => n,
|
||||||
|
Err(_) => panic!("SystemTime before UNIX EPOCH!"),
|
||||||
|
};
|
||||||
|
LittleEndian::write_u32(&mut len_buf, last_modified.as_secs() as u32);
|
||||||
|
self.get_transport_mut()
|
||||||
|
.get_raw_connection()?
|
||||||
|
.write_all(b"DONE")?;
|
||||||
|
self.get_transport_mut()
|
||||||
|
.get_raw_connection()?
|
||||||
|
.write_all(&len_buf)?;
|
||||||
|
|
||||||
|
// We expect 'OKAY' response from this
|
||||||
|
let mut request_status = [0; 4];
|
||||||
|
self.get_transport_mut()
|
||||||
|
.get_raw_connection()?
|
||||||
|
.read_exact(&mut request_status)?;
|
||||||
|
|
||||||
|
match AdbRequestStatus::from_str(str::from_utf8(request_status.as_ref())?)? {
|
||||||
|
AdbRequestStatus::Fail => {
|
||||||
|
// We can keep reading to get further details
|
||||||
|
let length = self.get_transport_mut().get_body_length()?;
|
||||||
|
|
||||||
|
let mut body = vec![
|
||||||
|
0;
|
||||||
|
length
|
||||||
|
.try_into()
|
||||||
|
.map_err(|_| RustADBError::ConversionError)?
|
||||||
|
];
|
||||||
|
if length > 0 {
|
||||||
|
self.get_transport_mut()
|
||||||
|
.get_raw_connection()?
|
||||||
|
.read_exact(&mut body)?;
|
||||||
|
}
|
||||||
|
|
||||||
|
Err(RustADBError::ADBRequestFailed(String::from_utf8(body)?))
|
||||||
|
}
|
||||||
|
AdbRequestStatus::Okay => Ok(()),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
155
adb_client/src/server/device_commands/shell.rs
Normal file
155
adb_client/src/server/device_commands/shell.rs
Normal file
@@ -0,0 +1,155 @@
|
|||||||
|
use std::{
|
||||||
|
io::{self, Read, Write},
|
||||||
|
sync::mpsc,
|
||||||
|
time::Duration,
|
||||||
|
};
|
||||||
|
|
||||||
|
use mio::{unix::SourceFd, Events, Interest, Poll, Token};
|
||||||
|
|
||||||
|
use crate::{
|
||||||
|
adb_termios::ADBTermios,
|
||||||
|
models::{AdbServerCommand, HostFeatures},
|
||||||
|
ADBServerDevice, Result, RustADBError,
|
||||||
|
};
|
||||||
|
|
||||||
|
const STDIN: Token = Token(0);
|
||||||
|
const BUFFER_SIZE: usize = 512;
|
||||||
|
const POLL_DURATION: Duration = Duration::from_millis(100);
|
||||||
|
|
||||||
|
fn setup_poll_stdin() -> std::result::Result<Poll, io::Error> {
|
||||||
|
let poll = Poll::new()?;
|
||||||
|
let stdin_fd = 0;
|
||||||
|
poll.registry()
|
||||||
|
.register(&mut SourceFd(&stdin_fd), STDIN, Interest::READABLE)?;
|
||||||
|
|
||||||
|
Ok(poll)
|
||||||
|
}
|
||||||
|
|
||||||
|
impl ADBServerDevice {
|
||||||
|
/// Runs 'command' in a shell on the device, and write its output and error streams into [`output`].
|
||||||
|
pub fn shell_command<S: ToString, W: Write>(
|
||||||
|
&mut self,
|
||||||
|
command: impl IntoIterator<Item = S>,
|
||||||
|
mut output: W,
|
||||||
|
) -> Result<()> {
|
||||||
|
let supported_features = self.host_features()?;
|
||||||
|
if !supported_features.contains(&HostFeatures::ShellV2)
|
||||||
|
&& !supported_features.contains(&HostFeatures::Cmd)
|
||||||
|
{
|
||||||
|
return Err(RustADBError::ADBShellNotSupported);
|
||||||
|
}
|
||||||
|
|
||||||
|
let serial = self.identifier.clone();
|
||||||
|
self.connect()?
|
||||||
|
.send_adb_request(AdbServerCommand::TransportSerial(serial))?;
|
||||||
|
self.get_transport_mut()
|
||||||
|
.send_adb_request(AdbServerCommand::ShellCommand(
|
||||||
|
command
|
||||||
|
.into_iter()
|
||||||
|
.map(|v| v.to_string())
|
||||||
|
.collect::<Vec<_>>()
|
||||||
|
.join(" "),
|
||||||
|
))?;
|
||||||
|
|
||||||
|
const BUFFER_SIZE: usize = 4096;
|
||||||
|
loop {
|
||||||
|
let mut buffer = [0; BUFFER_SIZE];
|
||||||
|
match self
|
||||||
|
.get_transport_mut()
|
||||||
|
.get_raw_connection()?
|
||||||
|
.read(&mut buffer)
|
||||||
|
{
|
||||||
|
Ok(size) => {
|
||||||
|
if size == 0 {
|
||||||
|
return Ok(());
|
||||||
|
} else {
|
||||||
|
output.write_all(&buffer[..size])?;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
Err(e) => {
|
||||||
|
return Err(RustADBError::IOError(e));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Starts an interactive shell session on the device. Redirects stdin/stdout/stderr as appropriate.
|
||||||
|
pub fn shell(&mut self) -> Result<()> {
|
||||||
|
let mut adb_termios = ADBTermios::new(std::io::stdin())?;
|
||||||
|
adb_termios.set_adb_termios()?;
|
||||||
|
|
||||||
|
self.connect()?.get_raw_connection()?.set_nodelay(true)?;
|
||||||
|
|
||||||
|
// TODO: FORWARD CTRL+C !!
|
||||||
|
|
||||||
|
let supported_features = self.host_features()?;
|
||||||
|
if !supported_features.contains(&HostFeatures::ShellV2)
|
||||||
|
&& !supported_features.contains(&HostFeatures::Cmd)
|
||||||
|
{
|
||||||
|
return Err(RustADBError::ADBShellNotSupported);
|
||||||
|
}
|
||||||
|
|
||||||
|
let serial = self.identifier.clone();
|
||||||
|
self.connect()?
|
||||||
|
.send_adb_request(AdbServerCommand::TransportSerial(serial))?;
|
||||||
|
self.get_transport_mut()
|
||||||
|
.send_adb_request(AdbServerCommand::Shell)?;
|
||||||
|
|
||||||
|
// let read_stream = Arc::new(self.tcp_stream);
|
||||||
|
let mut read_stream = self.get_transport_mut().get_raw_connection()?.try_clone()?;
|
||||||
|
|
||||||
|
let (tx, rx) = mpsc::channel::<bool>();
|
||||||
|
|
||||||
|
let mut write_stream = read_stream.try_clone()?;
|
||||||
|
|
||||||
|
// Reading thread
|
||||||
|
std::thread::spawn(move || -> Result<()> {
|
||||||
|
loop {
|
||||||
|
let mut buffer = [0; BUFFER_SIZE];
|
||||||
|
match read_stream.read(&mut buffer) {
|
||||||
|
Ok(0) => {
|
||||||
|
let _ = tx.send(true);
|
||||||
|
read_stream.shutdown(std::net::Shutdown::Both)?;
|
||||||
|
return Ok(());
|
||||||
|
}
|
||||||
|
Ok(size) => {
|
||||||
|
std::io::stdout().write_all(&buffer[..size])?;
|
||||||
|
std::io::stdout().flush()?;
|
||||||
|
}
|
||||||
|
Err(e) => {
|
||||||
|
return Err(RustADBError::IOError(e));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
let mut buf = [0; BUFFER_SIZE];
|
||||||
|
let mut events = Events::with_capacity(1);
|
||||||
|
|
||||||
|
let mut poll = setup_poll_stdin()?;
|
||||||
|
|
||||||
|
// Polling either by checking that reading socket hasn't been closed, and if is there is something to read on stdin.
|
||||||
|
loop {
|
||||||
|
poll.poll(&mut events, Some(POLL_DURATION))?;
|
||||||
|
match rx.try_recv() {
|
||||||
|
Ok(_) | Err(mpsc::TryRecvError::Disconnected) => return Ok(()),
|
||||||
|
Err(mpsc::TryRecvError::Empty) => (),
|
||||||
|
}
|
||||||
|
|
||||||
|
for event in events.iter() {
|
||||||
|
match event.token() {
|
||||||
|
STDIN => {
|
||||||
|
let size = match std::io::stdin().read(&mut buf) {
|
||||||
|
Ok(0) => return Ok(()),
|
||||||
|
Ok(size) => size,
|
||||||
|
Err(_) => return Ok(()),
|
||||||
|
};
|
||||||
|
|
||||||
|
write_stream.write_all(&buf[0..size])?;
|
||||||
|
}
|
||||||
|
_ => unreachable!(),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
99
adb_client/src/server/device_commands/stat.rs
Normal file
99
adb_client/src/server/device_commands/stat.rs
Normal file
@@ -0,0 +1,99 @@
|
|||||||
|
use std::{
|
||||||
|
fmt::Display,
|
||||||
|
io::{Read, Write},
|
||||||
|
time::{Duration, UNIX_EPOCH},
|
||||||
|
};
|
||||||
|
|
||||||
|
use byteorder::{ByteOrder, LittleEndian};
|
||||||
|
use chrono::{DateTime, Utc};
|
||||||
|
|
||||||
|
use crate::{
|
||||||
|
models::{AdbServerCommand, SyncCommand},
|
||||||
|
ADBServerDevice, Result, RustADBError,
|
||||||
|
};
|
||||||
|
|
||||||
|
#[derive(Debug)]
|
||||||
|
pub struct AdbStatResponse {
|
||||||
|
pub file_perm: u32,
|
||||||
|
pub file_size: u32,
|
||||||
|
pub mod_time: u32,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl From<[u8; 12]> for AdbStatResponse {
|
||||||
|
fn from(value: [u8; 12]) -> Self {
|
||||||
|
Self {
|
||||||
|
file_perm: LittleEndian::read_u32(&value[0..4]),
|
||||||
|
file_size: LittleEndian::read_u32(&value[4..8]),
|
||||||
|
mod_time: LittleEndian::read_u32(&value[8..]),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Display for AdbStatResponse {
|
||||||
|
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
|
||||||
|
let d = UNIX_EPOCH + Duration::from_secs(self.mod_time.into());
|
||||||
|
// Create DateTime from SystemTime
|
||||||
|
let datetime = DateTime::<Utc>::from(d);
|
||||||
|
|
||||||
|
writeln!(f, "File permissions: {}", self.file_perm)?;
|
||||||
|
writeln!(f, "File size: {} bytes", self.file_size)?;
|
||||||
|
write!(
|
||||||
|
f,
|
||||||
|
"Modification time: {}",
|
||||||
|
datetime.format("%Y-%m-%d %H:%M:%S.%f %Z")
|
||||||
|
)?;
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl ADBServerDevice {
|
||||||
|
fn handle_stat_command<S: AsRef<str>>(&mut self, path: S) -> Result<AdbStatResponse> {
|
||||||
|
let mut len_buf = [0_u8; 4];
|
||||||
|
LittleEndian::write_u32(&mut len_buf, path.as_ref().len() as u32);
|
||||||
|
|
||||||
|
// 4 bytes of command name is already sent by send_sync_request
|
||||||
|
self.get_transport_mut()
|
||||||
|
.get_raw_connection()?
|
||||||
|
.write_all(&len_buf)?;
|
||||||
|
self.get_transport_mut()
|
||||||
|
.get_raw_connection()?
|
||||||
|
.write_all(path.as_ref().to_string().as_bytes())?;
|
||||||
|
|
||||||
|
// Reads returned status code from ADB server
|
||||||
|
let mut response = [0_u8; 4];
|
||||||
|
self.get_transport_mut()
|
||||||
|
.get_raw_connection()?
|
||||||
|
.read_exact(&mut response)?;
|
||||||
|
match std::str::from_utf8(response.as_ref())? {
|
||||||
|
"STAT" => {
|
||||||
|
let mut data = [0_u8; 12];
|
||||||
|
self.get_transport_mut()
|
||||||
|
.get_raw_connection()?
|
||||||
|
.read_exact(&mut data)?;
|
||||||
|
|
||||||
|
Ok(data.into())
|
||||||
|
}
|
||||||
|
x => Err(RustADBError::UnknownResponseType(format!(
|
||||||
|
"Unknown response {}",
|
||||||
|
x
|
||||||
|
))),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// 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()?
|
||||||
|
.send_adb_request(AdbServerCommand::TransportSerial(serial))?;
|
||||||
|
|
||||||
|
// Set device in SYNC mode
|
||||||
|
self.get_transport_mut()
|
||||||
|
.send_adb_request(AdbServerCommand::Sync)?;
|
||||||
|
|
||||||
|
// Send a "Stat" command
|
||||||
|
self.get_transport_mut()
|
||||||
|
.send_sync_request(SyncCommand::Stat)?;
|
||||||
|
|
||||||
|
self.handle_stat_command(path)
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,6 +1,9 @@
|
|||||||
|
mod adb_emulator_device;
|
||||||
mod adb_server;
|
mod adb_server;
|
||||||
mod commands;
|
mod adb_server_device;
|
||||||
mod models;
|
mod device_commands;
|
||||||
|
mod server_commands;
|
||||||
|
|
||||||
|
pub use adb_emulator_device::ADBEmulatorDevice;
|
||||||
pub use adb_server::ADBServer;
|
pub use adb_server::ADBServer;
|
||||||
pub use models::*;
|
pub use adb_server_device::ADBServerDevice;
|
||||||
|
|||||||
@@ -1,64 +0,0 @@
|
|||||||
use regex::bytes::Regex;
|
|
||||||
use std::net::SocketAddrV4;
|
|
||||||
use std::sync::LazyLock;
|
|
||||||
use std::{fmt::Display, str::FromStr};
|
|
||||||
|
|
||||||
use crate::RustADBError;
|
|
||||||
|
|
||||||
static MDNS_SERVICES_REGEX: LazyLock<Regex> = LazyLock::new(|| {
|
|
||||||
Regex::new("^(\\S+)\t(\\S+)\t([\\d\\.]+:\\d+)\n?$").expect("Cannot build mdns services regex")
|
|
||||||
});
|
|
||||||
|
|
||||||
/// Represents MDNS Services
|
|
||||||
#[derive(Debug, Clone)]
|
|
||||||
pub struct MDNSServices {
|
|
||||||
/// Service name
|
|
||||||
pub service_name: String,
|
|
||||||
/// Reg type
|
|
||||||
pub reg_type: String,
|
|
||||||
/// IP addr with port
|
|
||||||
pub socket_v4: SocketAddrV4,
|
|
||||||
}
|
|
||||||
|
|
||||||
impl Display for MDNSServices {
|
|
||||||
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
|
|
||||||
write!(
|
|
||||||
f,
|
|
||||||
"{}\t{}\t{}",
|
|
||||||
self.service_name, self.reg_type, self.socket_v4
|
|
||||||
)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl TryFrom<&[u8]> for MDNSServices {
|
|
||||||
type Error = RustADBError;
|
|
||||||
|
|
||||||
fn try_from(value: &[u8]) -> Result<Self, Self::Error> {
|
|
||||||
let groups = MDNS_SERVICES_REGEX
|
|
||||||
.captures(value)
|
|
||||||
.ok_or(RustADBError::RegexParsingError)?;
|
|
||||||
Ok(MDNSServices {
|
|
||||||
service_name: String::from_utf8(
|
|
||||||
groups
|
|
||||||
.get(1)
|
|
||||||
.ok_or(RustADBError::RegexParsingError)?
|
|
||||||
.as_bytes()
|
|
||||||
.to_vec(),
|
|
||||||
)?,
|
|
||||||
reg_type: String::from_utf8(
|
|
||||||
groups
|
|
||||||
.get(2)
|
|
||||||
.ok_or(RustADBError::RegexParsingError)?
|
|
||||||
.as_bytes()
|
|
||||||
.to_vec(),
|
|
||||||
)?,
|
|
||||||
socket_v4: SocketAddrV4::from_str(&String::from_utf8(
|
|
||||||
groups
|
|
||||||
.get(3)
|
|
||||||
.ok_or(RustADBError::RegexParsingError)?
|
|
||||||
.as_bytes()
|
|
||||||
.to_vec(),
|
|
||||||
)?)?,
|
|
||||||
})
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,13 +0,0 @@
|
|||||||
mod adb_version;
|
|
||||||
mod device_long;
|
|
||||||
mod device_short;
|
|
||||||
mod device_state;
|
|
||||||
mod mdns_services;
|
|
||||||
mod server_status;
|
|
||||||
|
|
||||||
pub use adb_version::AdbVersion;
|
|
||||||
pub use device_long::DeviceLong;
|
|
||||||
pub use device_short::DeviceShort;
|
|
||||||
pub use device_state::DeviceState;
|
|
||||||
pub use mdns_services::MDNSServices;
|
|
||||||
pub use server_status::{MDNSBackend, ServerStatus};
|
|
||||||
@@ -1,167 +0,0 @@
|
|||||||
use quick_protobuf::{BytesReader, MessageRead};
|
|
||||||
|
|
||||||
use std::fmt::Display;
|
|
||||||
|
|
||||||
use crate::RustADBError;
|
|
||||||
|
|
||||||
#[derive(Debug, PartialEq, Default, Eq, Clone, Copy)]
|
|
||||||
pub enum UsbBackend {
|
|
||||||
#[default]
|
|
||||||
Unknown = 0,
|
|
||||||
Native = 1,
|
|
||||||
LibUSB = 2,
|
|
||||||
}
|
|
||||||
|
|
||||||
impl From<i32> for UsbBackend {
|
|
||||||
fn from(i: i32) -> Self {
|
|
||||||
match i {
|
|
||||||
0 => UsbBackend::Unknown,
|
|
||||||
1 => UsbBackend::Native,
|
|
||||||
2 => UsbBackend::LibUSB,
|
|
||||||
_ => Self::default(),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl<'a> From<&'a str> for UsbBackend {
|
|
||||||
fn from(s: &'a str) -> Self {
|
|
||||||
match s {
|
|
||||||
"UNKNOWN_USB" => UsbBackend::Unknown,
|
|
||||||
"NATIVE" => UsbBackend::Native,
|
|
||||||
"LIBUSB" => UsbBackend::LibUSB,
|
|
||||||
_ => Self::default(),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl Display for UsbBackend {
|
|
||||||
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
|
|
||||||
match self {
|
|
||||||
UsbBackend::Unknown => write!(f, "UNKNOWN_USB"),
|
|
||||||
UsbBackend::Native => write!(f, "NATIVE"),
|
|
||||||
UsbBackend::LibUSB => write!(f, "LIBUSB"),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// MDNS Backend Status
|
|
||||||
#[derive(Debug, Clone, PartialEq, Default)]
|
|
||||||
pub enum MDNSBackend {
|
|
||||||
#[default]
|
|
||||||
/// Unknown
|
|
||||||
Unknown = 0,
|
|
||||||
/// Bonjour
|
|
||||||
Bonjour = 1,
|
|
||||||
/// OpenScreen
|
|
||||||
OpenScreen = 2,
|
|
||||||
}
|
|
||||||
|
|
||||||
impl From<i32> for MDNSBackend {
|
|
||||||
fn from(i: i32) -> Self {
|
|
||||||
match i {
|
|
||||||
0 => MDNSBackend::Unknown,
|
|
||||||
1 => MDNSBackend::Bonjour,
|
|
||||||
2 => MDNSBackend::OpenScreen,
|
|
||||||
_ => Self::default(),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl<'a> From<&'a str> for MDNSBackend {
|
|
||||||
fn from(s: &'a str) -> Self {
|
|
||||||
match s {
|
|
||||||
"UNKNOWN_MDNS" => MDNSBackend::Unknown,
|
|
||||||
"BONJOUR" => MDNSBackend::Bonjour,
|
|
||||||
"OPENSCREEN" => MDNSBackend::OpenScreen,
|
|
||||||
_ => Self::default(),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl Display for MDNSBackend {
|
|
||||||
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
|
|
||||||
match self {
|
|
||||||
MDNSBackend::Unknown => write!(f, "UNKNOWN_MDNS"),
|
|
||||||
MDNSBackend::Bonjour => write!(f, "BONJOUR"),
|
|
||||||
MDNSBackend::OpenScreen => write!(f, "OPENSCREEN"),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Structure representing current server status
|
|
||||||
#[derive(Debug, Clone, Default, PartialEq)]
|
|
||||||
pub struct ServerStatus {
|
|
||||||
/// Currently active USB backend
|
|
||||||
pub usb_backend: UsbBackend,
|
|
||||||
/// Is USB backend forced ?
|
|
||||||
pub usb_backend_forced: bool,
|
|
||||||
/// Currently active MDNS backend
|
|
||||||
pub mdns_backend: MDNSBackend,
|
|
||||||
/// Is MDNS backend forced ?
|
|
||||||
pub mdns_backend_forced: bool,
|
|
||||||
/// Server version
|
|
||||||
pub version: String,
|
|
||||||
/// Server build information
|
|
||||||
pub build: String,
|
|
||||||
/// Server executable absolute path
|
|
||||||
pub executable_absolute_path: String,
|
|
||||||
/// Server logs absolute path
|
|
||||||
pub log_absolute_path: String,
|
|
||||||
/// OS server is running on
|
|
||||||
pub os: String,
|
|
||||||
}
|
|
||||||
|
|
||||||
impl<'a> MessageRead<'a> for ServerStatus {
|
|
||||||
fn from_reader(r: &mut BytesReader, bytes: &'a [u8]) -> quick_protobuf::Result<Self> {
|
|
||||||
let mut msg = Self::default();
|
|
||||||
while !r.is_eof() {
|
|
||||||
match r.next_tag(bytes) {
|
|
||||||
Ok(8) => msg.usb_backend = r.read_enum(bytes)?,
|
|
||||||
Ok(16) => msg.usb_backend_forced = r.read_bool(bytes)?,
|
|
||||||
Ok(24) => msg.mdns_backend = r.read_enum(bytes)?,
|
|
||||||
Ok(32) => msg.mdns_backend_forced = r.read_bool(bytes)?,
|
|
||||||
Ok(42) => msg.version = r.read_string(bytes)?.to_string(),
|
|
||||||
Ok(50) => msg.build = r.read_string(bytes)?.to_string(),
|
|
||||||
Ok(58) => msg.executable_absolute_path = r.read_string(bytes)?.to_string(),
|
|
||||||
Ok(66) => msg.log_absolute_path = r.read_string(bytes)?.to_string(),
|
|
||||||
Ok(74) => msg.os = r.read_string(bytes)?.to_string(),
|
|
||||||
Ok(t) => {
|
|
||||||
r.read_unknown(bytes, t)?;
|
|
||||||
}
|
|
||||||
Err(e) => return Err(e),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
Ok(msg)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl Display for ServerStatus {
|
|
||||||
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
|
|
||||||
writeln!(f, "usb_backend: {}", self.usb_backend)?;
|
|
||||||
if self.usb_backend_forced {
|
|
||||||
writeln!(f, "usb_backend_forced: {}", self.usb_backend_forced)?;
|
|
||||||
}
|
|
||||||
writeln!(f, "mdns_backend: {}", self.mdns_backend)?;
|
|
||||||
if self.mdns_backend_forced {
|
|
||||||
writeln!(f, "mdns_backend_forced: {}", self.mdns_backend_forced)?;
|
|
||||||
}
|
|
||||||
writeln!(f, "version: \"{}\"", self.version)?;
|
|
||||||
writeln!(f, "build: \"{}\"", self.build)?;
|
|
||||||
writeln!(
|
|
||||||
f,
|
|
||||||
"executable_absolute_path: \"{}\"",
|
|
||||||
self.executable_absolute_path
|
|
||||||
)?;
|
|
||||||
writeln!(f, "log_absolute_path: \"{}\"", self.log_absolute_path)?;
|
|
||||||
writeln!(f, "os: \"{}\"", self.os)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl TryFrom<Vec<u8>> for ServerStatus {
|
|
||||||
type Error = RustADBError;
|
|
||||||
|
|
||||||
fn try_from(value: Vec<u8>) -> Result<Self, Self::Error> {
|
|
||||||
let mut reader = BytesReader::from_bytes(&value);
|
|
||||||
ServerStatus::from_reader(&mut reader, &value).map_err(|_| RustADBError::ConversionError)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -8,10 +8,9 @@ impl ADBServer {
|
|||||||
.connect()?
|
.connect()?
|
||||||
.proxy_connection(AdbServerCommand::Connect(address), true)?;
|
.proxy_connection(AdbServerCommand::Connect(address), true)?;
|
||||||
|
|
||||||
match String::from_utf8(response) {
|
match String::from_utf8(response).unwrap() {
|
||||||
Ok(s) if s.starts_with("connected to") => Ok(()),
|
s if s.starts_with("connected to") => Ok(()),
|
||||||
Ok(s) => Err(RustADBError::ADBRequestFailed(s)),
|
s => Err(RustADBError::ADBRequestFailed(s)),
|
||||||
Err(e) => Err(e.into()),
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -1,8 +1,8 @@
|
|||||||
use std::io::Read;
|
use std::io::Read;
|
||||||
|
|
||||||
use crate::{
|
use crate::{
|
||||||
models::AdbServerCommand, ADBEmulatorDevice, ADBServer, ADBServerDevice, DeviceLong,
|
models::{AdbServerCommand, DeviceShort},
|
||||||
DeviceShort, Result, RustADBError,
|
ADBEmulatorDevice, ADBServer, ADBServerDevice, DeviceLong, Result, RustADBError,
|
||||||
};
|
};
|
||||||
|
|
||||||
impl ADBServer {
|
impl ADBServer {
|
||||||
@@ -79,6 +79,7 @@ impl ADBServer {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/// Tracks new devices showing up.
|
/// Tracks new devices showing up.
|
||||||
|
// TODO: Change with Generator when feature stabilizes
|
||||||
pub fn track_devices(&mut self, callback: impl Fn(DeviceShort) -> Result<()>) -> Result<()> {
|
pub fn track_devices(&mut self, callback: impl Fn(DeviceShort) -> Result<()>) -> Result<()> {
|
||||||
self.connect()?
|
self.connect()?
|
||||||
.send_adb_request(AdbServerCommand::TrackDevices)?;
|
.send_adb_request(AdbServerCommand::TrackDevices)?;
|
||||||
@@ -97,12 +98,7 @@ impl ADBServer {
|
|||||||
.get_raw_connection()?
|
.get_raw_connection()?
|
||||||
.read_exact(&mut body)?;
|
.read_exact(&mut body)?;
|
||||||
|
|
||||||
for device in body.split(|x| x.eq(&b'\n')) {
|
callback(DeviceShort::try_from(body)?)?;
|
||||||
if device.is_empty() {
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
callback(DeviceShort::try_from(device.to_vec())?)?;
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -8,10 +8,9 @@ impl ADBServer {
|
|||||||
.connect()?
|
.connect()?
|
||||||
.proxy_connection(AdbServerCommand::Disconnect(address), true)?;
|
.proxy_connection(AdbServerCommand::Disconnect(address), true)?;
|
||||||
|
|
||||||
match String::from_utf8(response) {
|
match String::from_utf8(response).unwrap() {
|
||||||
Ok(s) if s.starts_with("disconnected") => Ok(()),
|
s if s.starts_with("disconnected") => Ok(()),
|
||||||
Ok(s) => Err(RustADBError::ADBRequestFailed(s)),
|
s => Err(RustADBError::ADBRequestFailed(s)),
|
||||||
Err(e) => Err(e.into()),
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -2,8 +2,5 @@ mod connect;
|
|||||||
mod devices;
|
mod devices;
|
||||||
mod disconnect;
|
mod disconnect;
|
||||||
mod kill;
|
mod kill;
|
||||||
mod mdns;
|
|
||||||
mod pair;
|
mod pair;
|
||||||
mod reconnect;
|
|
||||||
mod server_status;
|
|
||||||
mod version;
|
mod version;
|
||||||
@@ -4,15 +4,14 @@ use std::net::SocketAddrV4;
|
|||||||
|
|
||||||
impl ADBServer {
|
impl ADBServer {
|
||||||
/// Pair device on a specific port with a generated 'code'
|
/// Pair device on a specific port with a generated 'code'
|
||||||
pub fn pair(&mut self, address: SocketAddrV4, code: String) -> Result<()> {
|
pub fn pair(&mut self, address: SocketAddrV4, code: u32) -> Result<()> {
|
||||||
let response = self
|
let response = self
|
||||||
.connect()?
|
.connect()?
|
||||||
.proxy_connection(AdbServerCommand::Pair(address, code), true)?;
|
.proxy_connection(AdbServerCommand::Pair(address, code), true)?;
|
||||||
|
|
||||||
match String::from_utf8(response) {
|
match String::from_utf8(response).unwrap() {
|
||||||
Ok(s) if s.starts_with("Successfully paired to") => Ok(()),
|
s if s.starts_with("Successfully paired to") => Ok(()),
|
||||||
Ok(s) => Err(RustADBError::ADBRequestFailed(s)),
|
s => Err(RustADBError::ADBRequestFailed(s)),
|
||||||
Err(e) => Err(e.into()),
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -1,121 +0,0 @@
|
|||||||
use std::{
|
|
||||||
io::{ErrorKind, Read, Write},
|
|
||||||
path::Path,
|
|
||||||
};
|
|
||||||
|
|
||||||
use crate::{
|
|
||||||
constants::BUFFER_SIZE,
|
|
||||||
models::{AdbServerCommand, AdbStatResponse, HostFeatures},
|
|
||||||
ADBDeviceExt, Result, RustADBError,
|
|
||||||
};
|
|
||||||
|
|
||||||
use super::ADBServerDevice;
|
|
||||||
|
|
||||||
impl ADBDeviceExt for ADBServerDevice {
|
|
||||||
fn shell_command(&mut self, command: &[&str], output: &mut dyn Write) -> Result<()> {
|
|
||||||
let supported_features = self.host_features()?;
|
|
||||||
if !supported_features.contains(&HostFeatures::ShellV2)
|
|
||||||
&& !supported_features.contains(&HostFeatures::Cmd)
|
|
||||||
{
|
|
||||||
return Err(RustADBError::ADBShellNotSupported);
|
|
||||||
}
|
|
||||||
|
|
||||||
let serial = self.identifier.clone();
|
|
||||||
self.connect()?
|
|
||||||
.send_adb_request(AdbServerCommand::TransportSerial(serial))?;
|
|
||||||
self.transport
|
|
||||||
.send_adb_request(AdbServerCommand::ShellCommand(command.join(" ")))?;
|
|
||||||
|
|
||||||
loop {
|
|
||||||
let mut buffer = [0; BUFFER_SIZE];
|
|
||||||
match self.transport.get_raw_connection()?.read(&mut buffer) {
|
|
||||||
Ok(size) => {
|
|
||||||
if size == 0 {
|
|
||||||
return Ok(());
|
|
||||||
} else {
|
|
||||||
output.write_all(&buffer[..size])?;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
Err(e) => {
|
|
||||||
return Err(RustADBError::IOError(e));
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
fn stat(&mut self, remote_path: &str) -> Result<AdbStatResponse> {
|
|
||||||
self.stat(remote_path)
|
|
||||||
}
|
|
||||||
|
|
||||||
fn shell(
|
|
||||||
&mut self,
|
|
||||||
mut reader: &mut dyn Read,
|
|
||||||
mut writer: Box<(dyn Write + Send)>,
|
|
||||||
) -> Result<()> {
|
|
||||||
let supported_features = self.host_features()?;
|
|
||||||
if !supported_features.contains(&HostFeatures::ShellV2)
|
|
||||||
&& !supported_features.contains(&HostFeatures::Cmd)
|
|
||||||
{
|
|
||||||
return Err(RustADBError::ADBShellNotSupported);
|
|
||||||
}
|
|
||||||
|
|
||||||
let serial = self.identifier.clone();
|
|
||||||
self.connect()?
|
|
||||||
.send_adb_request(AdbServerCommand::TransportSerial(serial))?;
|
|
||||||
self.transport.send_adb_request(AdbServerCommand::Shell)?;
|
|
||||||
|
|
||||||
let mut read_stream = self.transport.get_raw_connection()?.try_clone()?;
|
|
||||||
|
|
||||||
let mut write_stream = read_stream.try_clone()?;
|
|
||||||
|
|
||||||
// Reading thread, reads response from adb-server
|
|
||||||
std::thread::spawn(move || -> Result<()> {
|
|
||||||
loop {
|
|
||||||
let mut buffer = [0; BUFFER_SIZE];
|
|
||||||
match read_stream.read(&mut buffer) {
|
|
||||||
Ok(0) => {
|
|
||||||
read_stream.shutdown(std::net::Shutdown::Both)?;
|
|
||||||
return Ok(());
|
|
||||||
}
|
|
||||||
Ok(size) => {
|
|
||||||
writer.write_all(&buffer[..size])?;
|
|
||||||
writer.flush()?;
|
|
||||||
}
|
|
||||||
Err(e) => {
|
|
||||||
return Err(RustADBError::IOError(e));
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
// Read from given reader (that could be stdin e.g), and write content to server socket
|
|
||||||
if let Err(e) = std::io::copy(&mut reader, &mut write_stream) {
|
|
||||||
match e.kind() {
|
|
||||||
ErrorKind::BrokenPipe => return Ok(()),
|
|
||||||
_ => return Err(RustADBError::IOError(e)),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
|
|
||||||
fn pull(&mut self, source: &dyn AsRef<str>, mut output: &mut dyn Write) -> Result<()> {
|
|
||||||
self.pull(source, &mut output)
|
|
||||||
}
|
|
||||||
|
|
||||||
fn reboot(&mut self, reboot_type: crate::RebootType) -> Result<()> {
|
|
||||||
self.reboot(reboot_type)
|
|
||||||
}
|
|
||||||
|
|
||||||
fn push(&mut self, stream: &mut dyn Read, path: &dyn AsRef<str>) -> Result<()> {
|
|
||||||
self.push(stream, path)
|
|
||||||
}
|
|
||||||
|
|
||||||
fn install(&mut self, apk_path: &dyn AsRef<Path>) -> Result<()> {
|
|
||||||
self.install(apk_path)
|
|
||||||
}
|
|
||||||
|
|
||||||
fn framebuffer_inner(&mut self) -> Result<image::ImageBuffer<image::Rgba<u8>, Vec<u8>>> {
|
|
||||||
self.framebuffer_inner()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user