Xila

Appearance

Build a guest application ​

Compile an application for Xila's WASI runtime. The application target is wasm32-wasip1; wasm32-unknown-unknown is used for the browser example and guest-library checks.

Before you begin ​

Use a configured development environment with the WASI target installed. In a manual Rust setup, run rustup target add wasm32-wasip1 for the toolchain you use. Graphical bindings also require the native binding-generation tools.

Build an existing application ​

From Core's root, inside its Devbox shell:

bash
cargo build -p calculator --target wasm32-wasip1 --release

Use the package name of your application for other workspace guests. Keep Calculator's artifact in the default target directory if you are building the browser example.

Add graphics bindings ​

For a separate Rust application workspace, select the wasm package and disable the default host interpreter:

toml
[dependencies]
wasm = { git = "https://github.com/Xila-Project/Core.git", default-features = false, features = ["guest", "graphics", "memory_32"] }

Use default_guest instead if you need the C wrappers and generated xila_graphics.h header. Match guest and host LVGL revisions/configuration and use the supported graphics bindings. Standard WASI guests can use the implemented WASI imports without Xila graphics wrappers.

Core's xila package has no wasm feature. Command guests require _start: () -> (); optional installers require __install: () -> ().

Verify completion ​

The build should exit successfully and produce target/wasm32-wasip1/release/calculator.wasm for the Calculator example. Compilation does not verify runtime compatibility: run the guest in Xila to check its actual behavior.

Rebuild Calculator before rebuilding the browser example whenever the guest changes. It is embedded at browser build time.