updater

type Installer ¶

type Installer interface {
	InstallUpdate(*semver.Version, io.Reader) error
}

type InstallerDefault ¶

type InstallerDefault struct {
	// contains filtered or unexported fields
}

func NewInstaller(versioner *versioner.Versioner) *InstallerDefault

func (i *InstallerDefault) InstallUpdate(version *semver.Version, r io.Reader) error

type Settings ¶

type Settings interface {
	Get(string) string
	Set(string, string)
	GetFloat64(string) float64
}

type UpdateChannel ¶

type UpdateChannel string

UpdateChannel represents an update channel users can be subscribed to.

const (
	// StableChannel is the channel all users are subscribed to by default.
	StableChannel UpdateChannel = "stable"

	// EarlyChannel is the channel users subscribe to when they enable "Early Access".
	EarlyChannel UpdateChannel = "early"
)

type Updater ¶

type Updater struct {
	// contains filtered or unexported fields
}

func New(
	cm pmapi.Manager,
	installer Installer,
	s Settings,
	kr *crypto.KeyRing,
	curVer *semver.Version,
	updateURLName, platform string,
) *Updater

func (u *Updater) CanInstall(version VersionInfo) bool

func (u *Updater) Check() (VersionInfo, error)

func (u *Updater) InstallUpdate(update VersionInfo) error

func (u *Updater) IsDowngrade(version VersionInfo) bool

func (u *Updater) IsUpdateApplicable(version VersionInfo) bool

type VersionInfo ¶

type VersionInfo struct {
	// Version is the semantic version of the release.
	Version *semver.Version

	// MinAuto is the earliest version that is able to autoupdate to this version.
	// Apps older than this version must run the manual installer and cannot autoupdate.
	MinAuto *semver.Version

	// Package is the location of the update package.
	Package string

	// Installers are the locations of installer files (for manual installation).
	Installers []string

	// LandingPage is the address of the app landing page on protonmail.com.
	LandingPage string

	// ReleaseNotesPage is the address of the page containing the release notes.
	ReleaseNotesPage string

	// RolloutProportion indicates the proportion (0,1] of users that should update to this version.
	RolloutProportion float64
}

VersionInfo is information about one version of the app.

type VersionMap ¶

type VersionMap map[string]VersionInfo

VersionMap represents the structure of the version.json file. It looks like this:

{
  "stable": {
    "Version": "2.3.4",
    "Package": "https://protonmail.com/.../bridge_2.3.4_linux.tgz",
    "Installers": [
      "https://protonmail.com/.../something.deb",
      "https://protonmail.com/.../something.rpm",
      "https://protonmail.com/.../PKGBUILD"
    ],
    "LandingPage": "https://protonmail.com/bridge",
    "ReleaseNotesPage": "https://protonmail.com/.../release_notes.html",
    "RolloutProportion": 0.5
  },
  "early": {
    "Version": "2.4.0",
    "Package": "https://protonmail.com/.../bridge_2.4.0_linux.tgz",
    "Installers": [
      "https://protonmail.com/.../something.deb",
      "https://protonmail.com/.../something.rpm",
      "https://protonmail.com/.../PKGBUILD"
    ],
    "LandingPage": "https://protonmail.com/bridge",
    "ReleaseNotesPage": "https://protonmail.com/.../release_notes.html",
    "RolloutProportion": 0.5
  },
  "...": {
    ...
  }
}.