Cloud provider `ddp`: Google Developer Device Platform Device Streaming (Android, preview) — implementation plan

Đang mở
#443 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
25/100
Loại issue
Tính năng
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
android, go, google-cloud, grpc

Hướng nghiên cứu

Start with the internal/cloud provider interface and the existing direct cloud path (ForwardPort → DialWithOptions → handshake), then read the research and spike result in #434. The plan spans a new gRPC provider, CLI wiring, catalog lookup, token reading, tests, and docs, so it needs substantial project context. Done means all three phases are complete; live verification requires the owner’s request for a specific project.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

area/cloud enhancement parked

Follows the research and spike result in #434. Replaces nothing yet: the firebase provider stays until Google's shutdown on September 30, 2027. This is the plan; no code is written.

Scope

A new provider ddp that runs the existing Android flow on a remote device from Google's Device Streaming API, without a relay. Preview (the APIs are v1 and v1alpha, preview) and Android only (the catalog lists no iOS device with the streaming product). Documented as "implemented, tested against a fake server, not yet verified end to end on a live account" until a live run is recorded.

Why it fits

The spike showed that over one DirectAccessService/AdbConnect stream a client can Open{service:"tcp:<port>"} to a process on the device, run shell: / exec: services, and upload bytes (3 MiB, hash matched). So the provider only has to turn that stream into a local TCP port, and the current direct cloud path (ForwardPort -> DialWithOptions -> handshake) works.

Design

  1. Transport: gRPC only. Create/Get/Cancel and AdbConnect are all RPCs of DirectAccessService (devicestreaming.googleapis.com:443), so one transport. Use the generated devicestreamingpb types with grpc directly (not the full client library) to keep the dependency footprint small; check each new module against the repository's license-compliance job before adding it.
  2. Auth: Application Default Credentials (gcloud auth application-default login or GOOGLE_APPLICATION_CREDENTIALS), through golang.org/x/oauth2/google. The only configured value is the Google Cloud project id (cloud.credentials.project_id); no key or token is ever stored in probe.yaml, printed, or logged. The quota project is that project.
  3. Interface fit (internal/cloud):
    • UploadApp(path) only records the local APK path (nothing can be pushed before a session exists); appID is that path.
    • StartSession creates the session (MediumPhone.arm-style modelCode + version id; a TTL; clientInfo.client = "flutter-probe"), polls until ACTIVE (13 to 19 s in the spike; timeout configurable, default 3 min), opens AdbConnect with the X-Omnilab-Session-Name header, pushes the APK with an exec: stream (16 KiB chunks) and installs it with pm install -r, then launches the app (monkey-free: am start of the launcher activity, as the local path does).
    • ForwardPort(devicePort) starts a loopback listener on a free port; each accepted connection gets a new stream id and Open{service:"tcp:<devicePort>"}; two pumps copy bytes both ways; closes propagate as StreamData{close}. One shared gRPC stream, a send mutex, a receive loop that demultiplexes by stream id.
    • StopSession cancels the session (idempotent) and is also called from a signal handler and on context cancel, so an interrupted run does not leave a billed session behind.
  4. Agent token. The direct cloud path connects without a token today. Add an optional interface AgentTokenReader (ReadAgentToken(ctx, session) (string, error)) that ddp implements with the same run-as/file read the local Android path uses, over a shell: stream; the CLI uses it when the provider offers it. Never logged.
  5. Devices. ListDevices reads the Device Run catalog (devicerun.googleapis.com/v1alpha/.../devices, REST) and keeps Android entries whose supportedProducts include deviceStreaming; --cloud-device takes the display model plus version and maps it to the modelCode (a physical model's lower-case catalog id was refused by the API; modelCode worked).
  6. Safety. Default TTL short (for example 30 minutes, cloud.ttl), a visible message with the session id and a cancel hint, a documented cloud.max_session cap, and a probe cloud sessions listing/cancel command in a later step. Billing is the user's; the docs say device time is billed and link the vendor's pricing page.
  7. Registration and docs. ValidProviders, --cloud-provider help, probe.yaml.example, README farm table (support level "implemented, fake-server tested, not verified live"), the Cloud device farms page, VS Code surfaces, llms.txt, CHANGELOG, migration note from firebase.

Tests (all in CI, no network, no credentials)

  • A fake DirectAccessService over bufconn that implements Create/Get/Cancel and an AdbConnect that serves: StatusUpdate, shell:/exec: echo and a hash-checked upload, tcp:<port> backed by an in-process TCP echo server, Fail status for an unavailable port, stream close, and an abrupt stream error.
  • Unit tests: state machine (REQUESTED -> PENDING -> ACTIVE, timeout, unexpected state), cancel on StopSession / context cancel / signal, bridge with 20 concurrent connections, large transfer (several MiB) through the bridge, token read parsing, catalog filtering and name -> modelCode mapping with an httptest server, and a check that no token or credential appears in errors or logs.
  • A test that the CLI uses the provider's token reader and the direct path (not the relay).

Phases and acceptance

  1. Transport + fake-server tests (internal/cloud/ddp*), no CLI wiring. Done when the bridge tests pass under -race.
  2. CLI wiring and docs, preview and Android-only wording, a deprecation cross-link from firebase.
  3. Live verification, only when the owner asks for it in chat for a specific project: one session, the real agent APK, one .probe file; record device, API versions and timings in docs/evidence/ without account details, then update the support level.

Out of scope

iOS (not offered by the API), the Device Run (batch) API, session reuse across runs, the hosted relay.

Risks

Preview APIs may change; pricing is not published in the pages read; the default session expiry seen was 5 minutes and idle behaviour (inactivityTimeout) is unknown; quotas unknown; a dependency on google.golang.org/grpc and protobuf enlarges the binary.

Ngôn ngữ chính
Go
Star
6
Fork
3
Merge trung bình
6 giờ 28 phút
Pull request đã merge (30 ngày)
362

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của AlphaWaveSystems/flutter-probe

Tất cả issue của AlphaWaveSystems/flutter-probe

Issue tương tự

Thêm issue về Go

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.