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.
The English summary is being prepared. Showing the original description.
See how to installReview the instructions the agent will receive before you install.
Build, test, and automate Android applications using accessibility-driven navigation and structured data instead of pixel coordinates.
# 1. Check environment (use .sh on macOS/Linux, .ps1 on Windows)
bash scripts/emu_health_check.sh
# or on Windows: .\scripts\emu_health_check.ps1
# 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.
build_and_test.py - Build Android projects, run tests, parse results
--task, --clean, --jsonlog_monitor.py - Real-time log monitoring with intelligent filtering
adb logcat--package, --tag, --priority, --duration, --jsonscreen_mapper.py - Analyze current screen and list interactive elements
uiautomator--verbose, --jsonnavigator.py - Find and interact with elements semantically
--find-text, --find-id, --tap, --enter-text, --jsongesture.py - Perform swipes, scrolls, and other gestures
--swipe, --scroll, --duration, --jsonkeyboard.py - Key events and hardware buttons
--key, --text, --jsonapp_launcher.py - App lifecycle management
adb shell am start)adb shell am force-stop)--launch, --terminate, --install, --uninstall, --list, --jsonemulator_manage.py - Manage Android Virtual Devices (AVDs)
--list, --boot, --shutdown, --jsonemu_health_check - Verify environment is properly configured
emu_health_check.sh on macOS/Linux and emu_health_check.ps1 on WindowsAuto-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.
Semantic Navigation: Find elements by text, resource-id, or content-description.
Token Efficiency: Concise default output with optional verbose and JSON modes.
Zero Configuration: Works with standard Android SDK installation.
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Expert checklist and prompts for auditing and fixing Android accessibility issues, especially in Jetpack Compose.
The English summary is being prepared. Showing the original description.
Expert guidance on setting up and maintaining a modern Android application architecture using Clean Architecture and Hilt. Use this when asked about project structure, module setup, or dependency injection.
The English summary is being prepared. Showing the original description.
Authoritative rules and patterns for production-quality Kotlin Coroutines onto Android. Covers structured concurrency, lifecycle integration, and reactive streams.
The English summary is being prepared. Showing the original description.
Guidance on implementing the Data Layer using Repository pattern, Room (Local), and Retrofit (Remote) with offline-first synchronization.
The English summary is being prepared. Showing the original description.
Expert guidance on setting up scalable Gradle build logic using Convention Plugins and Version Catalogs.
The English summary is being prepared. Showing the original description.
Expert guidance on setting up and using Retrofit for type-safe HTTP networking in Android. Covers service definitions, coroutines, OkHttp configuration, and Hilt integration.
The English summary is being prepared. Showing the original description.