# AndroidExec

**Repository Path**: VeiZhang/AndroidExec

## Basic Information

- **Project Name**: AndroidExec
- **Description**: Android命令执行
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2019-07-29
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AndroidExec

Android命令执行以及回调

[![Download][icon_download]][download]

```
implementation 'com.excellence:exec:_latestVersion'
```

## 使用

```
// 初始化，默认：不限制并发线程数；指令超时10s终止
Commander.init();

// 自定义初始化参数：限制同时进行10个任务，超时1s终止
Commander.init(new CommanderOptions.Builder().parallelTaskCount(10).timeOut(1000).build())

// 创建执行命令
推荐方式：
new CommandTask.Builder().command("ls").build().deploy(Listener);

丢弃方式：
Commander.addTask("ls", new IListener() {
    @Override
    public void onPre(String command) {
        Log.i(TAG, "onPre: " + command);
    }

    @Override
    public void onProgress(String message) {
        Log.i(TAG, "onProgress: " + message);
    }

    @Override
    public void onError(Throwable t) {
        t.printStackTrace();
    }

    @Override
    public void onSuccess(String message) {
        Log.i(TAG, "onSuccess: " + message);
    }
});

// 终止命令
CommandTask.discard()

// 终止所有命令
Commander.destroy()
```

## Runtime

```
// 执行命令
Process process = Runtime.getRuntime().exec("command");

// 读取正常输出
process.getInputStream()

// 读取错误输出
process.getErrorStream()
```

## ProcessBuilder

```
// 执行命令，重定向输出流
Process process = new ProcessBuilder("command").command("arg").redirectErrorStream(true).start();

// 不设置重定向，则正常输出、错误输出如同Runtime；
// 设置了重定向后，正常输出、错误输出都统一读取process.getInputStream()
```

**注意**

**ProcessBuilder.start() 和 Runtime.exec()传递的参数有所不同，Runtime.exec()可接受一个单独的字符串，这个字符串是通过空格来分隔可执行命令程序和参数的；也可以接受字符串数组参数。而ProcessBuilder的构造函数是一个字符串列表或者数组。列表中第一个参数是可执行命令程序，其他的是命令行执行是需要的参数。通过查看JDK源码可知，Runtime.exec最终是通过调用ProcessBuilder来真正执行操作的。**


## 版本更新

| 版本 | 描述 |
| --- | ---- |
| [1.1.1][Exec1.1.1] | 修改低版本机型中任务销毁时导致的阻塞 **2019-4-29** |
| [1.1.0][Exec1.1.0] | 使用Builder模式创建命令任务，修复崩溃异常 **2018-9-3** |
| [1.0.0][Exec1.0.0] | 集成命令行执行 **2018-8-17** |

<!-- 网站链接 -->

[download]:https://bintray.com/veizhang/maven/exec/_latestVersion "Latest version"

<!-- 图片链接 -->

[icon_download]:https://api.bintray.com/packages/veizhang/maven/exec/images/download.svg

<!-- 版本 -->

[Exec1.1.1]:https://bintray.com/veizhang/maven/exec/1.1.1
[Exec1.1.0]:https://bintray.com/veizhang/maven/exec/1.1.0
[Exec1.0.0]:https://bintray.com/veizhang/maven/exec/1.0.0