Struct LaunchSpec 

pub struct LaunchSpec { /* private fields */ }

How the standard lifecycle launches one application definition: its component host, capture scenarios, commands and accepted arguments.

Implementations

impl LaunchSpec

pub fn runtime_attachment(self, policy: fn(&LaunchArgs) -> bool) -> LaunchSpec

Select automatic runtime attachment for native launches. The default is enabled. Disabling bootstrap does not revoke inherited service handles; privacy-sensitive apps must also construct a local-only application.

pub fn attaches_runtime(&self, args: &LaunchArgs) -> bool

Whether a native launch with args attaches to the session runtime.

pub fn from_definition(definition: &'static ApplicationDefinition) -> LaunchSpec

Adapt one common application definition. A runner must install an explicit host.

pub fn definition(&self) -> &'static ApplicationDefinition

The application this specification launches.

pub fn app_id(&self) -> &'static str

The id of the app this specification launches.

pub fn component_host( self, prepare: fn(&ApplicationDefinition, &LaunchArgs) -> Result<PreparedComponentInputs, LaunchError>, ) -> LaunchSpec

pub fn native_services(self) -> LaunchSpec

Use the shared native system-service runner for a prepared application. Service discovery happens only when opening a window, after preparation; captures, audits and headless driving retain their explicit isolation.

pub fn capture_scenario( self, scenario: fn(&mut FrameHarness, &LaunchArgs) -> Result<(), LaunchError>, ) -> LaunchSpec

Apply capture-only interactions after the normal factory and restoration. Never runs for live/headless launches or native certification audits.

pub fn prepare_hosted( &self, args: &LaunchArgs, ) -> Result<PreparedComponentInputs, LaunchError>

What a launch with args opens, prepared by the specification’s component host but not instantiated: the record, the profile it lives in and what the host hands the component.

Errors

Returns argument, profile or record failures, or LaunchError::MissingComponentHost.

pub fn prepare_component( &self, args: &LaunchArgs, context: HostContext, target: LaunchTarget, restore: RestoreInput, ) -> Result<AppComponent, LaunchError>

Prepare this definition using already authenticated host inputs.

Errors

Returns argument, capability, binding, factory, or restoration failures.

pub fn shot_viewport(self, factory: fn(&LaunchArgs) -> (u32, u32)) -> LaunchSpec

Scenario-specific default viewport. An explicit --viewport always wins over this callback.

pub fn command_handler( self, handler: fn(&LaunchArgs) -> Result<bool, LaunchError>, ) -> LaunchSpec

Handle an app-specific, non-windowed command after argument validation. Return true when the command was handled and launch should stop.

This keeps developer utilities such as fixture generation and benchmark drivers in the standard parser without making them part of the normal screenshot or live-window lifecycle. A component’s in-process hosts never run it: commands belong to the app’s own process.

pub fn disable_headless(self) -> LaunchSpec

Reject headless input driving for apps whose widgets have privileged side effects, such as an on-screen keyboard that injects keystrokes into another application.

pub fn allowed_flags(self, flags: &'static [&'static str]) -> LaunchSpec

Allow app-specific boolean flags. Value-taking common options belong in LaunchArgs; specialized CLIs should use the lower-level APIs.

pub fn allowed_options(self, options: &'static [&'static str]) -> LaunchSpec

Allow app-specific, value-taking options in both --name value and --name=value form. Their values are available through LaunchArgs::value.

pub fn allowed_live_flags(self, flags: &'static [&'static str]) -> LaunchSpec

Allow boolean flags in live/headless mode as well as screenshot mode.

pub fn allowed_live_options( self, options: &'static [&'static str], ) -> LaunchSpec

Allow value-taking options in live/headless mode as well as screenshots.

pub fn max_positionals(self, max: usize) -> LaunchSpec

Accept at most max positional document/session arguments.

pub fn scenarios(self, scenarios: &'static [&'static str]) -> LaunchSpec

Declare every accepted screenshot scenario. With no declaration, --scenario is rejected instead of being silently ignored.

Trait Implementations

impl Clone for LaunchSpec

fn clone(&self) -> LaunchSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.