app builder lib.Interface.CommonConfiguration

Electron-Builder / app-builder-lib / CommonConfiguration

Configuration Options

Extended by

• Configuration

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).

---

copyright?

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

---

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.