1. AutoJs中的Shell命令基础解析
在Android自动化领域，Shell命令是直接与系统底层交互的重要工具。AutoJs作为一款基于JavaScript的Android自动化工具，提供了两种执行Shell命令的方式：直接调用shell函数和创建Shell对象。这两种方式各有特点，适用于不同场景。
1.1 Shell命令的本质
AutoJs中的Shell命令本质上是Android Debug Bridge(ADB) Shell命令的封装。当你使用AutoJs执行Shell命令时，实际上是在执行去掉"adb shell"前缀的ADB命令。例如：
- ADB命令：
adb shell pm list packages - AutoJs等效命令：
pm list packages
这种设计使得熟悉ADB开发的工程师能够快速上手AutoJs的Shell功能。不过需要注意的是，AutoJs对Shell命令的支持并非100%完整，特别是涉及内存信息获取或操作的命令可能无法正常工作。
1.2 Root权限的必要性
Shell命令的执行通常需要Root权限，这是Android系统的安全机制决定的。没有Root权限，许多系统级操作将无法执行。AutoJs提供了检测和请求Root权限的机制：
javascript复制// 检查Root权限
function hasRootAccess() {
let result = shell("id", true).result;
return (result.indexOf("uid=0") >= 0); // uid=0表示Root用户
}
// 请求Root权限
function requestRoot() {
let sh = new Shell(true);
sh.exec("su");
sleep(5000); // 等待用户授权
return hasRootAccess();
}
提示：在实际项目中，建议将Root权限检测和请求封装成独立函数，方便多处调用。
2. 两种Shell命令执行方式详解
2.1 直接调用shell函数
这是AutoJs中最简单的Shell命令执行方式，语法如下：
javascript复制let result = shell(command, root);
参数说明：
command: 要执行的Shell命令字符串root: 布尔值，表示是否以Root权限执行（默认为false）
返回值是一个包含三个属性的对象：
code: 返回码，0表示成功result: 命令输出结果error: 错误信息（如果有）
示例代码：
javascript复制let result = shell("pm list packages", true);
if (result.code == 0) {
console.log("命令执行成功:");
console.log(result.result);
} else {
console.log("命令执行失败:");
console.log(result.error);
}
特点分析：
- 同步执行：命令执行完成后才会继续执行后续代码
- 每次调用都会创建新的Shell实例
- 适合需要获取执行结果的场景
- 执行速度相对较慢
2.2 使用Shell对象
Shell对象提供了更灵活的Shell命令执行方式，特别适合需要连续执行多个命令的场景。
基本用法：
javascript复制let sh = new Shell(true); // 创建Root权限的Shell对象
sh.exec("pm list packages"); // 执行命令
// ...其他操作
sh.exit(); // 关闭Shell
Shell对象的主要方法：
exec(command): 执行命令（异步）exit(): 立即退出ShellexitAndWaitFor(): 等待当前命令执行完成后退出setCallback(callback): 设置输出回调
回调函数示例：
javascript复制let sh = new Shell(true);
let output = "";
sh.setCallback({
onNewLine: function(line) {
console.log("新行:", line);
output += line + "\n";
},
onOutput: function(content) {
console.log("新内容:", content);
}
});
sh.exec("pm list packages");
sh.exitAndWaitFor();
console.log("最终输出:", output);
特点分析：
- 异步执行：命令发出后立即继续执行后续代码
- 可复用同一个Shell实例执行多个命令
- 执行速度较快
- 适合不需要立即获取结果的场景
3. 实战应用与性能对比
3.1 两种方式的性能测试
我们通过一个简单的测试来比较两种方式的性能差异：
javascript复制console.time("shell函数");
for (let i = 0; i < 10; i++) {
shell("echo test", true);
}
console.timeEnd("shell函数");
console.time("Shell对象");
let sh = new Shell(true);
for (let i = 0; i < 10; i++) {
sh.exec("echo test");
}
sh.exitAndWaitFor();
console.timeEnd("Shell对象");
典型测试结果：
- shell函数：约2000-3000ms
- Shell对象：约300-500ms
3.2 实际应用场景建议
根据实际项目经验，以下是两种方式的适用场景建议：
-
使用shell函数的情况：
- 需要获取命令执行结果
- 执行关键性操作，需要确保成功
- 执行需要高权限的命令
- 单次或偶尔执行的命令
-
使用Shell对象的情况：
- 需要连续执行多个命令
- 对执行速度要求较高
- 不需要立即获取结果
- 命令执行成功率较高
3.3 混合使用策略
在实际项目中，可以采用混合使用策略：
javascript复制// 创建Shell对象提高执行效率
let sh = new Shell(true);
try {
// 执行一系列命令
sh.exec("command1");
sh.exec("command2");
// 关键命令使用shell函数确保执行
let result = shell("critical_command", true);
if (result.code != 0) {
throw new Error("关键命令执行失败");
}
sh.exec("command3");
} finally {
sh.exit();
}
4. 常见问题与解决方案
4.1 命令执行无响应
问题现象：某些命令执行后既不报错也没有输出。
可能原因：
- 命令需要更高权限
- AutoJs不支持该命令
- 命令本身需要交互式输入
解决方案：
- 确保使用Root权限
- 尝试在ADB Shell中测试命令是否有效
- 对于交互式命令，考虑使用Shell对象的回调处理
4.2 回调函数混乱
问题现象：回调函数的输出杂乱无章，难以解析。
解决方案：
- 优先使用
onNewLine回调 - 添加输出过滤逻辑
- 使用缓冲区累积输出
改进后的回调示例：
javascript复制let buffer = "";
let completeOutput = "";
sh.setCallback({
onNewLine: function(line) {
if (line.trim() !== "") {
buffer += line + "\n";
}
},
onOutput: function(content) {
if (content.includes("命令结束标志")) {
completeOutput = buffer;
buffer = "";
}
}
});
4.3 权限问题
问题现象：即使使用Root权限，某些命令仍无法执行。
解决方案：
- 检查SELinux状态：
getenforce - 临时禁用SELinux：
setenforce 0 - 检查命令所需的其他权限
4.4 命令超时处理
对于可能长时间运行的命令，需要添加超时机制：
javascript复制function executeWithTimeout(command, timeout) {
let sh = new Shell(true);
let done = false;
let timer = null;
let promise = new Promise((resolve, reject) => {
sh.setCallback({
onOutput: function(content) {
if (content.includes("完成标志")) {
done = true;
resolve(content);
}
}
});
sh.exec(command);
timer = setTimeout(() => {
if (!done) {
sh.exit();
reject(new Error("命令执行超时"));
}
}, timeout);
});
promise.finally(() => {
clearTimeout(timer);
sh.exit();
});
return promise;
}
5. 高级技巧与最佳实践
5.1 常用Shell命令封装
将常用命令封装成函数可以提高代码复用性：
javascript复制const ShellUtils = {
// 获取已安装包列表
listPackages: function() {
let result = shell("pm list packages", true);
if (result.code === 0) {
return result.result.split("\n")
.map(line => line.replace("package:", "").trim())
.filter(pkg => pkg);
}
return [];
},
// 获取当前活动窗口
getCurrentActivity: function() {
let result = shell("dumpsys window windows", true);
if (result.code === 0) {
let match = result.result.match(/mCurrentFocus=Window\{.*?\s.*?\s(.*?)\}/);
return match ? match[1] : null;
}
return null;
},
// 执行命令并返回解析后的JSON
execJson: function(command) {
let result = shell(command, true);
if (result.code === 0) {
try {
return JSON.parse(result.result);
} catch (e) {
console.error("解析JSON失败:", e);
}
}
return null;
}
};
5.2 错误处理策略
完善的错误处理是Shell命令稳定执行的关键：
javascript复制function safeShell(command, options = {}) {
let defaults = {
root: true,
timeout: 5000,
retries: 3
};
options = Object.assign(defaults, options);
let lastError = null;
for (let i = 0; i < options.retries; i++) {
try {
let result = shell(command, options.root);
if (result.code === 0) {
return result.result;
} else {
lastError = new Error(`Shell命令执行失败(code=${result.code}): ${result.error}`);
}
} catch (e) {
lastError = e;
}
if (i < options.retries - 1) {
sleep(1000); // 重试间隔
}
}
throw lastError;
}
5.3 性能优化建议
- 减少Shell实例创建：复用Shell对象
- 批量执行命令：使用
&&连接多个命令 - 避免不必要的结果获取：对于不需要结果的命令使用Shell对象
- 合理使用异步：非关键路径使用异步执行
批量执行示例：
javascript复制// 低效方式
shell("command1", true);
shell("command2", true);
// 高效方式
shell("command1 && command2", true);
5.4 安全注意事项
- 谨慎执行Root命令：错误的命令可能导致系统不稳定
- 验证命令来源：避免执行不可信的Shell命令
- 限制权限：非必要不使用Root权限
- 异常捕获：确保异常情况下资源被正确释放
安全执行示例：
javascript复制function executeSafe(rootCommand) {
if (!isValidCommand(rootCommand)) {
throw new Error("无效的命令");
}
let sh = null;
try {
sh = new Shell(true);
return sh.exec(rootCommand);
} finally {
if (sh) {
sh.exit();
}
}
}
在Android自动化项目中，合理使用Shell命令可以极大扩展AutoJs的能力边界。通过本文介绍的技术和最佳实践，开发者可以在保证稳定性和安全性的前提下，充分发挥Shell命令的强大功能。记住，能力越大责任越大，特别是在使用Root权限时，务必谨慎操作。