android-emulator

Controls Android emulator apps via the andy CLI for UI automation and verification.

78|27|Updated May 4, 2024
One-click install
npx skills add https://github.com/fedixyz/fedi --skill android-emulator-fedixyz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: android-emulator
Source: https://github.com/fedixyz/fedi/tree/main/.agents/skills/android-emulator
Command: npx skills add https://github.com/fedixyz/fedi --skill android-emulator-fedixyz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually verifying Android app behavior on an emulator is slow and error-prone. This Skill lets an AI agent launch apps, tap UI elements, read accessibility trees, and capture screenshots through the andy CLI, enabling automated UI testing and verification of the Fedi Android app. ## Core Features & Use Cases - UI Automation: Launch apps, tap elements by text or coordinates, swipe, type, and send key events like BACK and ENTER. - Screen Inspection: Capture screenshots and dump human-readable accessibility trees with automatic idle waiting. - Multi-Screen Testing: Run multiple app instances on separate virtual displays using ANDY_SCREEN, with helper scripts for onboarding, DM setup, and acquiring test ecash. - Use Case: After modifying a React Native screen, launch the app, tap through the flow, and read screenshots at each step to verify layout and styling. ## Quick Start Launch the Fedi app on the emulator with andy, then dump the accessibility tree and take a screenshot to verify the current screen.

Frequently Asked Questions about android-emulator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate tapping Android UI elements from the command line?

Use the andy CLI to tap elements by exact accessibility text, such as andy tap "Get started", or by coordinates like andy tap 500,300. Check the a11y tree first since many icon buttons have no text labels and require coordinate taps.

How to take screenshots of an Android emulator for UI verification?

Run andy screenshot /tmp/s.png to capture the current screen. Screenshots auto-wait for UI idle, so no explicit sleep is needed, and you can chain them after taps with && for tap-then-verify workflows.

Can I run multiple Android app instances on separate emulator displays?

Yes, andy supports multiple virtual displays via the ANDY_SCREEN environment variable or --screen flag. Each screen gets its own app package, and you can run parallel commands across screens for multi-user testing.

Why does tapping by text fail on some Android elements?

Text taps fail when the element has no text or content description in the accessibility tree, such as tab bars and icon buttons. Read the a11y output, compute the center of the element's bounds, and tap by coordinates instead.

What to do when Android deep links fail with activity not found?

If andy open-url reports the activity class does not exist, the package uses a shared activity class. Find the correct activity with adb shell dumpsys package, then launch with adb shell am start using the display ID from andy info.