Struct Esp32Backend 

pub struct Esp32Backend { /* private fields */ }

Configuration for the ESP32 backend in a WaterUI project.

[backends.esp32] in Water.toml

Implementations

impl Esp32Backend

pub fn new() -> Self

Create a new ESP32 backend configuration with default settings.

pub fn with_project_path(self, path: impl Into<PathBuf>) -> Self

Set a custom project path (defaults to “esp32”).

pub fn with_chip(self, chip: Esp32Chip) -> Self

Set the target chip, returning the updated configuration.

pub const fn project_path(&self) -> &PathBuf

Get the path to the ESP32 harness project within the WaterUI project.

pub fn chip(&self) -> &str

Get the configured target chip identifier (e.g. “esp32s3”).

pub fn resolved_chip(&self) -> Result<Esp32Chip>

Parse the configured chip into an Esp32Chip.

Errors

Returns an error when the configured chip string is not a supported ESP32 chip.

pub fn template_entry( &self, project_root: &Path, harness_fonts_dir: &Path, ) -> Result<Esp32TemplateEntry>

Get the harness parameters substituted into generated templates.

Font paths are resolved against project_root so the generated harness can include_bytes! them from wherever it lives. When font_ranges is configured, each font is subset to those ranges into harness_fonts_dir and the subset file is embedded instead.

Errors

Returns an error when the configured chip string is not a supported ESP32 chip, when a configured font file does not exist, or when subsetting fails.

pub fn requires_regeneration(project: &Project) -> Result<bool>

Check whether generated ESP32 harness files should be regenerated.

This is used by playground mode where backend glue code is fully managed by the CLI.

Errors

Returns an error when the harness Cargo.toml exists but cannot be parsed.

Trait Implementations

impl Backend for Esp32Backend

const DEFAULT_PATH: &'static str = "esp32"

The default relative path for this backend (e.g., “android”, “apple”).

const CACHE_PATHS: &'static [&'static str]

Paths relative to the backend directory that should be preserved during re-scaffolding.

fn path(&self) -> &Path

Get the relative path for this backend instance.

async fn init(project: &Project) -> Result<Self, FailToInitBackend>

Initialize the backend for the given project.

fn supports(&self, platform: TargetPlatform) -> bool

Check if this backend supports the given platform.

async fn build( &self, project: &Project, platform: TargetPlatform, options: BuildOptions, ) -> Result<PathBuf>

Build the Rust library for the target platform.

async fn package( &self, project: &Project, platform: TargetPlatform, options: PackageOptions, ) -> Result<Artifact>

Package the project for the target platform.

async fn clean( &self, project: &Project, _platform: TargetPlatform, ) -> Result<()>

Clean build artifacts for the platform.

impl Clone for Esp32Backend

fn clone(&self) -> Esp32Backend

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Esp32Backend

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Esp32Backend

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Esp32Backend

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Esp32Backend

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.