Struct DefaultLauncher 

pub struct DefaultLauncher { /* private fields */ }

The default Launcher: relaunches with the library’s RESUME_FLAG and spawns a detached child process. Used unless UpdateManager::with_launcher installs a different one.

It can carry extra command-line arguments and environment variables through to the relaunched process, so the common cases need no custom Launcher:

use update_rs::DefaultLauncher;

let launcher = DefaultLauncher::new()
    .with_arg("--updated")
    .with_env("APP_UPDATING", "1");

Implementations

impl DefaultLauncher

pub fn new() -> Self

Create a default launcher with no extra arguments or environment variables.

pub fn with_arg(self, arg: impl Into<OsString>) -> Self

Append a custom argument to every relaunch, after the resume arguments. Call repeatedly to add several.

pub fn with_args<I, A>(self, args: I) -> Self

where I: IntoIterator<Item = A>, A: Into<OsString>,

Append several custom arguments to every relaunch.

pub fn with_env( self, key: impl Into<OsString>, value: impl Into<OsString>, ) -> Self

Set a custom environment variable on every relaunched process. Call repeatedly to set several.

pub fn with_envs<I, K, V>(self, envs: I) -> Self

where I: IntoIterator<Item = (K, V)>, K: Into<OsString>, V: Into<OsString>,

Set several custom environment variables on every relaunched process.

Trait Implementations

impl Clone for DefaultLauncher

fn clone(&self) -> DefaultLauncher

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DefaultLauncher

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

Formats the value using the given formatter.

impl Default for DefaultLauncher

fn default() -> DefaultLauncher

Returns the “default value” for a type.

impl Launcher for DefaultLauncher

fn extra_args(&self) -> Vec<OsString>

Extra command-line arguments to append to the relaunch command, after the resume_args.

fn extra_envs(&self) -> Vec<(OsString, OsString)>

Extra environment variables to set on the relaunched process (added to, not replacing, the inherited environment).

fn resume_args(&self, state_json: &str) -> Vec<OsString>

The arguments that carry the serialized resume state_json to the relaunched process.

fn launch(&self, app_path: &Path, state: &UpdateState) -> Result<(), Error>

Build and spawn the command that relaunches app_path to continue the update with state.

fn detach(&self, cmd: &mut Command)

Apply the platform-specific flags that detach the relaunched process from the current console so it survives the parent exiting (a detached process in its own group on Windows). A no-op on non-Windows platforms. Exposed so custom launch implementations can reuse it.

fn spawn(&self, cmd: Command) -> Result<(), Error>

Spawn the prepared Command. The default starts the child process and returns immediately. This is the single seam the default launch relies on, so tests can mock it.