mirror of
https://github.com/toyota-connected/emb_cli.git
synced 2026-06-21 07:19:37 -07:00
Joel Winarske
109075fbe3
There was no committed emb.yaml with a deps: block. Add one and document the schema. - example/ivi-homescreen/emb.yaml: a self-describing package with a real deps: block (graphics build deps for fedora/ubuntu/macos) alongside a build: block. - README: a 'Host dependencies (deps:)' section — the OS/distro schema, list-vs-map semantics, WhatProvides name resolution, the legacy configs/*.json schema, and an 'emb deps --packages example --dry-run'. - test: load the committed example and assert deps resolve to the right packages per host (fedora/ubuntu/macos), excluding other hosts' names. Signed-off-by: Joel Winarske <joel.winarske@gmail.com>
emb examples
emb is a CLI. Install it, then run the commands below. See the
top-level README for the full command/flag reference.
# from the package root
dart pub get
dart pub global activate --source=path . # puts `emb` on PATH
# or run without activating: dart run bin/emb.dart <command>
1. Inspect the host
emb doctor
Host
os: linux
arch: x86_64 (flutter: x64, engine: x86_64)
host type: fedora
version: 43
Package backend
selected: packagekit
✓ packagekit is available
2. Provision a workspace
Installs host dependencies (one transaction), clones repos, installs the
Flutter SDK, and fetches the prebuilt engine — then writes setup_env.sh.
emb setup --config ../configs --yes
. ./setup_env.sh # Flutter/Dart on PATH, FLUTTER_WORKSPACE, …
Run phases individually if you prefer: emb deps, emb sync, emb flutter,
emb engine.
3. Build an ivi-homescreen bundle
# Release AOT bundle for a Raspberry Pi (arm64), cross-compiled from x86_64:
emb bundle --app-path ./app/my_app --arch arm64 --build
# Debug (JIT) bundle for the host:
emb bundle --app-path ./app/my_app --mode debug --build
The bundle directory (data/flutter_assets, data/icudtl.dat,
lib/libflutter_engine.so, and lib/libapp.so for profile/release) is what
ivi-homescreen runs:
ivi-homescreen --b=<workspace>/bundle/my_app-release-arm64
4. Self-describing packages
A package that ships an emb.yaml (or an emb: key in pubspec.yaml) builds
itself with no flags:
emb build ./app/my_app # builds the manifest's arch × mode matrix