2024-10-10 16:41:16 +02:00
|
|
|
<p align="center" style="text-align: center">
|
|
|
|
|
<img src="assets/logo.png" width="33%">
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p align="center">
|
|
|
|
|
<p align="center">Android Debug Bridge (ADB) client implementation in pure Rust !</p>
|
|
|
|
|
<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://deps.rs/repo/github/cocool97/adb_client">
|
|
|
|
|
<img alt="dependency status" src="https://deps.rs/repo/github/cocool97/adb_client/status.svg"/>
|
|
|
|
|
</a>
|
|
|
|
|
</p>
|
|
|
|
|
</p>
|
2022-01-05 20:41:23 +01:00
|
|
|
|
2024-10-25 18:09:41 +02:00
|
|
|
Main features of this library:
|
2022-01-07 21:48:50 +01:00
|
|
|
|
2024-10-25 18:09:41 +02:00
|
|
|
- Full Rust, don't use `adb *` shell commands to interact with devices
|
|
|
|
|
- Supports:
|
|
|
|
|
- **TCP/IP** protocol, using ADB server as a proxy (standard behavior when using `adb` CLI)
|
|
|
|
|
- **USB** protocol, interacting directly with end devices
|
|
|
|
|
- Implements hidden `adb` features, like `framebuffer`
|
2022-05-19 21:58:19 +02:00
|
|
|
- Highly configurable
|
|
|
|
|
- Easy to use !
|
|
|
|
|
|
2024-09-05 16:53:23 +02:00
|
|
|
## adb_client
|
2022-05-19 21:58:19 +02:00
|
|
|
|
2024-10-25 18:09:41 +02:00
|
|
|
Rust library implementing both ADB protocols and providing a high-level abstraction over many supported commands.
|
2022-01-05 20:41:23 +01:00
|
|
|
|
2024-09-05 16:53:23 +02:00
|
|
|
Improved documentation [here](./adb_client/README.md).
|
2022-01-05 20:41:23 +01:00
|
|
|
|
2024-09-05 16:53:23 +02:00
|
|
|
## adb_cli
|
2022-05-19 21:58:19 +02:00
|
|
|
|
2024-10-25 18:09:41 +02:00
|
|
|
Rust binary providing an improved version of official `adb` CLI, wrapping `adb_client` library. Can act as an usage example of the library.
|
2022-04-08 21:54:11 +02:00
|
|
|
|
2024-09-05 16:53:23 +02:00
|
|
|
Improved documentation [here](./adb_cli/README.md).
|
2022-01-05 20:41:23 +01:00
|
|
|
|
2024-10-10 16:41:16 +02:00
|
|
|
## Related publications
|
|
|
|
|
|
|
|
|
|
- [Diving into ADB protocol internals (1/2)](https://www.synacktiv.com/publications/diving-into-adb-protocol-internals-12)
|
|
|
|
|
|
2024-10-25 18:09:41 +02:00
|
|
|
Some features may still be missing, all pull requests are welcome !
|