skills.rest
SpreadZhao
SpreadZhaoCOMMUNITY
Explore all skills by this author →
GitHub

android-waydroid-control

Control Waydroid and Android devices through Android Studio SDK adb for automated app debugging.

4|Updated May 20, 2024
Search Tags:#automation#debugging#ui testing#android#adb#logcat#waydroid
One-click install
npx skills add https://github.com/SpreadZhao/spreadconfig --skill android-waydroid-control-spreadzhao
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: android-waydroid-control
Source: https://github.com/SpreadZhao/spreadconfig/tree/main/skills/local/android-waydroid-control
Command: npx skills add https://github.com/SpreadZhao/spreadconfig --skill android-waydroid-control-spreadzhao

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Debugging Android apps on Waydroid or local devices requires repetitive manual adb commands for connecting, waking frozen containers, capturing UI state, and driving input. This Skill automates that loop so an AI agent can inspect and control the Android runtime directly. ## Core Features & Use Cases - Session and adb management: Start Waydroid sessions, wake FROZEN containers, connect adb over the Waydroid IP, and recover from offline or unauthorized device states. - UI observation and input: Capture screenshots with PNG header cleanup, dump uiautomator XML, and send taps, swipes, text, and keyevents to explicit device serials. - App debugging: Install APKs, launch packages with monkey, inspect the top activity with dumpsys, and read or clear logcat output. - Use Case: While debugging an Android app, ask the agent to start Waydroid, install your debug APK, launch it, screenshot the result, dump the UI hierarchy, and pull logcat to diagnose a crash. ## Quick Start Ask the agent to start Waydroid, connect adb, install your debug APK, launch the app, and capture a screenshot with a UI dump and recent logcat output.

Frequently Asked Questions about android-waydroid-control

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

FAQPage Schema
How do I connect adb to a Waydroid session?▼

Start the Waydroid session, read its IP address from waydroid status, then run adb connect against that IP on port 5555. The bundled helper script automates this with the start or connect commands and verifies the device state.

How do I capture a screenshot from Waydroid with adb?▼

Run adb exec-out screencap -p and save the output to a PNG file. Waydroid can emit graphics warnings before the PNG stream, so strip any bytes before the PNG header, which the helper script handles automatically.

Why does adb show my Waydroid device as unauthorized or offline?▼

Unauthorized means the RSA prompt was not accepted in the Waydroid UI; open the full UI and approve it. Offline usually requires disconnecting, killing the adb server, restarting it, and reconnecting to the device serial.

Can I use this with a physical Android device instead of Waydroid?▼

Yes, the same adb commands work against any connected Android device as long as you select the target serial explicitly. The Waydroid-specific session and container management steps only apply to Waydroid targets.

What should I do when the Waydroid container is FROZEN?▼

A FROZEN container means the UI went idle, so wake or restart the session until waydroid status reports Container: RUNNING before sending input or screencap commands. The helper script detects this state and restarts the session automatically.

Related Skills

Explore More Software Engineering Skills→
j4xiej4xie

build-android-apk

Build and package Android APKs for React Native projects.

Community
Advanced
AniTrendAniTrend
51

android-ui-automator-preview

Capture Android UI evidence via UIAutomator XML dumps and adb screenshots.

Official
Intermediate
bitwardenbitwarden
9.3k

build-test-verify

Runs Gradle builds, unit tests, detekt lint, and deployment commands for the Bitwarden Android project.

Official
Intermediate
rnavarychrnavarych
14

role-aqa:mobile-testing

Automate mobile app testing on iOS and Android with Appium, Detox, XCUITest, and Espresso.

Community
Advanced