Google Git
Sign in
flutter / mirrors / engine / 5b9d2132b7cd78b682424a31f17490fe777ba28f
commit5b9d2132b7cd78b682424a31f17490fe777ba28f[log] [tgz]
authorJackson Gardner <jacksongardner@google.com>Tue Jan 09 16:17:32 2024 -0800
committerGitHub <noreply@github.com>Wed Jan 10 00:17:32 2024 +0000
tree731575ad65600c83df2e7330ad42c60c762837e4
parent941f268fc8bb99b07c39fa73b1c09ef05b05b610 [diff]
Refactor flutter.js to do dart2wasm bootstrapping and CanvasKit/Skwasm preloading. (#49037)

This PR makes some major revisions to our flutter.js bootstrapper.
* Modularize flutter.js into multiple files to make it a little simpler to manage from source code. They are still bundled into a single .js file by esbuild.
* Added a `types.d.ts` file which contains declarations of the types of some of the objects used in the flutter.js API
* Deprecated the old `FlutterLoader.loadEntrypoint` API and added a new function simply called `FlutterLoader.load`, which has a few more capabilities:
  -  A build tool can inject a build config, that may describe multiple builds that `FlutterLoader.load` can attempt to use. It will use the first one that is compatible with the browser environment and the user's configuration.
  - It can also load wasm flutter apps.
  - It also pre-loads and instantiates CanvasKit (and Skwasm) as necessary depending on the build configuration.
  - `FlutterLoader.load` also immediately takes a flutter configuration object. If an `onEntrypointLoaded` callback is not provided by the user, it just does the expected thing and initializes the engine and immediately starts the app, passing the configuration along as needed.
 * `flutter.js` has the engine hash built into it now, which allows it to ascertain the correct CDN URLs for both CanvasKit and Skwasm.
33 files changed
tree: 731575ad65600c83df2e7330ad42c60c762837e4
  1. .github/
  2. assets/
  3. benchmarking/
  4. build/
  5. ci/
  6. common/
  7. display_list/
  8. docs/
  9. examples/
  10. flow/
  11. flutter_frontend_server/
  12. flutter_vma/
  13. fml/
  14. impeller/
  15. lib/
  16. runtime/
  17. shell/
  18. skia/
  19. sky/
  20. testing/
  21. third_party/
  22. tools/
  23. vulkan/
  24. wasm/
  25. web_sdk/
  26. .ci.yaml
  27. .clang-format
  28. .clang-tidy
  29. .gitattributes
  30. .gitignore
  31. .pylintrc
  32. .style.yapf
  33. analysis_options.yaml
  34. AUTHORS
  35. BUILD.gn
  36. CODEOWNERS
  37. CONTRIBUTING.md
  38. DEPS
  39. Doxyfile
  40. LICENSE
  41. README.md
README.md

Flutter Engine

Flutter CI Status OpenSSF Scorecard SLSA 1

Flutter is Google's SDK for crafting beautiful, fast user experiences for mobile, web, and desktop from a single codebase. Flutter works with existing code, is used by developers and organizations around the world, and is free and open source.

The Flutter Engine is a portable runtime for hosting Flutter applications. It implements Flutter's core libraries, including animation and graphics, file and network I/O, accessibility support, plugin architecture, and a Dart runtime and compile toolchain. Most developers will interact with Flutter via the Flutter Framework, which provides a modern, reactive framework, and a rich set of platform, layout and foundation widgets.

If you want to run/contribute to Flutter Web engine, more tooling can be found at felt. This is a tool written to make web engine development experience easy.

If you are new to Flutter, then you will find more general information on the Flutter project, including tutorials and samples, on our Web site at Flutter.dev. For specific information about Flutter's APIs, consider our API reference which can be found at the docs.flutter.dev.

Flutter is a fully open source project, and we welcome contributions. Information on how to get started can be found at our contributor guide.