This change creates `pkg/dart_runtime_services/` with the initial implementation of `package:dart_runtime_service`. `package:dart_runtime_service` provides a simple interface to create Dart services with common platform-agnostic features and behaviors, while also allowing for configuration of custom service backends. This initial implementation focuses on providing the initial shared server functionality, including: - Handlers for web socket and SSE connections - Authentication code generation + validation - Client management - Initial RPC routing with two sample RPCs (getClientName, setClientName) Change-Id: I1458269a5de7edd97120103a2c5fc2d0348eff31 Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/478760 Reviewed-by: Alexander Thomas <athom@google.com> Commit-Queue: Ben Konyi <bkonyi@google.com>
1.8 KiB
Dart Runtime Services
Implementations of various Dart developer services based on package:dart_runtime_service.
Shared frontend, pluggable backend
package:dart_runtime_service provides a simple interface to create Dart services with common platform-agnostic features and behaviors, while also allowing for configuration of custom service backends. This removes the need for individual services to implement functionality common to most services, including:
- Launching and advertising a server
- Handling connections via various protocols (web sockets, SSE, HTTP)
- Authentication code verification
- Notification routing via stream subscriptions
- Client-registered service extension routing
- DevTools hosting
Roadmap
There are currently two planned runtime service implementations, with a focus on replacing dart:_vmservice and package:dwds:
-
package:dart_runtime_service_vm: an implementation of the Dart VM service protocol which can interact with the native runtimes. To be launched directly as an isolate bydartanddartaotruntime. -
package:dart_runtime_service_web: an implementation of the Dart VM service protocol which serves as a proxy to interact with a running web application. To eventually be launched usingdart web-development-serviceby developer tooling responsible for launching and managing DDC-based applications.
Future candidates for migration include:
-
package:dtd_impl: the implementation of the Dart Tooling Daemon (DTD), which implements a similar protocol to the VM service protocol. -
package:dds: the implementation of the Dart Development Service (DDS), which provides extensions to the VM service protocol. DDS reimplements much of the common functionality provided bypackage:dart_runtime_service, particularly around client management, stream subscriptions, and service extension routing.