Skip to content

Snap

The top-level snap key contains set of options instructing electron-builder on how it should build Snap.

Configuration

Electron-Builder / app-builder-lib / SnapOptions

Extends

Properties

after?

readonly optional after: null | string[]

Specifies any parts that should be built before this part. Defaults to ["desktop-gtk2""].

If list contains default, it will be replaced to default list, so, ["default", "foo"] can be used to add custom parts foo in addition to defaults.

allowNativeWayland?

readonly optional allowNativeWayland: null | boolean

Allow running the program with native wayland support with –ozone-platform=wayland. Disabled by default because of this issue in older Electron/Snap versions: https://github.com/electron-userland/electron-builder/issues/4007

appPartStage?

readonly optional appPartStage: null | string[]

Specifies which files from the app part to stage and which to exclude. Individual files, directories, wildcards, globstars, and exclusions are accepted. See Snapcraft filesets to learn more about the format.

The defaults can be found in snap.ts.

assumes?

readonly optional assumes: null | string | string[]

The list of features that must be supported by the core in order for this snap to install.

autoStart?

readonly optional autoStart: boolean

Whether or not the snap should automatically start on login.

Default

false

base?

readonly optional base: null | string

A snap of type base to be used as the execution environment for this snap. Examples: core, core18, core20, core22. Defaults to core20

buildPackages?

readonly optional buildPackages: null | string[]

The list of debian packages needs to be installed for building this snap.

compression?

readonly optional compression: null | "xz" | "lzo"

Sets the compression type for the snap. Can be xz, lzo, or null.

confinement?

readonly optional confinement: null | "devmode" | "strict" | "classic"

The type of confinement supported by the snap.

Default

strict

environment?

readonly optional environment: null | object

The custom environment. Defaults to {"TMPDIR: "$XDG_RUNTIME_DIR"}. If you set custom, it will be merged with default.

grade?

readonly optional grade: null | "stable" | "devel"

The quality grade of the snap. It can be either devel (i.e. a development version of the snap, so not to be published to the “stable” or “candidate” channels) or “stable” (i.e. a stable release or release candidate, which can be released to all channels).

Default

stable

hooks?

readonly optional hooks: null | string

The hooks directory, relative to build (build resources directory).

Default

build/snap-hooks

layout?

readonly optional layout: null | object

Specifies any files to make accessible from locations such as /usr, /var, and /etc. See snap layouts to learn more.

plugs?

readonly optional plugs: null | PlugDescriptor | (string | PlugDescriptor)[]

The list of plugs. Defaults to ["desktop", "desktop-legacy", "home", "x11", "wayland", "unity7", "browser-support", "network", "gsettings", "audio-playback", "pulseaudio", "opengl"].

If list contains default, it will be replaced to default list, so, ["default", "foo"] can be used to add custom plug foo in addition to defaults.

Additional attributes can be specified using object instead of just name of plug: 

[
 {
   "browser-sandbox": {
     "interface": "browser-support",
     "allow-sandbox": true
   },
 },
 "another-simple-plug-name"
]

slots?

readonly optional slots: null | PlugDescriptor | (string | SlotDescriptor)[]

The list of slots.

Additional attributes can be specified using object instead of just name of slot: ``` [ { “mpris”: { “name”: “chromium” }, } ]

In case you want your application to be a compliant MPris player, you will need to definie The mpris slot with “chromium” name. This electron has it hardcoded, and we need to pass this name so snap will allow it in strict confinement.

stagePackages?

readonly optional stagePackages: null | string[]

The list of Ubuntu packages to use that are needed to support the app part creation. Like depends for deb. Defaults to ["libnspr4", "libnss3", "libxss1", "libappindicator3-1", "libsecret-1-0"].

If list contains default, it will be replaced to default list, so, ["default", "foo"] can be used to add custom package foo in addition to defaults.

summary?

readonly optional summary: null | string

The 78 character long summary. Defaults to productName.

title?

readonly optional title: null | string

An optional title for the snap, may contain uppercase letters and spaces. Defaults to productName. See snap format documentation.

useTemplateApp?

readonly optional useTemplateApp: boolean

Whether to use template snap. Defaults to true if stagePackages not specified.