Routing
Prepare only the Espresso route. Use driver-specific official guidance for an existing Espresso runtime failure after setup passes. Load FFmpeg or bundletool only when the user explicitly requested that capability.
Required inputs
Confirm Android as the target, global appium mode or explicitly requested
local npx appium mode, host OS, device or emulator expectations, permissions,
and optional dependency requests.
Workflow
- Load the global command profile by default or the local profile only when explicitly requested.
- Load the Android profile, shared Appium setup basics, and Android emulator setup Context.
- Load the Espresso decision, installation, doctor, and smoke references in that order.
- Run
node tools/appium/setup/scripts/check-espresso-env.mjs --format summary --report auto; add--appium-mode localonly for explicitly requested local mode. Require top-levelsummary.requiredOk: true. Apply required fixes in technical dependency order and rerun affected checks. If the gate remains unresolved, reportblockedwith evidence and the next action. Load the matching example only when needed. - Verify the direct doctor output reports
0 required fixes neededusingappium driver doctor espresso, ornpx --no-install appium driver doctor espressoin local mode. - Run
node tools/appium/setup/scripts/smoke-appium-server.mjs --driver espresso --report auto; add--appium-mode localonly in local mode. Requiresummary.requiredOk: truefor server readiness, driver evidence, and cleanup. The smoke reference documents target-specific options.
Espresso setup safety and approval constraints
- Preserve the selected command mode and working Java, Android SDK, device, emulator, and Espresso installations.
- Ask before optional FFmpeg or bundletool setup, privileged commands, SDK license changes, Espresso build changes, or emulator creation that changes local state.
Completion criteria
- Android environment completion criteria pass.
- Appium succeeds in the selected command mode.
- The installed driver list includes
espresso. appium driver doctor espressoreports0 required fixes needed; optional warnings are non-blocking./statussucceeds, server logs listespresso, and the server started for verification has exited.
Evidence boundary
Report Appium and Espresso versions, helper requiredOk, Android prerequisite
summary, doctor required/optional summary, /status, server driver evidence,
cleanup, and explicitly requested optional capability results.
Self-Improvement Prompt
Before the final response, report any missing, ambiguous, outdated, or retry-causing Espresso setup instruction with its asset path and proposed wording. Leave unrelated assets unchanged.