Workspace Automation that supports embedded Flutter development
We developed a Python script, flutter_workspace.py
to automate embedded flutter setup.
This script reads a configuration folder of JSON files, or a single JSON configuration file and sets up a Flutter Workspace.
Discord Server https://discord.gg/VKcpSHgjGQ
create AOT is used to create libapp.so for use on a device.
Example use:
./create_aot --path <path that holds a pubspec.yaml>
Expects to be run from an active FLUTTER_WORKSPACE. Meaning you need to source you environment first.
-
GEN_SNAPSHOT - (Required) Set GEN_SNAPSHOT to location of executable gen_snapshot
-
PUB_CACHE - Set using
source ./setup_env.sh
-
FLUTTER_WORKSPACE - Set using
source ./setup_env.sh
-
FLUTTER_BUILD_ARGS - Defaults to 'bundle'
-
LOCAL_ENGINE_HOST - Defaults to f'{flutter_sdk}/bin/cache/artifacts/engine/common'
-
APP_GEN_SNAPSHOT_FLAGS
-
APP_GEN_SNAPSHOT_AOT_FILENAME - Defaults to 'libapp.so.{runtime_mode}'
-
FLUTTER_PREBUILD_CMD
flutter_workspace.py does the following tasks automatically for you
- Establishes a workspace of known state
- Sync repos into app folder
- .vscode debug launcher file
- Flutter SDK
- Flutter runtime=debug engine
- Loads platform types
- QEMU, Docker, Remote, Host, Generic
- Each type uses a specific configuration
- Create setup_env.sh
- Tested on Linux and Mac
- Ubuntu 20 (x86_64)
- Ubuntu 22 (x86_64)
- Fedora 37 (x86_64)
- Mac M1/M2 (arm64)
A Flutter workspace contains
- Flutter SDK
- flutter
- Development Repositories (app)
- app
- Host Runtime images
- .config/flutter_workspace/
- flutter-auto binary
- app/ivi-homescreen/build
- QEMU image
- .config/flutter_workspace//)
- Versioned x86_64 libflutter_engine.so and icudtl.dat
- ./config/flutter_workspace/flutter-engine
- Custom-device configurations
- ./config/flutter_workspace/
- Public Cache
- .config/flutter_workspace/pub_cache
flutter_workspace_config.json contains the following components
- globals
- cookie_file
- netrc
- github_api
- repos
- git
- platform definition
git clone https://github.com/meta-flutter/workspace_automation.git
./flutter_workspace.py
Wipes workspace before creating
Pass configuration folder path.
Override config/_globals.json key "flutter_version"
Fetch libflutter_engine.so and update bundle cache
Pass folder for storing dart and engine json files.
Platform Load Exceptions. Pass platform-id values. Space is delimiter
Use for debugging
- Login via GDM Wayland Session
- Open Terminal and type
source ${FLUTTER_WORKSPACE}/setup_env.sh
- Navigate to your favorite app
flutter run -d desktop-auto
- Open Terminal and type
source ${FLUTTER_WORKSPACE}/setup_env.sh
- Type
qemu_run
- Wait until QEMU image reaches login prompt
- Run
ssh –p 2222 root@localhost who
to add remote host to ~/.ssh/known_hosts - Navigate to your favorite app
flutter run -run-qemu-master
- Login to Ubuntu desktop via Wayland Session
- Open Terminal and type
source ${FLUTTER_WORKSPACE}/setup_env.sh
cd ${FLUTTER_WORKSPACE}/app
flutter create hello_world -t app
cd hello_world
flutter run -d desktop-auto
cd <your flutter workspace>
source ./setup_env.sh
code .
flutter_workspace.py
creates a .vscode/launch.json
file if one is not present.
It uses the repo json key pubspec_path
. If this key is present in the repo
json, then it will add entry to .vscode/launch.json
.