核心工具方法
/**
* 執行 Linux 命令並返回輸出結果 (stdout + stderr)
* @param commands 命令及參數陣列,如 new String[]{"chmod", "777", "/data/local/tmp/test.sh"}
* @return 合併輸出字串,失敗返回空串
*/
public static String exec(String[] commands) {
StringBuilder output = new StringBuilder();
ProcessBuilder pb = new ProcessBuilder(commands);
pb.redirectErrorStream(true); // 合併 stderr 到 stdout
try {
Process process = pb.start();
try (BufferedReader reader = new BufferedReader(
new InputStreamReader(process.getInputStream()))) {
String line;
while ((line = reader.readLine()) != null) {
output.append(line).append('\n');
}
}
int exitCode = process.waitFor();
Log.d("ShellExec", "Cmd: " + Arrays.toString(commands) + " exit=" + exitCode + " out=" + output);
return output.toString();
} catch (IOException | InterruptedException e) {
Log.e("ShellExec", "Execute failed", e);
return "";
}
}
使用範例
// 普通命令 (無需 root)
String[] cmd1 = {"ls", "-l", "/sdcard/"};
exec(cmd1);
// 需 Root 權限:使用 su -c "command"
String[] cmd2 = {"su", "-c", "chmod 777 /data/local/tmp/myfile"};
exec(cmd2);
// 多命令串聯 (shell 管線)
String[] cmd3 = {"sh", "-c", "ls /sdcard/ | grep '.jpg' | wc -l"};
exec(cmd3);
進階:即時獲取輸出 (非阻塞)
public static void execAsync(String[] cmd, Consumer onLine, Consumer onExit) {
new Thread(() -> {
try {
Process process = new ProcessBuilder(cmd).redirectErrorStream(true).start();
try (BufferedReader br = new BufferedReader(new InputStreamReader(process.getInputStream()))) {
String line;
while ((line = br.readLine()) != null) onLine.accept(line);
}
onExit.accept(process.waitFor());
} catch (Exception e) { onExit.accept(-1); }
}).start();
}
權限與安全警示
- Root 風險:
su 需裝置已 Root 且授權,普通 App 無法調用。濫用 Root 導致安全漏洞、系統不穩、OTA 失敗。
- SELinux:即使有 Root,SELinux 政策可能阻止訪問特定路徑/執行特定命令 (需
magiskpolicy 或刷寫 permissive 內核)。
- 命令注入:嚴禁拼接用戶輸入字串直接執行,務必使用陣列參數或嚴格白名單校驗。
- 替代方案:優先使用 Java API (
File, ProcessBuilder 無 su、Runtime.exec)、系統 API (PackageManager 安裝/卸載、StorageManager 掛載)。
適用場景
- 自動化測試腳本 (CTS/GTS/VTS)。
- 系統級工具 App (需 Root/系統簽名)。
- 調試用途:抓取 logcat、dumpsys、proc 節點資訊。