import { execSync, exec } from "child_process";
import { promisify } from "util";
const execAsync = promisify(exec);
export class AdbClient {
deviceId;
constructor(deviceId) {
this.deviceId = deviceId;
}
get deviceFlag() {
return this.deviceId ? `-s ${this.deviceId}` : "";
}
/**
* Execute ADB command and return stdout as string
*/
exec(command) {
const fullCommand = `adb ${this.deviceFlag} ${command}`;
try {
return execSync(fullCommand, {
encoding: "utf-8",
maxBuffer: 50 * 1024 * 1024 // 50MB for screenshots
}).trim();
}
catch (error) {
throw new Error(`ADB command failed: ${fullCommand}\n${error.message}`);
}
}
/**
* Execute ADB command and return raw bytes (for screenshots)
*/
execRaw(command) {
const fullCommand = `adb ${this.deviceFlag} ${command}`;
try {
return execSync(fullCommand, {
maxBuffer: 50 * 1024 * 1024
});
}
catch (error) {
throw new Error(`ADB command failed: ${fullCommand}\n${error.message}`);
}
}
/**
* Execute ADB command async
*/
async execAsync(command) {
const fullCommand = `adb ${this.deviceFlag} ${command}`;
const { stdout } = await execAsync(fullCommand, {
maxBuffer: 50 * 1024 * 1024
});
return stdout.trim();
}
/**
* Get list of connected devices
*/
getDevices() {
const output = execSync("adb devices -l", { encoding: "utf-8" });
const lines = output.split("\n").slice(1); // Skip header
return lines
.filter(line => line.trim())
.map(line => {
const parts = line.split(/\s+/);
const id = parts[0];
const state = parts[1];
const modelMatch = line.match(/model:(\S+)/);
return {
id,
state,
model: modelMatch?.[1]
};
});
}
/**
* Set active device
*/
setDevice(deviceId) {
this.deviceId = deviceId;
}
/**
* Take screenshot and return raw PNG buffer
*/
screenshotRaw() {
return this.execRaw("exec-out screencap -p");
}
/**
* Take screenshot and return as base64 PNG (legacy)
*/
screenshot() {
return this.screenshotRaw().toString("base64");
}
/**
* Tap at coordinates
*/
tap(x, y) {
this.exec(`shell input tap ${x} ${y}`);
}
/**
* Long press at coordinates
*/
longPress(x, y, durationMs = 1000) {
this.exec(`shell input swipe ${x} ${y} ${x} ${y} ${durationMs}`);
}
/**
* Swipe gesture
*/
swipe(x1, y1, x2, y2, durationMs = 300) {
this.exec(`shell input swipe ${x1} ${y1} ${x2} ${y2} ${durationMs}`);
}
/**
* Swipe in direction (uses screen center)
*/
swipeDirection(direction, distance = 800) {
// Get screen size
const sizeOutput = this.exec("shell wm size");
const match = sizeOutput.match(/(\d+)x(\d+)/);
const width = match ? parseInt(match[1]) : 1080;
const height = match ? parseInt(match[2]) : 1920;
const centerX = Math.floor(width / 2);
const centerY = Math.floor(height / 2);
const coords = {
up: [centerX, centerY + distance / 2, centerX, centerY - distance / 2],
down: [centerX, centerY - distance / 2, centerX, centerY + distance / 2],
left: [centerX + distance / 2, centerY, centerX - distance / 2, centerY],
right: [centerX - distance / 2, centerY, centerX + distance / 2, centerY],
};
const [x1, y1, x2, y2] = coords[direction];
this.swipe(x1, y1, x2, y2);
}
/**
* Input text
*/
inputText(text) {
// Escape special characters for shell
const escaped = text
.replace(/\\/g, "\\\\")
.replace(/"/g, '\\"')
.replace(/'/g, "\\'")
.replace(/`/g, "\\`")
.replace(/\$/g, "\\$")
.replace(/ /g, "%s")
.replace(/&/g, "\\&")
.replace(/\(/g, "\\(")
.replace(/\)/g, "\\)")
.replace(/</g, "\\<")
.replace(/>/g, "\\>")
.replace(/\|/g, "\\|")
.replace(/;/g, "\\;");
this.exec(`shell input text "${escaped}"`);
}
/**
* Press key by name or keycode
*/
pressKey(key) {
const keyCodes = {
"BACK": 4,
"HOME": 3,
"MENU": 82,
"ENTER": 66,
"TAB": 61,
"DELETE": 67,
"BACKSPACE": 67,
"POWER": 26,
"VOLUME_UP": 24,
"VOLUME_DOWN": 25,
"VOLUME_MUTE": 164,
"CAMERA": 27,
"APP_SWITCH": 187,
"DPAD_UP": 19,
"DPAD_DOWN": 20,
"DPAD_LEFT": 21,
"DPAD_RIGHT": 22,
"DPAD_CENTER": 23,
"SEARCH": 84,
"ESCAPE": 111,
"SPACE": 62,
};
const keyCode = keyCodes[key.toUpperCase()] ?? parseInt(key);
if (isNaN(keyCode)) {
throw new Error(`Unknown key: ${key}`);
}
this.exec(`shell input keyevent ${keyCode}`);
}
/**
* Get UI hierarchy XML
*/
getUiHierarchy() {
this.exec("shell uiautomator dump /sdcard/ui.xml");
return this.exec("shell cat /sdcard/ui.xml");
}
/**
* Launch app by package name
*/
launchApp(packageName) {
// Try to get launch activity
try {
const output = this.exec(`shell cmd package resolve-activity --brief ${packageName}`);
const activity = output.split("\n").find(line => line.includes("/"));
if (activity) {
this.exec(`shell am start -n ${activity.trim()}`);
return `Launched ${activity.trim()}`;
}
}
catch {
// Fallback: use monkey to launch
}
this.exec(`shell monkey -p ${packageName} -c android.intent.category.LAUNCHER 1`);
return `Launched ${packageName}`;
}
/**
* Stop app
*/
stopApp(packageName) {
this.exec(`shell am force-stop ${packageName}`);
}
/**
* Clear app data
*/
clearAppData(packageName) {
this.exec(`shell pm clear ${packageName}`);
}
/**
* Install APK
*/
installApk(apkPath) {
return this.exec(`install -r "${apkPath}"`);
}
/**
* Uninstall app
*/
uninstallApp(packageName) {
return this.exec(`uninstall ${packageName}`);
}
/**
* Get current activity
*/
getCurrentActivity() {
const output = this.exec("shell dumpsys activity activities | grep mResumedActivity");
const match = output.match(/(\S+\/\S+)/);
return match?.[1] ?? "unknown";
}
/**
* Get screen size
*/
getScreenSize() {
const output = this.exec("shell wm size");
const match = output.match(/(\d+)x(\d+)/);
return {
width: match ? parseInt(match[1]) : 1080,
height: match ? parseInt(match[2]) : 1920
};
}
/**
* Wait for device
*/
waitForDevice() {
this.exec("wait-for-device");
}
/**
* Execute shell command
*/
shell(command) {
return this.exec(`shell ${command}`);
}
/**
* Get device logs (logcat)
* @param options - filter options
*/
getLogs(options = {}) {
let cmd = "logcat -d";
// Filter by log level
if (options.level) {
cmd += ` *:${options.level}`;
}
// Filter by tag
if (options.tag) {
cmd += ` -s ${options.tag}`;
}
// Limit number of lines
if (options.lines) {
cmd += ` -t ${options.lines}`;
}
// Filter by time (e.g., "01-01 00:00:00.000")
if (options.since) {
cmd += ` -t "${options.since}"`;
}
const output = this.exec(`shell ${cmd}`);
// Filter by package if specified
if (options.package) {
const lines = output.split("\n");
const filtered = lines.filter(line => line.includes(options.package) ||
line.match(/^\d+-\d+\s+\d+:\d+/) // Keep timestamp lines
);
return filtered.join("\n");
}
return output;
}
/**
* Clear logcat buffer
*/
clearLogs() {
this.exec("logcat -c");
}
/**
* Get network stats
*/
getNetworkStats() {
return this.exec("shell dumpsys netstats | head -100");
}
/**
* Get battery info
*/
getBatteryInfo() {
return this.exec("shell dumpsys battery");
}
/**
* Get memory info
*/
getMemoryInfo(packageName) {
if (packageName) {
return this.exec(`shell dumpsys meminfo ${packageName}`);
}
return this.exec("shell cat /proc/meminfo | head -20");
}
/**
* Get CPU info
*/
getCpuInfo() {
return this.exec("shell top -n 1 | head -20");
}
}
//# sourceMappingURL=client.js.map
