android_uiautomator_long_click
Perform a long press on Android UI elements using resource IDs to access context menus or extended options during automated testing.
Instructions
Perform a long click on a UI element by resource ID
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| resourceId | Yes | Resource ID of the element to long click | |
| deviceSerial | No | Specific device serial number to target (optional) |
Implementation Reference
- src/handlers.ts:441-465 (handler)Main handler function for android_uiautomator_long_click tool. Validates resourceId and calls ADB wrapper's longClickElementByResourceId method.
export async function uiautomatorLongClickHandler( adb: ADBWrapper, args: any ): Promise<{ content: Array<{ type: string; text: string }> }> { const { resourceId, deviceSerial } = args as UIAutomatorLongClickArgs; if (!resourceId || typeof resourceId !== 'string') { throw new Error('Invalid resource ID: resourceId must be a non-empty string'); } try { await adb.longClickElementByResourceId(resourceId, deviceSerial); return { content: [ { type: 'text', text: `Successfully long-clicked element with resource-id: ${resourceId}`, }, ], }; } catch (error) { throw new Error(`UIAutomator long click failed: ${error instanceof Error ? error.message : String(error)}`); } } - src/adb-wrapper.ts:638-663 (helper)Core logic for long clicking: dumps UI hierarchy with uiautomator, parses bounds from XML using regex, computes center coordinates, and performs long touch using the touch method (swipe at same point for 500ms).
async longClickElementByResourceId(resourceId: string, deviceSerial?: string): Promise<void> { const device = await this.getTargetDevice(deviceSerial); const hierarchyFile = '/sdcard/window_dump.xml'; await this.exec(['shell', 'uiautomator', 'dump', hierarchyFile], device); const { stdout } = await this.exec(['shell', 'cat', hierarchyFile], device); await this.exec(['shell', 'rm', hierarchyFile], device); const boundsRegex = new RegExp(`resource-id="${resourceId}"[^>]*bounds="\\[(\\d+),(\\d+)\\]\\[(\\d+),(\\d+)\\]"`); const match = stdout.match(boundsRegex); if (match) { const x1 = parseInt(match[1], 10); const y1 = parseInt(match[2], 10); const x2 = parseInt(match[3], 10); const y2 = parseInt(match[4], 10); const centerX = Math.floor((x1 + x2) / 2); const centerY = Math.floor((y1 + y2) / 2); // Long click is typically 500ms or more await this.touch(centerX, centerY, 500, device); } else { throw new Error(`Element with resource-id ${resourceId} not found in UI hierarchy`); } } - src/index.ts:270-287 (schema)JSON schema definition for the tool's input parameters, registered in the listTools handler.
{ name: 'android_uiautomator_long_click', description: 'Perform a long click on a UI element by resource ID', inputSchema: { type: 'object', properties: { resourceId: { type: 'string', description: 'Resource ID of the element to long click', }, deviceSerial: { type: 'string', description: 'Specific device serial number to target (optional)', }, }, required: ['resourceId'], }, }, - src/index.ts:486-487 (registration)Registration in the tool call switch statement, dispatching to the handler function.
case 'android_uiautomator_long_click': return await uiautomatorLongClickHandler(this.adb, args); - src/handlers.ts:66-69 (schema)TypeScript type definition for handler arguments.
interface UIAutomatorLongClickArgs { resourceId: string; deviceSerial?: string; }