Agent Skills › maxrave-dev/SimpMusic › android-emulator-skill

android-emulator-skill

GitHub

提供Android应用构建、测试及自动化脚本，支持语义化UI导航、日志监控与模拟器生命周期管理。通过无障碍驱动交互，适配AI Agent，实现高效低Token输出的生产级自动化流程。

.claude/skills/android-emulator-skill/SKILL.md maxrave-dev/SimpMusic

Trigger Scenarios

需要自动化测试Android应用执行Android应用构建或安装在模拟器中进行UI元素交互监控Android应用运行日志

Install

npx skills add maxrave-dev/SimpMusic --skill android-emulator-skill -g -y

More Options

Non-standard path

npx skills add https://github.com/maxrave-dev/SimpMusic/tree/dev/.claude/skills/android-emulator-skill -g -y

Use without installing

npx skills use maxrave-dev/SimpMusic@android-emulator-skill

指定 Agent (Claude Code)

npx skills add maxrave-dev/SimpMusic --skill android-emulator-skill -a claude-code -g -y

安装 repo 全部 skill

npx skills add maxrave-dev/SimpMusic --all -g -y

预览 repo 内 skill

npx skills add maxrave-dev/SimpMusic --list

SKILL.md

Frontmatter

{
    "name": "android-emulator-skill",
    "version": "1.0.0",
    "description": "Production-ready scripts for Android app testing, building, and automation. Provides semantic UI navigation, build automation, log monitoring, and emulator lifecycle management. Optimized for AI agents with minimal token output."
}

Android Emulator Skill

Build, test, and automate Android applications using accessibility-driven navigation and structured data instead of pixel coordinates.

Quick Start

# 1. Check environment
bash scripts/emu_health_check.sh

# 2. Launch app
python scripts/app_launcher.py --launch com.example.app

# 3. Map screen to see elements
python scripts/screen_mapper.py

# 4. Tap button
python scripts/navigator.py --find-text "Login" --tap

# 5. Enter text
python scripts/navigator.py --find-type EditText --enter-text "user@example.com"

All scripts support --help for detailed options and --json for machine-readable output.

Production Scripts

Build & Development

build_and_test.py - Build Android projects, run tests, parse results
- Wrapper around Gradle
- Support for assemble, install, and connectedCheck
- Parse build errors and test results
- Options: --task, --clean, --json
log_monitor.py - Real-time log monitoring with intelligent filtering
- Wrapper around adb logcat
- Filter by tag, priority, or PID
- Deduplicate repeated messages
- Options: --package, --tag, --priority, --duration, --json

Navigation & Interaction

screen_mapper.py - Analyze current screen and list interactive elements
- Dump UI hierarchy using uiautomator
- Parse XML to identify buttons, text fields, etc.
- Options: --verbose, --json
navigator.py - Find and interact with elements semantically
- Find by text (fuzzy matching), resource-id, or class name
- Interactive tapping and text entry
- Options: --find-text, --find-id, --tap, --enter-text, --json
gesture.py - Perform swipes, scrolls, and other gestures
- Swipe up/down/left/right
- Scroll lists
- Options: --swipe, --scroll, --duration, --json
keyboard.py - Key events and hardware buttons
- Input key events (Home, Back, Enter, Tab)
- Type text via ADB
- Options: --key, --text, --json
app_launcher.py - App lifecycle management
- Launch apps (adb shell am start)
- Terminate apps (adb shell am force-stop)
- Install/Uninstall APKs
- List installed packages
- Options: --launch, --terminate, --install, --uninstall, --list, --json

Emulator Lifecycle Management

emulator_manage.py - Manage Android Virtual Devices (AVDs)
- List available AVDs
- Boot emulators
- Shutdown emulators
- Options: --list, --boot, --shutdown, --json
emu_health_check.sh - Verify environment is properly configured
- Check ADB, Emulator, Java, Gradle, ANDROID_HOME
- List connected devices

Common Patterns

Auto-Device Detection: Scripts target the single connected device/emulator if only one is present, or require -s <serial> if multiple are connected.

Output Formats: Default is concise human-readable output. Use --json for machine-readable output.