Android session automation and APK verification #2

Merged
hugooconnor merged 1 commit from feat/android-session into main 2026-03-23 03:47:43 +00:00
hugooconnor commented 2026-03-23 03:43:00 +00:00 (Migrated from codeberg.org)

Summary

  • Add android verify CLI command for end-to-end APK verification: install, launch, screenshot, visual diff against baseline, and crash detection
  • Add --skip-install flag to verify already-running apps without reinstalling
  • Add pixel-level visual comparison (pixelmatch) for android verify baselines
  • Add selectorless scroll support for full-screen scrolling via input swipe with auto-detected screen dimensions
  • Add scroll shorthand command to the interactive android session (scroll [direction] [selector] [percent])

Details

  • android verify orchestrates: APK install → app launch → screenshot capture → visual diff → crash check
  • Visual comparison uses pixelmatch with configurable threshold percentage
  • Selectorless scroll gets screen size via wm size and translates direction/percent into swipe coordinates
  • Scroll actions remain fully replayable — selectorless scrolls are recorded without a selector field and replay through the same input swipe path

Test plan

  • ar-crawl android verify <apk> installs, launches, captures screenshot, returns pass/fail
  • ar-crawl android verify <apk> --baseline <img> performs visual diff
  • ar-crawl android verify --skip-install -p <pkg> tests already-installed app
  • Interactive session: scroll / scroll up / scroll down res=list 75 all work
  • Selectorless scroll records and replays correctly via android replay
## Summary - Add `android verify` CLI command for end-to-end APK verification: install, launch, screenshot, visual diff against baseline, and crash detection - Add `--skip-install` flag to verify already-running apps without reinstalling - Add pixel-level visual comparison (pixelmatch) for android verify baselines - Add selectorless `scroll` support for full-screen scrolling via `input swipe` with auto-detected screen dimensions - Add `scroll` shorthand command to the interactive android session (`scroll [direction] [selector] [percent]`) ## Details - `android verify` orchestrates: APK install → app launch → screenshot capture → visual diff → crash check - Visual comparison uses pixelmatch with configurable threshold percentage - Selectorless scroll gets screen size via `wm size` and translates direction/percent into swipe coordinates - Scroll actions remain fully replayable — selectorless scrolls are recorded without a selector field and replay through the same `input swipe` path ## Test plan - [ ] `ar-crawl android verify <apk>` installs, launches, captures screenshot, returns pass/fail - [ ] `ar-crawl android verify <apk> --baseline <img>` performs visual diff - [ ] `ar-crawl android verify --skip-install -p <pkg>` tests already-installed app - [ ] Interactive session: `scroll` / `scroll up` / `scroll down res=list 75` all work - [ ] Selectorless scroll records and replays correctly via `android replay`
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
anuna-research/ar-crawl!2
No description provided.