adb-rust

Crates.ioadb-rust
lib.rsadb-rust
version
sourcesrc
created_at2024-04-02 09:04:46.24494
updated_at2025-01-06 08:33:25.662481
descriptionA common adb operation
homepage
repository
max_upload_size
id1193353
Cargo.toml error:TOML parse error at line 18, column 1 | 18 | autolib = false | ^^^^^^^ unknown field `autolib`, expected one of `name`, `version`, `edition`, `authors`, `description`, `readme`, `license`, `repository`, `homepage`, `documentation`, `build`, `resolver`, `links`, `default-run`, `default_dash_run`, `rust-version`, `rust_dash_version`, `rust_version`, `license-file`, `license_dash_file`, `license_file`, `licenseFile`, `license_capital_file`, `forced-target`, `forced_dash_target`, `autobins`, `autotests`, `autoexamples`, `autobenches`, `publish`, `metadata`, `keywords`, `categories`, `exclude`, `include`
size0
穿拖鞋的小涵 (zengyuhan503)

documentation

README

A Simple ADB Client Written in Rust

===========================

ADBCmd can execute commands synchronously or asynchronously using callback function closures.

Currently, this library is primarily used for invoking "cmd" commands in Rust, providing a variety of practical APIs.

  • new: Creates an instance of ADBCmd, returning an ADBCmd instance.
  • create_adb_cmd: Creates an asynchronous Command instance based on tokio::process::Command, returning the instance of Command.
  • run_async: Executes an asynchronous command by passing callback parameters to get the Command output in real-time.
  • run: Executes a synchronous command (based on std::process::Command) to obtain the output of the current synchronous command, returning a Result<String, String>.
  • get_file_path: Gets the file path of the given path; if it does not exist, it returns an error message, returning a Result<String, String>.

Usage

[dependencies]
tokio = { version = "1.0", features = ["full"] }
adb-rust="0.2.1"
  • Invocation
use adb_rust::cmd::{ADBCmd, ADBCmdResult};

pub fn push_xml_file() {
    let file: &str = "./resources/file.xml";
    let paths: String = ADBCmd::get_file_path(file).unwrap();
    let args: Vec<String> = vec!["push".to_string(), paths, "/sdcard/".to_string()];
    let res: Result<String, String> = ADBCmd::new("adb", true).run(&args);
    ...
    ...        
}

API

pub mod tests {
    use crate::cmd::{ADBCmd, ADBCmdTrait};
    use super::*;
    use tokio;

    #[test]
    fn test_adb_cmd() {
        let path = ADBCmd::get_file_path("./resources/file.xml").unwrap();
        let cleaned_path = path.replace("\\\\?\\", "");
        let args = vec!["push".to_string(), cleaned_path, "/data/local/tmp/".to_string()];
        let binding = ADBCmd::new("adb", false);
        let result = binding.run(&args);
        match result {
            Ok(stdout) => println!("{}", stdout),
            Err(stderr) => println!("{}", stderr),
        }
    }

    #[tokio::test]
    async fn test_run_async() {
        let adb_cmd = ADBCmd::new("adb", false);
        let args = vec!["devices".to_string()];
        adb_cmd.run_async(args, |line| {
            println!("{}", line);
            line
        }).await;
    }
}
Commit count: 0

cargo fmt