Enum UpdateInstallState 

pub enum UpdateInstallState {
    Idle,
    Downloading {
        downloaded: u64,
        total: Option<u64>,
    },
    Verifying,
    Extracting,
    Installing,
    Completed {
        version: String,
        needs_gatekeeper_approval: bool,
    },
    Failed {
        message: String,
    },
}

Phase of an in-app update install, carried by UpdateStatusSnapshot and the update/installProgress notification.

Internally tagged so the wire form names its own phase ({"phase":"downloading","downloaded":10,"total":100}), which keeps a client from mislabeling a phase it did not expect.

Variants

Idle

No install has run, or the last one was superseded by a newer check.

Downloading

Downloading the release archive.

Fields

downloaded: u64

Bytes written so far.

total: Option<u64>

Total archive size when the server sent Content-Length; None otherwise, which renders as a byte count rather than a percentage.

Verifying

Checksum metadata resolved; hashing the downloaded archive.

Extracting

Unpacking the archive and staging the new bundle.

Installing

Replacing the installed bundle on disk.

Completed

The install finished.

Fields

version: String

Version now on disk.

needs_gatekeeper_approval: bool

The replaced bundle needs a one-time Gatekeeper approval before macOS launches it (ad hoc-signed builds): the client must say so instead of only prompting a restart. #[serde(default)] keeps older services decodable.

Failed

The install failed.

Fields

message: String

Sanitized reason; never a raw path or URL.

Implementations

impl UpdateInstallState

pub fn is_in_flight(&self) -> bool

Whether an install is currently in flight, so a client can disable the install action instead of starting a second concurrent one.

Trait Implementations

impl Clone for UpdateInstallState

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UpdateInstallState

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

Formats the value using the given formatter.

impl Default for UpdateInstallState

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for UpdateInstallState

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for UpdateInstallState

impl PartialEq for UpdateInstallState

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for UpdateInstallState

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for UpdateInstallState