I created this desktop application to be able to show how Flutter Desktop applications are working. It is directly embedded inside the Flutter Desktop project. You may find the detailed information in the following official documentation from Flutter Team.
This presentation covers core animation concepts from Flutter and how to create them.
If something is not clear or if you do not understand something please create an issue or send me a DM over Twitter
- Main project is the droidkaigi folder in the example project's lib folder.
- For running on macos, simply run the xcode project in the example project and run it from there.
- You may attach the attacher with
$ flutter attach --device-id=flutter-tester --debug-port=<port-number>
command over terminal
The purpose of this project is to support building applications that use Flutter on Windows, macOS, and Linux.
It consists of libraries that implement Flutter's embedding API, handling drawing and mouse/keyboard input, as well as optional plugins to access other native platform functionality.
If you have an existing Flutter app and just want to get it running, see the quick start page before continuing.
The tooling and build infrastructure for this project requires that you have a Flutter tree in the same parent directory as the clone of this project:
<parent dir>
├─ flutter (from https://github.com/flutter/flutter)
└─ flutter-desktop-embedding (from https://github.com/google/flutter-desktop-embedding)
Alternately, you can place a .flutter_location_config
file in the directory
containing flutter-desktop-embedding, containing a path to the Flutter tree to
use, if you prefer not to have the Flutter tree next to
flutter-desktop-embedding.
The library
directory contains the core embedding library code. See the
README there for information on building and using it.
The example
directory contains an example application built using the library
for each platform. If you just want to see something running, or want to see
an example of how to use the library, start there.
In addition, there is:
plugins
: Plugins which provide access to additional platform functionality. These follow a similar structure to Flutter plugins. See the README for details.third_party
: Dependencies used by this repository, beyond Flutter itself.tools
: Tools used in the development process. Currently these are used by the build systems, but in the future developer utilities providing some functionality similar to theflutter
tool may be added.
Since desktop is not a supported platform for Flutter, be sure to read the Flutter application requirements document for important information about how to set up your Flutter application for use with this library.
Debugging of the Flutter side of a desktop application is possible, but requires a modified workflow.
To debug the Flutter engine, you can use a local engine build.
For bug reports and specific feature requests, you can file GitHub issues. For general discussion and questions there's a project mailing list.
When submitting issues related to build errors or other bugs, please make sure to include the git hash of the Flutter checkout you are using. This will help speed up the debugging process.
- This is not an officially supported Google product.
- This is an exploratory effort, and is not part of the Flutter project. See the Flutter FAQ for Flutter's official stance on desktop development.
- Many features that would be useful for desktop development do not exist yet.
Check the
plugins
directory for support for native features beyond drawing and event processing. If the feature you need isn't there, file a feature request, or write a plugin! - The Linux and Windows implementations currently use GLFW. This is not going to be the final implementation for either platform.