Files
emb_cli/example
Joel Winarske 0cc9bfe244 feat: auto-resolve PackageKit native bridge; use hosted packagekit_dart
- Depend on the published `packagekit_dart ^0.3.2` instead of a path
  dependency.
- native_lib.dart: locate `libpackagekit_nc.so` from the package's own build
  or, for hosted installs, the `package:hooks` build-hook output under
  `.dart_tool/`, so the Linux backend works without `PK_NC_LIB`.
- docs: full per-command README reference (every option, default, value set);
  add `example/`; refresh CHANGELOG.
- chore: whitelist `Kitware`, `armv`, `armhf` for cspell.

Signed-off-by: Joel Winarske <joel.winarske@gmail.com>
2026-06-15 20:31:01 -07:00
..

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