☂️ Help Dart developers navigate Dart's platform interop support

Overview

This is an overarching project that will continue throughout the year and beyond, as we aim to help Dart developers learn about, understand, use, and build on Dart's evolving platform interoperability support. Over the past few years, Dart's interop story has completely changed, and we're long past the world of using the embedder API or native VM extensions. The interop story for web was more foundational for Dart but is now entering its next generation.

As Dart (and Flutter) target many platforms, this development has occurred in many different forms, in many different places, and across almost a decade, but we're nearing a point where it's all starting to come together. Now we have to help Dart developers actually understand how it comes together and how to take advantage of that in their own projects. A few savvy community members have been following along or picking up the pieces along the way, but now every Dart developer should be able to benefit.

Goal and structure

To be filled in...

Subtasks

The following is an incomplete and in progress list, but groups some related tasks and issues. In no way do each of these have to be resolved as part of this, but they're included here to not get lost or help inspire ideas.

Introduce developers to interoperability and help them determine next steps

Teach developers how to interop with native platforms

[ ] https://github.com/dart-lang/site-www/issues/3084
[ ] https://github.com/dart-lang/sdk/issues/54505
[ ] Overhaul existing FFI documentation for new site standards
[ ] Separate standard ffi docs from ffigen docs
[ ] Separate reference material from guides
[ ] Provide better guidance on interacting with Dart code from the native side
[ ] Help Flutter developers understand when to use ffi vs pigeon

Help developers publish packages and plugins that use native interop

[ ] https://github.com/dart-lang/site-www/issues/5388
[ ] Provide an end-to-end example of building and publishing a package

Teach developers how to use and/or migrate to Dart's new JS static interop

[x] https://github.com/dart-lang/site-www/issues/5438
[x] https://github.com/dart-lang/site-www/issues/4177
[x] https://github.com/dart-lang/site-www/issues/5478
[ ] Help developers use JS interop with non-web targets

Document the Wasm platform and any relevant interop functionality

[ ] https://github.com/dart-lang/site-www/issues/5609
[ ] Explain Wasm support status and limitations
[ ] Clarify support is for compiling to Wasm, not running
[ ] Document how to interop with web/JS
[ ] Add examples for interacting with Dart from Wasm source

Provide some guidelines and best practices for developers

[ ] Put more emphasis on generating any bindings
[ ] https://github.com/dart-lang/site-www/issues/3193
[ ] https://github.com/dart-lang/sdk/issues/33920
[ ] Document some common issues to look out for

dart-lang / site-www