radb

A Rust implementation of openatx/adbutils —— a library for interacting with Android devices using ADB (Android Debug Bridge).

📌 项目简介

radb 是一个基于 Rust 实现的 ADB 工具库，灵感来源于 Python 的 adbutils，旨在为开发者提供简洁、高效且类型安全的方式来与 Android 设备进行交互。

该库支持同步和异步两种模式，并封装了常用的 ADB 操作命令，如设备管理、文件传输、shell 命令执行、日志抓取等。

🚀 快速开始

添加依赖

在你的 Cargo.toml 文件中添加以下内容以引入 radb：

[dependencies]
radb = "0.1.7"

示例代码

获取设备列表

use radb::AdbDevice;
use radb::AdbClient;

fn main() {
    let mut a = AdbClient::default();
    let device = a.iter_devices().unwrap().next();
    if let Some(mut device) = device{
        println!("{:#?}",&device.serial);
        let output = device.shell("echo \"Hello Android\" ");
        println!("{}",output.unwrap());
    }
}

使用日志功能（logcat）

#[cfg(test)]
mod tests {
    const TEST_DEVICE_SERIAL: &str = "3508719615000K5";
    const TEST_PACKAGE: &str = "com.android.chrome";
    const TEST_DIR: &str = "/data/local/tmp";
    const DEFAULT_ADB_ADDR: &str = "127.0.0.1:5037";

    #[cfg(feature = "blocking")]
    mod device_blocking_tests {
        use super::*;
        use radb::beans::command::AdbCommand;
        use std::path::PathBuf;

        fn create_test_device() -> AdbDevice<&'static str> {
            AdbDevice::new(TEST_DEVICE_SERIAL, DEFAULT_ADB_ADDR)
        }

        #[test]
        fn test_device_creation() {
            let device = create_test_device();
            assert_eq!(device.serial, Some(TEST_DEVICE_SERIAL.to_string()));
        }
    }

    #[test]
    fn test_logcat() {
        setup_test_environment();
        let mut device = create_test_device();

        // 测试 logcat
        let logcat_result = device.logcat(true, None);
        assert!(logcat_result.is_ok());

        let mut logcat_iter = logcat_result.unwrap();
        let mut count = 0;
        for line in logcat_iter {
            if line.is_ok() {
                count += 1;
                if count >= 5 {
                    // 只读取前5行
                    break;
                }
            }
        }
        println!("Read {} logcat lines", count);
    }

}

✅ 支持的功能

🔧 特性开关（Features）

radb 提供以下特性开关供选择使用：

• blocking：启用同步 API（默认）
• tokio_async：启用异步 API 支持（需要配合 tokio 运行时）

你可以根据需求选择启用不同的特性：

[dependencies.radb]
version = "0.1.7"
features = ["tokio_async"]

📦 文档

完整的 API 文档请查看 docs.rs/radb。

📦 Crates 链接

• Crates.io

🛠 贡献

欢迎提交 PR 或 issue！如果你有新功能建议或发现了 bug，请随时提出。

📄 许可证

该项目采用 MIT 协议开源。详情请参阅 LICENSE 文件。