萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android App 執行 Linux Shell 命令 (含 su Root 權限) 通用工具類

核心工具方法

/**
 * 執行 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 節點資訊。
copyright © 萬盛學電腦網 all rights reserved