impeller-sdk

Packaged standalone Impeller SDK artifacts from Flutter.

This repo normalizes the SDK layout and publishes it in two forms:

• sdk/: combined SDK tree in the repository, useful for browsing or direct use.
• GitHub Releases: per-platform archives for package managers and CI.

Repository sdk/ layout:

• include/impeller.h
• lib/<os>/<arch>/...
• upstream SDK README / license when available

Release archive layout:

• include/impeller.h
• lib/...
• Zig package metadata

Zig metadata is included only for lazy package consumption.

Other bindings can use the Release assets or sdk/ directly. Zig wrappers live in impeller-zig.

Zig Usage

This package exports SDK paths for Zig packages that build bindings:

const sdk_dep = b.dependency("impeller_sdk", .{
    .target = target,
});

const header = sdk_dep.namedLazyPath("impeller_header");
const include_dir = sdk_dep.namedLazyPath("impeller_include");
const lib_dir = sdk_dep.namedLazyPath("impeller_lib_dir");
const runtime_library = sdk_dep.namedLazyPath("impeller_library");

On Windows, impeller_import_library is also exported for linking.

Only the required platform archive is downloaded.

The repository sdk/ directory is not included in Zig package fetches.

Application-level Zig bindings and build helpers live in impeller-zig.

Package SDK Assets

Run manually:

python3 tools/package_sdk.py --out dist --sdk sdk --zon build.zig.zon

CI also runs daily and updates sdk/, build.zig.zon, and Release assets when Flutter publishes a new SDK.