electron updater.Class.PacmanUpdater

Electron-Builder / electron-updater / PacmanUpdater

Extends¶

LinuxUpdater

Constructors¶

new PacmanUpdater()¶

new PacmanUpdater(options?, app?): PacmanUpdater

Parameters¶

• options?: null | AllPublishOptions

• app?: AppAdapter

Returns¶

PacmanUpdater

Overrides¶

LinuxUpdater.constructor

Properties¶

_isUpdateSupported¶

protected _isUpdateSupported: VerifyUpdateSupport

Inherited from¶

LinuxUpdater._isUpdateSupported

_isUserWithinRollout¶

protected _isUserWithinRollout: VerifyUpdateSupport

Inherited from¶

LinuxUpdater._isUserWithinRollout

_logger¶

protected _logger: Logger = console

Inherited from¶

LinuxUpdater._logger

allowDowngrade¶

allowDowngrade: boolean = false

Whether to allow version downgrade (when a user from the beta channel wants to go back to the stable channel).

Taken in account only if channel differs (pre-release version component in terms of semantic versioning).

Default¶

false

Inherited from¶

LinuxUpdater.allowDowngrade

allowPrerelease¶

allowPrerelease: boolean = false

GitHub provider only. Whether to allow update to pre-release versions. Defaults to true if application version contains prerelease components (e.g. 0.12.1-alpha.1, here alpha is a prerelease component), otherwise false.

If true, downgrade will be allowed (allowDowngrade will be set to true).

Inherited from¶

LinuxUpdater.allowPrerelease

app¶

protected readonly app: AppAdapter

Inherited from¶

LinuxUpdater.app

autoDownload¶

autoDownload: boolean = true

Whether to automatically download an update when it is found.

Default¶

true

Inherited from¶

LinuxUpdater.autoDownload

autoInstallOnAppQuit¶

autoInstallOnAppQuit: boolean = true

Whether to automatically install a downloaded update on app quit (if quitAndInstall was not called before).

Default¶

true

Inherited from¶

LinuxUpdater.autoInstallOnAppQuit

autoRunAppAfterInstall¶

autoRunAppAfterInstall: boolean = true

Whether to run the app after finish install when run the installer is NOT in silent mode.

Default¶

true

Inherited from¶

LinuxUpdater.autoRunAppAfterInstall

currentVersion¶

readonly currentVersion: SemVer

The current application version.

Inherited from¶

LinuxUpdater.currentVersion

disableDifferentialDownload¶

disableDifferentialDownload: boolean = false

NSIS only Disable differential downloads and always perform full download of installer.

Default¶

false

Inherited from¶

LinuxUpdater.disableDifferentialDownload

disableWebInstaller¶

disableWebInstaller: boolean = false

Web installer files might not have signature verification, this switch prevents to load them unless it is needed.

Currently false to prevent breaking the current API, but it should be changed to default true at some point that breaking changes are allowed.

Default¶

false

Inherited from¶

LinuxUpdater.disableWebInstaller

downloadedUpdateHelper¶

protected downloadedUpdateHelper: null | DownloadedUpdateHelper = null

Inherited from¶

LinuxUpdater.downloadedUpdateHelper

forceDevUpdateConfig¶

forceDevUpdateConfig: boolean = false

Allows developer to force the updater to work in “dev” mode, looking for “dev-app-update.yml” instead of “app-update.yml” Dev: path.join(this.app.getAppPath(), "dev-app-update.yml") Prod: path.join(process.resourcesPath!, "app-update.yml")

Default¶

false

Inherited from¶

LinuxUpdater.forceDevUpdateConfig

fullChangelog¶

fullChangelog: boolean = false

GitHub provider only. Get all release notes (from current version to latest), not just the latest.

Default¶

false

Inherited from¶

LinuxUpdater.fullChangelog

previousBlockmapBaseUrlOverride¶

previousBlockmapBaseUrlOverride: null | string = null

The base URL of the old block map file.

When null, the updater will use the base URL of the update file to download the update. When set, the updater will use this string as the base URL of the old block map file. Some servers like github cannot download the old block map file from latest release, so you need to compute the old block map file base URL manually.

Default¶

null

Inherited from¶

LinuxUpdater.previousBlockmapBaseUrlOverride

quitAndInstallCalled¶

protected quitAndInstallCalled: boolean = false

Inherited from¶

LinuxUpdater.quitAndInstallCalled

requestHeaders¶

requestHeaders: null | OutgoingHttpHeaders = null

The request headers.

Inherited from¶

LinuxUpdater.requestHeaders

signals¶

readonly signals: UpdaterSignal

channel¶

get channel(): null | string

Get the update channel. Doesn’t return channel from the update configuration, only if was previously set.

set channel(value): void

Set the update channel. Overrides channel in the update configuration.

allowDowngrade will be automatically set to true. If this behavior is not suitable for you, simple set allowDowngrade explicitly after.

Parameters¶

• value: null | string

Returns¶

null | string

Inherited from¶

LinuxUpdater.channel

installerPath¶

get protected installerPath(): null | string

Sanitizies the installer path for using with command line tools.

Returns¶

null | string

Inherited from¶

LinuxUpdater.installerPath

isUpdateSupported¶

get isUpdateSupported(): VerifyUpdateSupport

Allows developer to override default logic for determining if an update is supported. The default logic compares the UpdateInfo minimum system version against the os.release() with semver package

set isUpdateSupported(value): void

Parameters¶

• value: VerifyUpdateSupport

Returns¶

VerifyUpdateSupport

Inherited from¶

LinuxUpdater.isUpdateSupported

isUserWithinRollout¶

get isUserWithinRollout(): VerifyUpdateSupport

Allows developer to override default logic for determining if the user is below the rollout threshold. The default logic compares the staging percentage with numerical representation of user ID. An override can define custom logic, or bypass it if needed.

set isUserWithinRollout(value): void

Parameters¶

• value: VerifyUpdateSupport

Returns¶

VerifyUpdateSupport

Inherited from¶

LinuxUpdater.isUserWithinRollout

logger¶

get logger(): null | Logger

The logger. You can pass electron-log, winston or another logger with the following interface: { info(), warn(), error() }. Set it to null if you would like to disable a logging feature.

set logger(value): void

Parameters¶

• value: null | Logger

Returns¶

null | Logger

Inherited from¶

LinuxUpdater.logger

netSession¶

get netSession(): Session

Returns¶

Session

Inherited from¶

LinuxUpdater.netSession

Methods¶

addAuthHeader()¶

addAuthHeader(token): void

Shortcut for explicitly adding auth tokens to request headers

Parameters¶

• token: string

Returns¶

void

Inherited from¶

LinuxUpdater.addAuthHeader

addListener()¶

addListener<U>(event, listener): this

Type Parameters¶

• U extends keyof AppUpdaterEvents

Parameters¶

• event: U

• listener: AppUpdaterEvents[U]

Returns¶

this

Inherited from¶

LinuxUpdater.addListener

addQuitHandler()¶

protected addQuitHandler(): void

Returns¶

void

Inherited from¶

LinuxUpdater.addQuitHandler

checkForUpdates()¶

checkForUpdates(): Promise<null | UpdateCheckResult>

Asks the server whether there is an update.

Returns¶

Promise<null | UpdateCheckResult>

null if the updater is disabled, otherwise info about the latest version

Inherited from¶

LinuxUpdater.checkForUpdates

checkForUpdatesAndNotify()¶

checkForUpdatesAndNotify(downloadNotification?): Promise<null | UpdateCheckResult>

Parameters¶

• downloadNotification?: DownloadNotification

Returns¶

Promise<null | UpdateCheckResult>

Inherited from¶

LinuxUpdater.checkForUpdatesAndNotify

detectPackageManager()¶

protected detectPackageManager(pms): string

Detects the package manager to use based on the available commands. Allows overriding the default behavior by setting the ELECTRON_BUILDER_LINUX_PACKAGE_MANAGER environment variable. If the environment variable is set, it will be used directly. (This is useful for testing each package manager logic path.) Otherwise, it checks for the presence of the specified package manager commands in the order provided.

Parameters¶

• pms: string[]

An array of package manager commands to check for, in priority order.

Returns¶

string

The detected package manager command or “unknown” if none are found.

Inherited from¶

LinuxUpdater.detectPackageManager

determineSudoCommand()¶

protected determineSudoCommand(): string

Returns¶

string

Inherited from¶

LinuxUpdater.determineSudoCommand

differentialDownloadInstaller()¶

protected differentialDownloadInstaller(fileInfo, downloadUpdateOptions, installerPath, provider, oldInstallerFileName): Promise<boolean>

Parameters¶

• fileInfo: ResolvedUpdateFileInfo

• downloadUpdateOptions: DownloadUpdateOptions

• installerPath: string

• provider: Provider<any>

• oldInstallerFileName: string

Returns¶

Promise<boolean>

Inherited from¶

LinuxUpdater.differentialDownloadInstaller

dispatchError()¶

protected dispatchError(e): void

Parameters¶

• e: Error

Returns¶

void

Inherited from¶

LinuxUpdater.dispatchError

dispatchUpdateDownloaded()¶

protected dispatchUpdateDownloaded(event): void

Parameters¶

• event: UpdateDownloadedEvent

Returns¶

void

Inherited from¶

LinuxUpdater.dispatchUpdateDownloaded

doInstall()¶

protected doInstall(options): boolean

Parameters¶

• options: InstallOptions

Returns¶

boolean

Overrides¶

LinuxUpdater.doInstall

downloadUpdate()¶

downloadUpdate(cancellationToken): Promise<string[]>

Start downloading update manually. You can use this method if autoDownload option is set to false.

Parameters¶

• cancellationToken: CancellationToken = ...

Returns¶

Promise<string[]>

Paths to downloaded files.

Inherited from¶

LinuxUpdater.downloadUpdate

emit()¶

emit<U>(event, …args): boolean

Type Parameters¶

• U extends keyof AppUpdaterEvents

Parameters¶

• event: U

install(isSilent, isForceRunAfter): boolean

Parameters¶

• isSilent: boolean = false

• isForceRunAfter: boolean = false

Returns¶

boolean

Inherited from¶

LinuxUpdater.install

isRunningAsRoot()¶

protected isRunningAsRoot(): boolean

off<U>(event, listener): this

Type Parameters¶

• U extends keyof AppUpdaterEvents

Parameters¶

• event: U

• listener: AppUpdaterEvents[U]

Returns¶

this

Inherited from¶

LinuxUpdater.off

on()¶

on<U>(event, listener): this

Type Parameters¶

• U extends keyof AppUpdaterEvents

Parameters¶

• event: U

• listener: AppUpdaterEvents[U]

Returns¶

this

Inherited from¶

LinuxUpdater.on

once()¶

once<U>(event, listener): this

Type Parameters¶

• U extends keyof AppUpdaterEvents

Parameters¶

• event: U

• listener: AppUpdaterEvents[U]

Returns¶

this

Inherited from¶

LinuxUpdater.once

onUpdateAvailable()¶

protected onUpdateAvailable(updateInfo): void

Parameters¶

• updateInfo: UpdateInfo

Returns¶

void

Inherited from¶

LinuxUpdater.onUpdateAvailable

prependListener()¶

prependListener<U>(event, listener): this

Type Parameters¶

• U extends keyof AppUpdaterEvents

Parameters¶

• event: U

• listener: AppUpdaterEvents[U]

Returns¶

this

Inherited from¶

LinuxUpdater.prependListener

prependOnceListener()¶

prependOnceListener<U>(event, listener): this

Type Parameters¶

• U extends keyof AppUpdaterEvents

Parameters¶

• event: U

• listener: AppUpdaterEvents[U]

Returns¶

this

Inherited from¶

LinuxUpdater.prependOnceListener

quitAndInstall()¶

quitAndInstall(isSilent, isForceRunAfter): void

Restarts the app and installs the update after it has been downloaded. It should only be called after update-downloaded has been emitted.

Note: autoUpdater.quitAndInstall() will close all application windows first and only emit before-quit event on app after that. This is different from the normal quit event sequence.

Parameters¶

• isSilent: boolean = false

windows-only Runs the installer in silent mode. Defaults to false.

• isForceRunAfter: boolean = false

Run the app after finish even on silent install. Not applicable for macOS. Ignored if isSilent is set to false(In this case you can still set autoRunAppAfterInstall to false to prevent run the app after finish).

Returns¶

void

Inherited from¶

LinuxUpdater.quitAndInstall

rawListeners()¶

rawListeners<U>(type): AppUpdaterEvents[U][]

Type Parameters¶

• U extends keyof AppUpdaterEvents

Parameters¶

• type: U

Returns¶

AppUpdaterEvents[U][]

Inherited from¶

LinuxUpdater.rawListeners

removeAllListeners()¶

removeAllListeners(event?): this

Parameters¶

• event?: keyof AppUpdaterEvents

Returns¶

this

Inherited from¶

LinuxUpdater.removeAllListeners

removeListener()¶

removeListener<U>(event, listener): this

Type Parameters¶

• U extends keyof AppUpdaterEvents

Parameters¶

• event: U

• listener: AppUpdaterEvents[U]

Returns¶

this

Inherited from¶

LinuxUpdater.removeListener

runCommandWithSudoIfNeeded()¶

protected runCommandWithSudoIfNeeded(commandWithArgs): string

Parameters¶

• commandWithArgs: string[]

Returns¶

string

Inherited from¶

LinuxUpdater.runCommandWithSudoIfNeeded

setFeedURL()¶

setFeedURL(options): void

Configure update provider. If value is string, GenericServerOptions will be set with value as url.

Parameters¶

• options: PublishConfiguration | AllPublishOptions

If you want to override configuration in the app-update.yml.

Returns¶

void

Inherited from¶

LinuxUpdater.setFeedURL

setMaxListeners()¶

setMaxListeners(n): this

Parameters¶

• n: number

Returns¶

this

Inherited from¶

LinuxUpdater.setMaxListeners

spawnLog()¶

protected spawnLog(cmd, args, env, stdio): Promise<boolean>

This handles both node 8 and node 10 way of emitting error when spawning a process - node 8: Throws the error - node 10: Emit the error(Need to listen with on)

Parameters¶

• cmd: string

• args: string[] = []

• env: any = undefined

• stdio: StdioOptions = "ignore"

Returns¶

Promise<boolean>

Inherited from¶

LinuxUpdater.spawnLog

spawnSyncLog()¶

protected spawnSyncLog(cmd, args, env): string

Parameters¶

• cmd: string

• args: string[] = []

• env = {}

Returns¶

string

Inherited from¶

LinuxUpdater.spawnSyncLog

sudoWithArgs()¶

protected sudoWithArgs(installComment): string[]

Parameters¶

• installComment: string

Returns¶

string[]

Inherited from¶

LinuxUpdater.sudoWithArgs

installWithCommandRunner()¶

static installWithCommandRunner(installerPath, commandRunner, logger): void

Parameters¶

• installerPath: string

• commandRunner

• logger: Logger

Returns¶

void