Struct DesktopConfig 

pub struct DesktopConfig {
    pub app_name: Option<String>,
    pub app_id: Option<String>,
    pub window_icon: Option<IconData>,
    pub menu_spec: Option<MenuSpec>,
    pub quit_on_last_window_closed: bool,
    pub initial_size: Option<Size>,
    pub min_size: Option<Size>,
    pub max_size: Option<Size>,
    pub persist_window_state: bool,
}

The desktop app’s identity and native-integration vocabulary, re-exported from the desktop core so app code never names a shell crate: DesktopConfig (the whole declaration — app name, reverse-DNS id, window icon, menu bar, last-window-close policy — handed to App::desktop, run_desktop_config or app!’s desktop = { .. } argument), MenuSpec/MenuItemSpec/MenuRole (the platform-independent native menu tree a per-OS shell translates into an NSApp menu bar or an HMENU), DesktopIconData (decoded, tightly-packed RGBA8 — decoding a PNG/ICO/ICNS is the caller’s job), and DEFAULT_APP_NAME (the window title a config that names nothing still gets).

frust-shell-desktop‘s IconData is re-exported renamed: the facade already carries frust-widgets’ IconData, an in-UI vector icon, and the two are unrelated (one is a BezPath a widget paints, the other is the window/taskbar bitmap the OS shows). The Desktop prefix matches DesktopConfig, whose with_window_icon is its only consumer.

use frust::{DesktopConfig, MenuItemSpec, MenuRole, MenuSpec};

let file = MenuSpec::new()
    .with_item(MenuItemSpec::item("file.open", "Open…").with_accelerator("CmdOrCtrl+O"))
    .with_item(MenuItemSpec::separator())
    .with_item(MenuItemSpec::role(MenuRole::Quit));

let config = DesktopConfig::new()
    .with_app_name("Huddle")
    .with_app_id("dev.frust.huddle")
    .with_menu_spec(MenuSpec::new().with_item(MenuItemSpec::submenu("File", file)));

Desktop-only, unlike the menu_events read side: these types are defined in frust-shell-desktop, which is not in a mobile build’s or a wasm32 build’s dependency graph at all (see this crate’s Cargo.toml). Code shared with a mobile or wasm32 target keeps a DesktopConfig behind its own #[cfg(not(any(target_os = "android", target_os = "ios", target_arch = "wasm32")))] — or, more simply, writes it inline in app!’s desktop = { .. } argument, which the macro already emits only on the targets that have it. The desktop app’s identity and native-integration configuration.

Built by the facade from an app’s own declaration and handed to run_desktop_with; every field is optional and the Default value is today’s dev-preview behavior (see the module docs).

PartialEq but not Eq: the size fields are f64-backed Sizes.

Fields

app_name: Option<String>

The app’s display name: the window title, and (for the per-OS shells) the name a macOS menu bar’s application menu shows. None falls back to DEFAULT_APP_NAME for the title — see DesktopConfig::window_title.

app_id: Option<String>

The app’s reverse-DNS identifier (com.example.myapp). Carried, never consumed by the shared core: the Linux shell turns it into a Wayland app_id/X11 WM_CLASS so the window pairs with its .desktop entry, and the Windows shell into an AppUserModelID so taskbar grouping and notifications attribute correctly.

window_icon: Option<IconData>

The window/taskbar icon as platform-independent RGBA (see IconData). Carried for the per-OS shells; the shared core never attaches it, since winit’s own WindowAttributes::with_window_icon reaches X11 and Windows only and macOS wants an application icon rather than a window one.

menu_spec: Option<MenuSpec>

The native menu bar to install, if any (see MenuSpec). Carried for the per-OS shells that can build one; a platform with no native menu (Linux, where the menu is widget-drawn) simply ignores it.

quit_on_last_window_closed: bool

Whether closing the last window quits the app.

Carried, not consumed by the shared core: with no extension installed a close request always exits the event loop (today’s behavior, and what true means anyway). It exists for the macOS shell, where the platform convention is for an app to stay running with no window until ⌘Q — see DesktopExtensions::on_close_requested.

initial_size: Option<Size>

The window’s initial inner size in logical pixels, or None for the shell default (800×600). A persisted window state and the FRUST_WINDOW_SIZE measurement knob both take precedence over it.

min_size: Option<Size>

The smallest inner size, in logical pixels, the user can resize the window to. Also clamps a restored window state.

max_size: Option<Size>

The largest inner size, in logical pixels, the user can resize the window to. Also clamps a restored window state.

persist_window_state: bool

Whether the window’s size, position and maximized state are saved to the user’s data directory and restored on the next launch. Opt-in (false by default); a restored position that no longer lands on any connected monitor is dropped and the OS places the window instead.

Implementations

impl DesktopConfig

pub fn new() -> DesktopConfig

A config that reproduces today’s zero-config preview window (see Default).

pub fn with_app_name(self, app_name: impl Into<String>) -> DesktopConfig

Set the app’s display name (the window title).

pub fn with_app_id(self, app_id: impl Into<String>) -> DesktopConfig

Set the app’s reverse-DNS identifier.

pub fn with_window_icon(self, icon: IconData) -> DesktopConfig

Set the window/taskbar icon.

pub fn with_menu_spec(self, menu_spec: MenuSpec) -> DesktopConfig

Set the native menu bar to install.

pub fn with_quit_on_last_window_closed(self, quit: bool) -> DesktopConfig

Set whether closing the last window quits the app.

pub fn with_initial_size(self, size: impl Into<Size>) -> DesktopConfig

Set the window’s initial inner size, in logical pixels (see initial_size).

pub fn with_min_size(self, size: impl Into<Size>) -> DesktopConfig

Set the window’s minimum inner size, in logical pixels.

pub fn with_max_size(self, size: impl Into<Size>) -> DesktopConfig

Set the window’s maximum inner size, in logical pixels.

pub fn with_persist_window_state(self, persist: bool) -> DesktopConfig

Opt in to (or out of) saving and restoring the window’s geometry across launches (see persist_window_state).

pub fn window_title(&self) -> &str

The title to give the preview window: the configured app_name, else DEFAULT_APP_NAME.

The fallback lives here rather than in the field itself so a per-OS shell can still tell “the app named itself Frust” apart from “the app named itself nothing” — a macOS menu bar wants the real name or no application menu at all, not a placeholder.

Trait Implementations

impl Clone for DesktopConfig

fn clone(&self) -> DesktopConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DesktopConfig

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

Formats the value using the given formatter.

impl Default for DesktopConfig

fn default() -> DesktopConfig

Hand-written rather than derived because quit_on_last_window_closed defaults to true — the shell’s existing unconditional event_loop.exit() on CloseRequested.

impl PartialEq for DesktopConfig

fn eq(&self, other: &DesktopConfig) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for DesktopConfig