Skip to content

ShadowDroid v1.0.0

Choose a tag to compare

@github-actions github-actions released this 23 Aug 19:33
· 169 commits to main since this release

ShadowDroid 1.0

ShadowDroid 1.0 establishes the stable agent-facing contract for Android automation and debugging: observable preconditions, explicit effects, structured failures, and verifiable postconditions across UI, app state, debugger, layout, and network workflows.

Highlights

  • Added first-class non-suspending debugger logpoints with replay cursors, filtering, redaction, and deterministic cleanup.
  • Made UI action guards authoritative and app-state recovery crash-safe.
  • Added machine-readable command/effect contracts so agents can inspect side effects before execution.
  • Made network fixture replay exact, rule sets typed and explainable, publication atomic, and persisted metadata redacted.
  • Added WebSocket protocol evidence and deterministic model/property tests for the network stack.
  • Expanded the Field Lab and CI to exercise real CLI/APK journeys on Android 16/API 36 phone and TV surfaces.
  • Hardened the release pipeline with cross-platform installer smoke tests, checksums, and release provenance.

Install

macOS/Linux:

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/andriyo/ShadowDroid/releases/latest/download/shadowdroid-installer.sh | sh

Windows PowerShell:

powershell -ExecutionPolicy Bypass -c "irm https://github.com/andriyo/ShadowDroid/releases/latest/download/shadowdroid-installer.ps1 | iex"

Then connect to an attached device or running emulator:

shadowdroid connect

Every published artifact is covered by SHA256SUMS; RELEASE_PROVENANCE.json records the source commit and release workflow run.

Full changelog: v0.16.1...v1.0.0