mobile-debug-mcp 0.32.2 → 0.32.4

package/test/fixtures/ui-tree-bridge/build.ts

@@ -1,34 +0,0 @@
-import { execFileSync } from 'node:child_process'
-import { existsSync, mkdirSync } from 'node:fs'
-import path from 'node:path'
-import { fileURLToPath } from 'node:url'
-
-export function buildBridge() {
-  const root = path.dirname(fileURLToPath(import.meta.url))
-  const out = path.join(root, 'build')
-  const sdk = process.env.ANDROID_SDK_ROOT || process.env.ANDROID_HOME ||
-    (process.platform === 'darwin' && process.env.HOME ? path.join(process.env.HOME, 'Library/Android/sdk') : '')
-  if (!sdk) throw new Error('Android SDK not found: set ANDROID_SDK_ROOT or ANDROID_HOME')
-  const buildTools = path.join(sdk, 'build-tools', '36.0.0')
-  const androidJar = path.join(sdk, 'platforms', 'android-36', 'android.jar')
-  if (!existsSync(androidJar) || !existsSync(buildTools)) {
-    throw new Error(`Android SDK 36 platform and build-tools 36.0.0 are required under ${sdk}`)
-  }
-  const java = process.env.JAVA_HOME
-  const tool = (name: string) => java ? path.join(java, 'bin', name) : name
-  const run = (cmd: string, args: string[]) => execFileSync(cmd, args, { cwd: out, stdio: 'pipe' })
-  mkdirSync(path.join(out, 'classes'), { recursive: true })
-  run(tool('javac'), ['--release', '8', '-classpath', androidJar, '-d', 'classes', path.join(root, 'src/TreeInstrumentation.java')])
-  run(tool('jar'), ['cf', 'classes.jar', '-C', 'classes', '.'])
-  run(path.join(buildTools, 'd8'), ['--lib', androidJar, '--output', out, 'classes.jar'])
-  run(path.join(buildTools, 'aapt2'), ['link', '-I', androidJar, '--manifest', path.join(root, 'AndroidManifest.xml'), '-o', 'unsigned.apk'])
-  run('zip', ['-q', 'unsigned.apk', 'classes.dex'])
-  run(path.join(buildTools, 'zipalign'), ['-f', '4', 'unsigned.apk', 'aligned.apk'])
-  try { run(tool('keytool'), ['-genkeypair', '-keystore', 'fixture.jks', '-storepass', 'android', '-keypass', 'android', '-alias', 'fixture', '-dname', 'CN=UI Tree Bridge', '-keyalg', 'RSA', '-validity', '3650']) } catch { /* Existing local fixture key. */ }
-  run(path.join(buildTools, 'apksigner'), ['sign', '--ks', 'fixture.jks', '--ks-pass', 'pass:android', '--out', 'bridge.apk', 'aligned.apk'])
-  return path.join(out, 'bridge.apk')
-}
-
-if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
-  console.log(buildBridge())
-}

package/test/fixtures/ui-tree-bridge/src/TreeInstrumentation.java

@@ -1,126 +0,0 @@
-package dev.mobiledebugmcp.treebridge;
-
-import android.app.Instrumentation;
-import android.app.UiAutomation;
-import android.graphics.Rect;
-import android.os.Bundle;
-import android.os.Build;
-import android.util.Xml;
-import android.util.Log;
-import android.view.accessibility.AccessibilityNodeInfo;
-import java.io.BufferedReader;
-import java.io.InputStreamReader;
-import java.io.OutputStreamWriter;
-import java.io.StringWriter;
-import java.net.InetAddress;
-import java.net.ServerSocket;
-import java.net.Socket;
-import org.xmlpull.v1.XmlSerializer;
-
-/** Benchmark-only bridge: one live accessibility acquisition per TREE request. */
-public final class TreeInstrumentation extends Instrumentation {
-  private static final int PORT = 39019;
-
-  @Override public void onCreate(Bundle arguments) {
-    super.onCreate(arguments);
-    start();
-  }
-
-  @Override public void onStart() {
-    try (ServerSocket server = new ServerSocket(PORT, 1, InetAddress.getByName("127.0.0.1"))) {
-      UiAutomation automation = getUiAutomation(UiAutomation.FLAG_DONT_SUPPRESS_ACCESSIBILITY_SERVICES);
-      while (true) {
-        try (Socket socket = server.accept()) {
-          socket.setSoTimeout(10000);
-          BufferedReader input = new BufferedReader(new InputStreamReader(socket.getInputStream(), "UTF-8"));
-          OutputStreamWriter output = new OutputStreamWriter(socket.getOutputStream(), "UTF-8");
-          String command = input.readLine();
-          if ("STOP".equals(command)) {
-            output.write("OK\n");
-            output.flush();
-            break;
-          }
-          if ("PING".equals(command)) {
-            output.write("OK\n");
-            output.flush();
-            continue;
-          }
-          if (!"TREE".equals(command)) {
-            output.write("ERROR invalid_command\n");
-          } else {
-            if (Build.VERSION.SDK_INT < 34) {
-              output.write("ERROR cache_clear_unavailable\n");
-            } else if (!automation.clearCache()) {
-              output.write("ERROR cache_clear_failed\n");
-            } else {
-              AccessibilityNodeInfo root = automation.getRootInActiveWindow();
-              if (root == null) {
-                output.write("ERROR null_root\n");
-              } else {
-                output.write("OK\n");
-                output.write(serialize(root));
-                root.recycle();
-              }
-            }
-          }
-          output.flush();
-        } catch (Exception error) {
-          // A failed client request cannot make a later acquisition reuse its tree.
-          Log.e("TreeBridge", "request failed", error);
-        }
-      }
-    } catch (Exception error) {
-      // The host-side probe detects failure to start or connect.
-      Log.e("TreeBridge", "bridge failed", error);
-    }
-    finish(0, new Bundle());
-  }
-
-  private static String serialize(AccessibilityNodeInfo root) throws Exception {
-    StringWriter writer = new StringWriter();
-    XmlSerializer xml = Xml.newSerializer();
-    xml.setOutput(writer);
-    xml.startDocument("UTF-8", true);
-    xml.startTag("", "hierarchy");
-    writeNode(xml, root, 0);
-    xml.endTag("", "hierarchy");
-    xml.endDocument();
-    return writer.toString();
-  }
-
-  private static void writeNode(XmlSerializer xml, AccessibilityNodeInfo node, int index) throws Exception {
-    Rect bounds = new Rect();
-    node.getBoundsInScreen(bounds);
-    xml.startTag("", "node");
-    xml.attribute("", "index", Integer.toString(index));
-    xml.attribute("", "class", value(node.getClassName()));
-    xml.attribute("", "package", value(node.getPackageName()));
-    xml.attribute("", "text", value(node.getText()));
-    xml.attribute("", "content-desc", value(node.getContentDescription()));
-    xml.attribute("", "resource-id", value(node.getViewIdResourceName()));
-    xml.attribute("", "checkable", Boolean.toString(node.isCheckable()));
-    xml.attribute("", "checked", Boolean.toString(node.isChecked()));
-    xml.attribute("", "clickable", Boolean.toString(node.isClickable()));
-    xml.attribute("", "enabled", Boolean.toString(node.isEnabled()));
-    xml.attribute("", "focusable", Boolean.toString(node.isFocusable()));
-    xml.attribute("", "focused", Boolean.toString(node.isFocused()));
-    xml.attribute("", "scrollable", Boolean.toString(node.isScrollable()));
-    xml.attribute("", "long-clickable", Boolean.toString(node.isLongClickable()));
-    xml.attribute("", "password", Boolean.toString(node.isPassword()));
-    xml.attribute("", "selected", Boolean.toString(node.isSelected()));
-    xml.attribute("", "visible-to-user", Boolean.toString(node.isVisibleToUser()));
-    xml.attribute("", "bounds", bounds.toShortString());
-    for (int childIndex = 0; childIndex < node.getChildCount(); childIndex++) {
-      AccessibilityNodeInfo child = node.getChild(childIndex);
-      if (child != null && child.isVisibleToUser()) {
-        writeNode(xml, child, childIndex);
-      }
-      if (child != null) child.recycle();
-    }
-    xml.endTag("", "node");
-  }
-
-  private static String value(CharSequence input) {
-    return input == null ? "" : input.toString();
-  }
-}

package/test/unit/observe/android_tree_bridge_cleanup.test.ts

@@ -1,95 +0,0 @@
-import assert from 'node:assert/strict'
-import { chmodSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
-import { createServer } from 'node:net'
-import type { Socket } from 'node:net'
-import { tmpdir } from 'node:os'
-import path from 'node:path'
-import { readAndroidTreeFromBridge } from '../../../src/observe/android-tree-bridge.js'
-
-async function run() {
-  const directory = mkdtempSync(path.join(tmpdir(), 'mcp-tree-bridge-'))
-  const adbPath = path.join(directory, 'adb')
-  const apkPath = path.join(directory, 'bridge.apk')
-  const launchesPath = path.join(directory, 'launches')
-  const getpropsPath = path.join(directory, 'getprops')
-  const previous = new Map(['ADB_PATH', 'MOBILE_DEBUG_MCP_ANDROID_TREE_BRIDGE_APK', 'MCP_FAKE_BRIDGE_PORT', 'MCP_FAKE_BRIDGE_LAUNCHES', 'MCP_FAKE_BRIDGE_GETPROPS', 'MCP_FAKE_FORCE_STOP_FAIL', 'MCP_FAKE_SDK'].map((key) => [key, process.env[key]]))
-  let invalidTree = false
-  const sockets = new Set<Socket>()
-  const server = createServer((socket) => {
-    sockets.add(socket)
-    socket.once('close', () => sockets.delete(socket))
-    socket.once('data', (chunk) => {
-      const command = chunk.toString().trim()
-      socket.end(command === 'TREE'
-        ? invalidTree ? 'ERROR null_root\n' : 'OK\n<hierarchy><node class="android.view.View" /></hierarchy>'
-        : 'OK\n')
-    })
-  })
-  writeFileSync(apkPath, '')
-  writeFileSync(launchesPath, '')
-  writeFileSync(getpropsPath, '')
-  writeFileSync(adbPath, `#!/usr/bin/env node
-const fs = require('node:fs')
-const args = process.argv.slice(2).join(' ')
-if (args.includes('am instrument')) {
-  fs.appendFileSync(process.env.MCP_FAKE_BRIDGE_LAUNCHES, 'launch\\n')
-  setInterval(() => {}, 1000)
-} else if (args.includes('am force-stop') && process.env.MCP_FAKE_FORCE_STOP_FAIL === '1') {
-  process.exit(1)
-} else if (args.includes('forward tcp:0')) {
-  console.log(process.env.MCP_FAKE_BRIDGE_PORT)
-} else if (args.includes('getprop ro.build.version.sdk')) {
-  fs.appendFileSync(process.env.MCP_FAKE_BRIDGE_GETPROPS, 'getprop\\n')
-  console.log(process.env.MCP_FAKE_SDK || '36')
-}
-`)
-  chmodSync(adbPath, 0o755)
-  await new Promise<void>((resolve) => server.listen(0, '127.0.0.1', resolve))
-  const address = server.address()
-  if (!address || typeof address === 'string') throw new Error('No test port')
-  process.env.ADB_PATH = adbPath
-  process.env.MOBILE_DEBUG_MCP_ANDROID_TREE_BRIDGE_APK = apkPath
-  process.env.MCP_FAKE_BRIDGE_PORT = String(address.port)
-  process.env.MCP_FAKE_BRIDGE_LAUNCHES = launchesPath
-  process.env.MCP_FAKE_BRIDGE_GETPROPS = getpropsPath
-  try {
-    assert.match(await readAndroidTreeFromBridge('test-device') ?? '', /<hierarchy>/)
-    invalidTree = true
-    process.env.MCP_FAKE_FORCE_STOP_FAIL = '1'
-    await assert.rejects(() => readAndroidTreeFromBridge('test-device'), /BRIDGE_CLEANUP_UNCONFIRMED/)
-    await assert.rejects(() => readAndroidTreeFromBridge('test-device'), /BRIDGE_CLEANUP_UNCONFIRMED/)
-    assert.equal(readFileSync(launchesPath, 'utf8').trim().split('\n').length, 1, 'failed cleanup must block a second launch')
-    invalidTree = false
-    delete process.env.MCP_FAKE_FORCE_STOP_FAIL
-    assert.match(await readAndroidTreeFromBridge('test-device') ?? '', /<hierarchy>/, 'successful cleanup allows relaunch')
-    for (let attempt = 0; attempt < 20 && readFileSync(launchesPath, 'utf8').trim().split('\n').length < 2; attempt++) {
-      await new Promise((resolve) => setTimeout(resolve, 50))
-    }
-    assert.equal(readFileSync(launchesPath, 'utf8').trim().split('\n').length, 2)
-    invalidTree = true
-    assert.equal(await readAndroidTreeFromBridge('test-device'), null, 'clean shutdown permits legacy fallback')
-    process.env.MCP_FAKE_SDK = '33'
-    assert.equal(await readAndroidTreeFromBridge('old-device'), null, 'older Android versions use the legacy reader')
-    assert.equal(await readAndroidTreeFromBridge('old-device'), null)
-    assert.equal(readFileSync(getpropsPath, 'utf8').trim().split('\n').length, 3, 'unsupported devices recheck SDK support')
-    process.env.MCP_FAKE_SDK = '36'
-    invalidTree = false
-    assert.match(await readAndroidTreeFromBridge('old-device') ?? '', /<hierarchy>/, 'a newly supported device can start the bridge')
-    for (let attempt = 0; attempt < 20 && readFileSync(launchesPath, 'utf8').trim().split('\n').length < 3; attempt++) {
-      await new Promise((resolve) => setTimeout(resolve, 50))
-    }
-    assert.equal(readFileSync(launchesPath, 'utf8').trim().split('\n').length, 3)
-    invalidTree = true
-    assert.equal(await readAndroidTreeFromBridge('old-device'), null, 'the new bridge shuts down before fallback')
-  } finally {
-    for (const [key, value] of previous) {
-      if (value === undefined) delete process.env[key]
-      else process.env[key] = value
-    }
-    for (const socket of sockets) socket.destroy()
-    await new Promise<void>((resolve) => server.close(() => resolve()))
-    rmSync(directory, { recursive: true, force: true })
-  }
-}
-
-run().catch((error) => { console.error(error); process.exitCode = 1 })