Skip to content

app builder lib.Interface.CommonConfiguration

Electron-Builder / app-builder-lib / CommonConfiguration

Configuration Options

Extended by

Properties

apk?

readonly optional apk: null | LinuxTargetSpecificOptions


appId?

readonly optional appId: null | string

The application id. Used as CFBundleIdentifier for MacOS and as Application User Model ID for Windows (NSIS target only, Squirrel.Windows not supported). It is strongly recommended that an explicit ID is set.

Default

com.electron.${name}

appImage?

readonly optional appImage: null | AppImageOptions

AppImage options.


appx?

readonly optional appx: null | AppXOptions


buildDependenciesFromSource?

optional buildDependenciesFromSource: boolean

Whether to build the application native dependencies from source.

Default

false

buildNumber?

readonly optional buildNumber: null | string

The build number. Maps to the --iteration flag for builds using FPM on Linux. If not defined, then it will fallback to BUILD_NUMBER or TRAVIS_BUILD_NUMBER or APPVEYOR_BUILD_NUMBER or CIRCLE_BUILD_NUM or BUILD_BUILDNUMBER or CI_PIPELINE_IID env.


buildVersion?

readonly optional buildVersion: null | string

The build version. Maps to the CFBundleVersion on macOS, and FileVersion metadata property on Windows. Defaults to the version. If buildVersion is not defined and buildNumber (or one of the buildNumber envs) is defined, it will be used as a build version (version.buildNumber).


readonly optional copyright: null | string

The human-readable copyright line for the app.

Default

Copyright © year ${author}

deb?

readonly optional deb: null | DebOptions

Debian package options.


directories?

readonly optional directories: null | MetadataDirectories

Directories for build resources


dmg?

readonly optional dmg: null | DmgOptions

macOS DMG options.


downloadAlternateFFmpeg?

readonly optional downloadAlternateFFmpeg: boolean

Whether to download the alternate FFmpeg library from Electron’s release assets and replace the default FFmpeg library prior to signing


electronFuses?

readonly optional electronFuses: null | FuseOptionsV1

Options to pass to @electron/fuses Ref: https://github.com/electron/fuses


extraMetadata?

readonly optional extraMetadata: any

Inject properties to package.json.


flatpak?

readonly optional flatpak: null | FlatpakOptions

Flatpak options.


forceCodeSigning?

readonly optional forceCodeSigning: boolean

Whether to fail if the application is not signed (to prevent unsigned app if code signing configuration is not correct).

Default

false

freebsd?

readonly optional freebsd: null | LinuxTargetSpecificOptions


includePdb?

readonly optional includePdb: boolean

Whether to include PDB files.

Default

false

linux?

readonly optional linux: null | LinuxConfiguration

Options related to how build Linux targets.


mac?

readonly optional mac: null | MacConfiguration

Options related to how build macOS targets.


mas?

readonly optional mas: null | MasConfiguration

MAS (Mac Application Store) options.


masDev?

readonly optional masDev: null | MasConfiguration

MAS (Mac Application Store) development options (mas-dev target).


nativeRebuilder?

readonly optional nativeRebuilder: null | "legacy" | "sequential" | "parallel"

Use legacy app-builder binary for installing native dependencies, or @electron/rebuild in sequential or parallel compilation modes.

Default

sequential

nodeGypRebuild?

readonly optional nodeGypRebuild: boolean

Whether to execute node-gyp rebuild before starting to package the app.

Don’t use npm (neither .npmrc) for configuring electron headers. Use electron-builder node-gyp-rebuild instead.

Default

false

npmArgs?

readonly optional npmArgs: null | string | string[]

Additional command line arguments to use when installing app native deps.


npmRebuild?

readonly optional npmRebuild: boolean

Whether to rebuild native dependencies before starting to package the app.

Default

true

nsis?

readonly optional nsis: null | NsisOptions


nsisWeb?

readonly optional nsisWeb: null | NsisWebOptions


p5p?

readonly optional p5p: null | LinuxTargetSpecificOptions


pacman?

readonly optional pacman: null | LinuxTargetSpecificOptions


pkg?

readonly optional pkg: null | PkgOptions

macOS PKG options.


portable?

readonly optional portable: null | PortableOptions


productName?

readonly optional productName: null | string

As name, but allows you to specify a product name for your executable which contains spaces and other special characters not allowed in the name property. If not specified inside of the build configuration, productName property defined at the top level of package.json is used. If not specified at the top level of package.json, name property is used.


removePackageKeywords?

readonly optional removePackageKeywords: boolean

Whether to remove keywords field from package.json files.

Default

true

removePackageScripts?

readonly optional removePackageScripts: boolean

Whether to remove scripts field from package.json files.

Default

true

rpm?

readonly optional rpm: null | LinuxTargetSpecificOptions


snap?

readonly optional snap: null | SnapOptions

Snap options.


squirrelWindows?

readonly optional squirrelWindows: null | SquirrelWindowsOptions


win?

readonly optional win: null | WindowsConfiguration

Options related to how build Windows targets.