pj/sanderling
1
0 Fork 0
mirror of https://github.com/priyanshujain/sanderling.git synced 2026-10-04 20:17:09 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: remove in-app SDK from architecture doc

Browse Source
This commit is contained in:
pj committed 2026-04-25 19:20:59 +07:00
1 parent 74e0744ae3
commit 3ba475d7de
1 file changed
+7 -15
Download Patch File Download Diff File Expand all files Collapse all files
docs/development/architecture.md
+7 -15
View File
@@ -15,15 +15,12 @@ flowchart TB
end end
SC["Maestro sidecar (JVM)"] SC["Maestro sidecar (JVM)"]
SDK["in-app SDK\n(Device / Emulator)"]
CH["Chrome (CDP)"] CH["Chrome (CDP)"]
RD[("runs/")] RD[("runs/")]
IN["sanderling inspect\nHTTP + SSE"] IN["sanderling inspect\nHTTP + SSE"]
UI["Web UI (React)"] UI["Web UI (React)"]
D -->|gRPC| SC D -->|gRPC| SC
SC -->|UIAutomator / XCTest| SDK
R -->|"Unix socket<br/>(pause / state / logs)"| SDK
D -->|CDP| CH D -->|CDP| CH
T --> RD --> IN --> UI T --> RD --> IN --> UI
@@ -35,16 +32,13 @@ flowchart TB
**Maestro sidecar (JVM).** A Kotlin process that wraps `maestro-client` and exposes a gRPC surface matching the `DeviceDriver` interface. Handles UI input, screenshots, the system accessibility tree, and OS-level alerts. Native platforms only. **Maestro sidecar (JVM).** A Kotlin process that wraps `maestro-client` and exposes a gRPC surface matching the `DeviceDriver` interface. Handles UI input, screenshots, the system accessibility tree, and OS-level alerts. Native platforms only.
**In-app SDK.** A Kotlin (or Swift for iOS) library linked into the app under test. Exposes a Unix socket to the runner. Provides pause and resume, view-hierarchy dumps, coverage reads, log capture, and user-registered state extractors. Native platforms only. **Chrome (CDP).** For web targets, the Go binary drives Chrome directly over the Chrome DevTools Protocol. No sidecar is involved.
**Chrome (CDP).** For web targets, the Go binary drives Chrome directly over the Chrome DevTools Protocol. No sidecar or in-app SDK is involved.
## Transports ## Transports
| Channel | Platform | Transport | Purpose | | Channel | Platform | Transport | Purpose |
|---|---|---|---| |---|---|---|---|
| Go to Maestro sidecar | Native | gRPC (localhost TCP) | UI input, screenshots, system alerts | | Go to Maestro sidecar | Native | gRPC (localhost TCP) | UI input, screenshots, system alerts |
| Go to in-app SDK | Native | Unix domain socket | Pause / resume, hierarchy, coverage, logs, extractors |
| Go to Chrome | Web | Chrome DevTools Protocol | UI input, screenshots, DOM hierarchy, console logs | | Go to Chrome | Web | Chrome DevTools Protocol | UI input, screenshots, DOM hierarchy, console logs |
On native, the transport split exists because only real UI events need to cross process and OS-API boundaries. Introspection is cheap, frequent, and lives on a fast local socket directly to the app. On web, CDP handles both. On native, the transport split exists because only real UI events need to cross process and OS-API boundaries. Introspection is cheap, frequent, and lives on a fast local socket directly to the app. On web, CDP handles both.
@@ -64,17 +58,15 @@ pause ─► capture state ─► evaluate properties ─► pick action
**Native (Android / iOS):** **Native (Android / iOS):**
1. The runner asks the driver to wait until the UI is idle. 1. The runner asks the driver to wait until the UI is idle.
2. The runner sends `PAUSE` to the SDK over the Unix socket. The SDK freezes the main runloop at a safe point. 2. The runner fetches the UI hierarchy and logs from the sidecar.
3. The SDK sends back a `STATE` message: view hierarchy, coverage delta, logs since last step, exception list, snapshot values. 3. The runner feeds state into goja. Extractors re-read; properties re-evaluate; the action generator returns a weighted tree.
4. The runner feeds state into goja. Extractors re-read; properties re-evaluate; the action generator returns a weighted tree. 4. The runner writes the trace entry for this step.
5. The runner writes the trace entry for this step. 5. The runner picks an action by weight and dispatches it through the driver (gRPC to sidecar -> Maestro -> UIAutomator or XCTest).
6. The runner picks an action by weight. 6. Loop.
7. The runner sends `RESUME` to the SDK, then dispatches the action through the driver (gRPC to sidecar → Maestro → UIAutomator or XCTest).
8. Loop.
**Web (Chrome):** **Web (Chrome):**
Steps 2-3 use CDP to capture the DOM hierarchy and console logs directly; there is no SDK pause/resume. The rest of the cycle is identical. CDP captures the DOM hierarchy and console logs directly. The rest of the cycle is identical.
The cycle runs hundreds of times per minute. Every step produces one row in `trace.jsonl` and one screenshot. The cycle runs hundreds of times per minute. Every step produces one row in `trace.jsonl` and one screenshot.