Expand description
Typed application update discovery, verification, and platform installation.
An update is the one download an application performs that can replace the application, so what arrives is checked against what was promised before it reaches a platform installer. The check lives here, once, rather than in each platform’s installer: a digest computed four different ways is four chances to compute it wrongly, and one of them will be the one nobody tested.
Structs§
- AppUpdate
Capabilities - What an update backend can do on this platform.
- AppUpdate
Observer - Registration returned by
observe_app_update_status. - Digest
Verifier - Checks a package as it is read, so a package too large to hold in memory is still checked.
- GitHub
Release Update - A GitHub release feed used to discover an application package.
- Package
Digest - The digest a downloaded package must match.
- Update
Package - A package an update would install.
Enums§
- AppUpdate
Error - Failure to start an update operation.
- AppUpdate
Status - Observable state of the application update flow.
- Digest
Algorithm - How a package’s bytes are checked against what the release promised.
Traits§
- AppUpdater
- Platform implementation for update discovery and package installation.
Functions§
- app_
update_ capabilities - What this host can do about application updates.
- app_
update_ checks_ supported - Returns whether this host can discover a newer release.
- app_
update_ status - Returns the latest update state.
- app_
updates_ supported - Returns whether this host can install application updates.
- check_
for_ app_ update - Starts update discovery and publishes the initial state.
- clear_
platform_ app_ updater - Removes the platform updater.
- install_
app_ update - Starts package installation and publishes the initial transfer state.
- observe_
app_ update_ status - Observes update state changes. The current state is delivered immediately.
- set_
app_ update_ status - Publishes state from a platform updater.
- set_
platform_ app_ updater - Installs the platform updater.
- sha256_
hex - The SHA-256 of
bytes, as lower-case hexadecimal. - verify_
package - Checks a package held in memory against
digest.
Type Aliases§
- AppUpdater
Ref - Shared updater service.