Struct UpdateSettings 

#[repr(C)]
pub struct UpdateSettings {
    pub mode: UpdateMode,
    pub manifest_url: OptionString,
    pub current_version: AzString,
    pub app_name: AzString,
    pub build_date: AzString,
    pub build_tag: AzString,
    pub channel: AzString,
    pub root_public_key: AzString,
}

Update configuration, part of AppConfig. With manifest_url unset every check reports an error naming this field — nothing phones home unless the app points it somewhere.

Fields

mode: UpdateMode

Requested behaviour; clamped by the detected install kind at runtime.

manifest_url: OptionString

URL of the update manifest (JSON: {"latest": {"version", "download_url", "changelog_md", "digest"}}). None = update checks disabled.

current_version: AzString

The RUNNING version, compared against the manifest’s latest.version (dotted-numeric compare). Apps typically pass env!("CARGO_PKG_VERSION").

app_name: AzString

Directory-safe application name; keys the updater’s state directory ({data_dir}/{app_name}/update-state.json) and the staging area.

build_date: AzString

RESERVED: the build’s date, compiled in by the APP (e.g. a build script stamping env!("BUILD_DATE")). The engine only carries it — into telemetry resources, crash dumps and update checks.

build_tag: AzString

RESERVED: the build’s VCS tag (or commit), compiled in by the APP. Same carriage as build_date.

channel: AzString

The RELEASE CHANNEL this binary follows: stable (the default when empty), beta, nightly, or whatever names the publisher uses. Compiled in, so a nightly build cannot be talked onto the stable track by a manifest: the binary decides which channel it reads, the publisher decides what is in it.

root_public_key: AzString

Base64 minisign ROOT public key, compiled in by the APP. Non-empty arms the update SIGNATURE CHAIN: the manifest must then carry a root-signed signing-key statement and an artifact signature, and an unsigned release is a hard error instead of a fallback. Empty (the default) = digest verification only.

Trait Implementations

impl Clone for UpdateSettings

fn clone(&self) -> UpdateSettings

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UpdateSettings

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

Formats the value using the given formatter.

impl Default for UpdateSettings

fn default() -> Self

Returns the “default value” for a type.

impl Eq for UpdateSettings

impl Hash for UpdateSettings

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for UpdateSettings

fn cmp(&self, other: &UpdateSettings) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for UpdateSettings

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for UpdateSettings

fn partial_cmp(&self, other: &UpdateSettings) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for UpdateSettings