nx-electron
Version:
Electron Plugin for Nx
1,534 lines (1,533 loc) • 198 kB
JSON
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"definitions": {
"AppImageOptions": {
"additionalProperties": false,
"properties": {
"artifactName": {
"description": "The [artifact file name template](/configuration/configuration#artifact-file-name-template).",
"type": [
"null",
"string"
]
},
"category": {
"description": "The [application category](https://specifications.freedesktop.org/menu-spec/latest/apa.html#main-category-registry).",
"type": [
"null",
"string"
]
},
"description": {
"description": "As [description](/configuration/configuration#Metadata-description) from application package.json, but allows you to specify different for Linux.",
"type": [
"null",
"string"
]
},
"desktop": {
"description": "The [Desktop file](https://developer.gnome.org/integration-guide/stable/desktop-files.html.en) entries (name to value)."
},
"executableArgs": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "The executable parameters. Pass to executableName"
},
"license": {
"description": "The path to EULA license file. Defaults to `license.txt` or `eula.txt` (or uppercase variants). Only plain text is supported.",
"type": [
"null",
"string"
]
},
"mimeTypes": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "The mime types in addition to specified in the file associations. Use it if you don't want to register a new mime type, but reuse existing."
},
"publish": {
"anyOf": [
{
"$ref": "#/definitions/GithubOptions"
},
{
"$ref": "#/definitions/S3Options"
},
{
"$ref": "#/definitions/SpacesOptions"
},
{
"$ref": "#/definitions/GenericServerOptions"
},
{
"$ref": "#/definitions/BintrayOptions"
},
{
"$ref": "#/definitions/CustomPublishOptions"
},
{
"$ref": "#/definitions/SnapStoreOptions"
},
{
"items": {
"anyOf": [
{
"$ref": "#/definitions/GithubOptions"
},
{
"$ref": "#/definitions/S3Options"
},
{
"$ref": "#/definitions/SpacesOptions"
},
{
"$ref": "#/definitions/GenericServerOptions"
},
{
"$ref": "#/definitions/BintrayOptions"
},
{
"$ref": "#/definitions/CustomPublishOptions"
},
{
"$ref": "#/definitions/SnapStoreOptions"
},
{
"type": "string"
}
]
},
"type": "array"
},
{
"type": [
"null",
"string"
]
}
]
},
"synopsis": {
"description": "The [short description](https://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-Description).",
"type": [
"null",
"string"
]
}
},
"type": "object"
},
"AppXOptions": {
"additionalProperties": false,
"properties": {
"addAutoLaunchExtension": {
"description": "Whether to add auto launch extension. Defaults to `true` if [electron-winstore-auto-launch](https://github.com/felixrieseberg/electron-winstore-auto-launch) in the dependencies.",
"type": "boolean"
},
"applicationId": {
"description": "The application id. Defaults to `identityName`. Can’t start with numbers.",
"type": "string"
},
"artifactName": {
"description": "The [artifact file name template](/configuration/configuration#artifact-file-name-template).",
"type": [
"null",
"string"
]
},
"backgroundColor": {
"default": "#464646",
"description": "The background color of the app tile. See [Visual Elements](https://msdn.microsoft.com/en-us/library/windows/apps/br211471.aspx).",
"type": [
"null",
"string"
]
},
"displayName": {
"description": "A friendly name that can be displayed to users. Corresponds to [Properties.DisplayName](https://msdn.microsoft.com/en-us/library/windows/apps/br211432.aspx).\nDefaults to the application product name.",
"type": [
"null",
"string"
]
},
"electronUpdaterAware": {
"default": false,
"type": "boolean"
},
"identityName": {
"description": "The name. Corresponds to [Identity.Name](https://msdn.microsoft.com/en-us/library/windows/apps/br211441.aspx). Defaults to the [application name](/configuration/configuration#Metadata-name).",
"type": [
"null",
"string"
]
},
"languages": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": [
"null",
"string"
]
}
],
"description": "The list of [supported languages](https://docs.microsoft.com/en-us/windows/uwp/globalizing/manage-language-and-region#specify-the-supported-languages-in-the-apps-manifest) that will be listed in the Windows Store.\nThe first entry (index 0) will be the default language.\nDefaults to en-US if omitted."
},
"makeappxArgs": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
},
"publish": {
"anyOf": [
{
"$ref": "#/definitions/GithubOptions"
},
{
"$ref": "#/definitions/S3Options"
},
{
"$ref": "#/definitions/SpacesOptions"
},
{
"$ref": "#/definitions/GenericServerOptions"
},
{
"$ref": "#/definitions/BintrayOptions"
},
{
"$ref": "#/definitions/CustomPublishOptions"
},
{
"$ref": "#/definitions/SnapStoreOptions"
},
{
"items": {
"anyOf": [
{
"$ref": "#/definitions/GithubOptions"
},
{
"$ref": "#/definitions/S3Options"
},
{
"$ref": "#/definitions/SpacesOptions"
},
{
"$ref": "#/definitions/GenericServerOptions"
},
{
"$ref": "#/definitions/BintrayOptions"
},
{
"$ref": "#/definitions/CustomPublishOptions"
},
{
"$ref": "#/definitions/SnapStoreOptions"
},
{
"type": "string"
}
]
},
"type": "array"
},
{
"type": [
"null",
"string"
]
}
]
},
"publisher": {
"description": "The Windows Store publisher. Not used if AppX is build for testing. See [AppX Package Code Signing](#appx-package-code-signing) below.",
"type": [
"null",
"string"
]
},
"publisherDisplayName": {
"description": "A friendly name for the publisher that can be displayed to users. Corresponds to [Properties.PublisherDisplayName](https://msdn.microsoft.com/en-us/library/windows/apps/br211460.aspx).\nDefaults to company name from the application metadata.",
"type": [
"null",
"string"
]
},
"setBuildNumber": {
"default": false,
"description": "Whether to set build number. See https://github.com/electron-userland/electron-builder/issues/3875",
"type": "boolean"
},
"showNameOnTiles": {
"default": false,
"description": "Whether to overlay the app's name on top of tile images on the Start screen. Defaults to `false`. (https://docs.microsoft.com/en-us/uwp/schemas/appxpackage/uapmanifestschema/element-uap-shownameontiles) in the dependencies.",
"type": "boolean"
}
},
"type": "object"
},
"AsarOptions": {
"additionalProperties": false,
"properties": {
"externalAllowed": {
"default": false,
"description": "Allows external asar files.",
"type": "boolean"
},
"ordering": {
"type": [
"null",
"string"
]
},
"smartUnpack": {
"default": true,
"description": "Whether to automatically unpack executables files.",
"type": "boolean"
}
},
"type": "object"
},
"BintrayOptions": {
"additionalProperties": false,
"description": "[Bintray](https://bintray.com/) options. Requires an API key. An API key can be obtained from the user [profile](https://bintray.com/profile/edit) page (\"Edit Your Profile\" -> API Key).\nDefine `BT_TOKEN` environment variable.",
"properties": {
"component": {
"description": "The Bintray component (Debian only).",
"type": [
"null",
"string"
]
},
"distribution": {
"default": "stable",
"description": "The Bintray distribution (Debian only).",
"type": [
"null",
"string"
]
},
"owner": {
"description": "The owner.",
"type": [
"null",
"string"
]
},
"package": {
"description": "The Bintray package name.",
"type": [
"null",
"string"
]
},
"provider": {
"description": "The provider. Must be `bintray`.",
"enum": [
"bintray"
],
"type": "string"
},
"publishAutoUpdate": {
"default": true,
"description": "Whether to publish auto update info files.\n\nAuto update relies only on the first provider in the list (you can specify several publishers).\nThus, probably, there`s no need to upload the metadata files for the other configured providers. But by default will be uploaded.",
"type": "boolean"
},
"publisherName": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
},
"repo": {
"default": "generic",
"description": "The Bintray repository name.",
"type": [
"null",
"string"
]
},
"requestHeaders": {
"$ref": "#/definitions/OutgoingHttpHeaders",
"description": "Any custom request headers"
},
"token": {
"type": [
"null",
"string"
]
},
"updaterCacheDirName": {
"type": [
"null",
"string"
]
},
"user": {
"description": "The Bintray user account. Used in cases where the owner is an organization.",
"type": [
"null",
"string"
]
}
},
"required": [
"provider"
],
"type": "object"
},
"CustomPublishOptions": {
"additionalProperties": {},
"properties": {
"provider": {
"$ref": "#/definitions/PublishProvider",
"description": "The provider."
},
"publishAutoUpdate": {
"default": true,
"description": "Whether to publish auto update info files.\n\nAuto update relies only on the first provider in the list (you can specify several publishers).\nThus, probably, there`s no need to upload the metadata files for the other configured providers. But by default will be uploaded.",
"type": "boolean"
},
"publisherName": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
},
"requestHeaders": {
"$ref": "#/definitions/OutgoingHttpHeaders",
"description": "Any custom request headers"
},
"updaterCacheDirName": {
"type": [
"null",
"string"
]
}
},
"required": [
"provider"
],
"type": "object"
},
"DebOptions": {
"additionalProperties": false,
"properties": {
"afterInstall": {
"type": [
"null",
"string"
]
},
"afterRemove": {
"type": [
"null",
"string"
]
},
"artifactName": {
"description": "The [artifact file name template](/configuration/configuration#artifact-file-name-template).",
"type": [
"null",
"string"
]
},
"category": {
"description": "The [application category](https://specifications.freedesktop.org/menu-spec/latest/apa.html#main-category-registry).",
"type": [
"null",
"string"
]
},
"compression": {
"anyOf": [
{
"enum": [
"bzip2",
"gz",
"xz"
],
"type": "string"
},
{
"type": "null"
}
],
"default": "xz",
"description": "The compression type."
},
"depends": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Package dependencies. Defaults to `[\"gconf2\", \"gconf-service\", \"libnotify4\", \"libappindicator1\", \"libxtst6\", \"libnss3\"]`."
},
"description": {
"description": "As [description](/configuration/configuration#Metadata-description) from application package.json, but allows you to specify different for Linux.",
"type": [
"null",
"string"
]
},
"desktop": {
"description": "The [Desktop file](https://developer.gnome.org/integration-guide/stable/desktop-files.html.en) entries (name to value)."
},
"executableArgs": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "The executable parameters. Pass to executableName"
},
"fpm": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "*Advanced only* The [fpm](https://github.com/jordansissel/fpm/wiki#usage) options.\n\nExample: `[\"--before-install=build/deb-preinstall.sh\", \"--after-upgrade=build/deb-postinstall.sh\"]`"
},
"icon": {
"type": "string"
},
"maintainer": {
"type": [
"null",
"string"
]
},
"mimeTypes": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "The mime types in addition to specified in the file associations. Use it if you don't want to register a new mime type, but reuse existing."
},
"packageCategory": {
"description": "The [package category](https://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-Section).",
"type": [
"null",
"string"
]
},
"priority": {
"description": "The [Priority](https://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-Priority) attribute.",
"type": [
"null",
"string"
]
},
"publish": {
"anyOf": [
{
"$ref": "#/definitions/GithubOptions"
},
{
"$ref": "#/definitions/S3Options"
},
{
"$ref": "#/definitions/SpacesOptions"
},
{
"$ref": "#/definitions/GenericServerOptions"
},
{
"$ref": "#/definitions/BintrayOptions"
},
{
"$ref": "#/definitions/CustomPublishOptions"
},
{
"$ref": "#/definitions/SnapStoreOptions"
},
{
"items": {
"anyOf": [
{
"$ref": "#/definitions/GithubOptions"
},
{
"$ref": "#/definitions/S3Options"
},
{
"$ref": "#/definitions/SpacesOptions"
},
{
"$ref": "#/definitions/GenericServerOptions"
},
{
"$ref": "#/definitions/BintrayOptions"
},
{
"$ref": "#/definitions/CustomPublishOptions"
},
{
"$ref": "#/definitions/SnapStoreOptions"
},
{
"type": "string"
}
]
},
"type": "array"
},
{
"type": [
"null",
"string"
]
}
]
},
"synopsis": {
"description": "The [short description](https://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-Description).",
"type": [
"null",
"string"
]
},
"vendor": {
"type": [
"null",
"string"
]
}
},
"type": "object"
},
"DmgContent": {
"additionalProperties": false,
"properties": {
"name": {
"description": "The name of the file within the DMG. Defaults to basename of `path`.",
"type": "string"
},
"path": {
"description": "The path of the file within the DMG.",
"type": "string"
},
"type": {
"enum": [
"dir",
"file",
"link"
],
"type": "string"
},
"x": {
"description": "The device-independent pixel offset from the left of the window to the **center** of the icon.",
"type": "number"
},
"y": {
"description": "The device-independent pixel offset from the top of the window to the **center** of the icon.",
"type": "number"
}
},
"required": [
"x",
"y"
],
"type": "object"
},
"DmgOptions": {
"additionalProperties": false,
"properties": {
"artifactName": {
"description": "The [artifact file name template](/configuration/configuration#artifact-file-name-template).",
"type": [
"null",
"string"
]
},
"background": {
"description": "The path to background image (default: `build/background.tiff` or `build/background.png` if exists). The resolution of this file determines the resolution of the installer window.\nIf background is not specified, use `window.size`. Default locations expected background size to be 540x380.",
"type": [
"null",
"string"
]
},
"backgroundColor": {
"description": "The background color (accepts css colors). Defaults to `#ffffff` (white) if no background image.",
"type": [
"null",
"string"
]
},
"contents": {
"description": "The content — to customize icon locations. The x and y coordinates refer to the position of the **center** of the icon (at 1x scale), and do not take the label into account.",
"items": {
"$ref": "#/definitions/DmgContent"
},
"type": "array"
},
"format": {
"default": "UDZO",
"description": "The disk image format. `ULFO` (lzfse-compressed image (OS X 10.11+ only)).",
"enum": [
"UDBZ",
"UDCO",
"UDRO",
"UDRW",
"UDZO",
"ULFO"
],
"type": "string"
},
"icon": {
"description": "The path to DMG icon (volume icon), which will be shown when mounted, relative to the [build resources](/configuration/configuration#MetadataDirectories-buildResources) or to the project directory.\nDefaults to the application icon (`build/icon.icns`).",
"type": [
"null",
"string"
]
},
"iconSize": {
"default": 80,
"description": "The size of all the icons inside the DMG.",
"type": [
"null",
"number"
]
},
"iconTextSize": {
"default": 12,
"description": "The size of all the icon texts inside the DMG.",
"type": [
"null",
"number"
]
},
"internetEnabled": {
"default": false,
"description": "Whether to create internet-enabled disk image (when it is downloaded using a browser it will automatically decompress the image, put the application on the desktop, unmount and remove the disk image file).",
"type": "boolean"
},
"publish": {
"anyOf": [
{
"$ref": "#/definitions/GithubOptions"
},
{
"$ref": "#/definitions/S3Options"
},
{
"$ref": "#/definitions/SpacesOptions"
},
{
"$ref": "#/definitions/GenericServerOptions"
},
{
"$ref": "#/definitions/BintrayOptions"
},
{
"$ref": "#/definitions/CustomPublishOptions"
},
{
"$ref": "#/definitions/SnapStoreOptions"
},
{
"items": {
"anyOf": [
{
"$ref": "#/definitions/GithubOptions"
},
{
"$ref": "#/definitions/S3Options"
},
{
"$ref": "#/definitions/SpacesOptions"
},
{
"$ref": "#/definitions/GenericServerOptions"
},
{
"$ref": "#/definitions/BintrayOptions"
},
{
"$ref": "#/definitions/CustomPublishOptions"
},
{
"$ref": "#/definitions/SnapStoreOptions"
},
{
"type": "string"
}
]
},
"type": "array"
},
{
"type": [
"null",
"string"
]
}
]
},
"sign": {
"default": false,
"description": "Whether to sign the DMG or not. Signing is not required and will lead to unwanted errors in combination with notarization requirements.",
"type": "boolean"
},
"title": {
"default": "${productName} ${version}",
"description": "The title of the produced DMG, which will be shown when mounted (volume name).\n\nMacro `${productName}`, `${version}` and `${name}` are supported.",
"type": [
"null",
"string"
]
},
"window": {
"$ref": "#/definitions/DmgWindow",
"description": "The DMG window position and size. With y co-ordinates running from bottom to top.\n\nThe Finder makes sure that the window will be on the user’s display, so if you want your window at the top left of the display you could use `\"x\": 0, \"y\": 100000` as the x, y co-ordinates.\nIt is not to be possible to position the window relative to the [top left](https://github.com/electron-userland/electron-builder/issues/3990#issuecomment-512960957) or relative to the center of the user’s screen."
},
"writeUpdateInfo": {
"default": true,
"type": "boolean"
}
},
"type": "object"
},
"DmgWindow": {
"additionalProperties": false,
"properties": {
"height": {
"description": "The height. Defaults to background image height or 380.",
"type": "number"
},
"width": {
"description": "The width. Defaults to background image width or 540.",
"type": "number"
},
"x": {
"default": 400,
"description": "The X position relative to left of the screen.",
"type": "number"
},
"y": {
"default": 100,
"description": "The Y position relative to bottom of the screen.",
"type": "number"
}
},
"type": "object"
},
"ElectronDownloadOptions": {
"additionalProperties": false,
"properties": {
"arch": {
"type": "string"
},
"cache": {
"description": "The [cache location](https://github.com/electron-userland/electron-download#cache-location).",
"type": [
"null",
"string"
]
},
"customDir": {
"type": [
"null",
"string"
]
},
"customFilename": {
"type": [
"null",
"string"
]
},
"isVerifyChecksum": {
"type": "boolean"
},
"mirror": {
"description": "The mirror.",
"type": [
"null",
"string"
]
},
"platform": {
"enum": [
"darwin",
"linux",
"mas",
"win32"
],
"type": "string"
},
"strictSSL": {
"type": "boolean"
},
"version": {
"type": "string"
}
},
"type": "object"
},
"FileAssociation": {
"additionalProperties": false,
"description": "File associations.\n\nmacOS (corresponds to [CFBundleDocumentTypes](https://developer.apple.com/library/content/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/20001431-101685)) and NSIS only.\n\nOn Windows works only if [nsis.perMachine](https://electron.build/configuration/configuration#NsisOptions-perMachine) is set to `true`.",
"properties": {
"description": {
"description": "*windows-only.* The description.",
"type": [
"null",
"string"
]
},
"ext": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "string"
}
],
"description": "The extension (minus the leading period). e.g. `png`."
},
"icon": {
"description": "The path to icon (`.icns` for MacOS and `.ico` for Windows), relative to `build` (build resources directory). Defaults to `${firstExt}.icns`/`${firstExt}.ico` (if several extensions specified, first is used) or to application icon.\n\nNot supported on Linux, file issue if need (default icon will be `x-office-document`).",
"type": [
"null",
"string"
]
},
"isPackage": {
"description": "*macOS-only* Whether the document is distributed as a bundle. If set to true, the bundle directory is treated as a file. Corresponds to `LSTypeIsPackage`.",
"type": "boolean"
},
"mimeType": {
"description": "*linux-only.* The mime-type.",
"type": [
"null",
"string"
]
},
"name": {
"description": "The name. e.g. `PNG`. Defaults to `ext`.",
"type": [
"null",
"string"
]
},
"role": {
"default": "Editor",
"description": "*macOS-only* The app’s role with respect to the type. The value can be `Editor`, `Viewer`, `Shell`, or `None`. Corresponds to `CFBundleTypeRole`.",
"type": "string"
}
},
"required": [
"ext"
],
"type": "object"
},
"FileSet": {
"additionalProperties": false,
"properties": {
"filter": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "string"
}
],
"description": "The [glob patterns](/file-patterns)."
},
"from": {
"description": "The source path relative to the project directory.",
"type": "string"
},
"to": {
"description": "The destination path relative to the app's content directory for `extraFiles` and the app's resource directory for `extraResources`.",
"type": "string"
}
},
"type": "object"
},
"GenericServerOptions": {
"additionalProperties": false,
"description": "Generic (any HTTP(S) server) options.\nIn all publish options [File Macros](/file-patterns#file-macros) are supported.",
"properties": {
"channel": {
"default": "latest",
"description": "The channel.",
"type": [
"null",
"string"
]
},
"provider": {
"description": "The provider. Must be `generic`.",
"enum": [
"generic"
],
"type": "string"
},
"publishAutoUpdate": {
"default": true,
"description": "Whether to publish auto update info files.\n\nAuto update relies only on the first provider in the list (you can specify several publishers).\nThus, probably, there`s no need to upload the metadata files for the other configured providers. But by default will be uploaded.",
"type": "boolean"
},
"publisherName": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
},
"requestHeaders": {
"$ref": "#/definitions/OutgoingHttpHeaders",
"description": "Any custom request headers"
},
"updaterCacheDirName": {
"type": [
"null",
"string"
]
},
"url": {
"description": "The base url. e.g. `https://bucket_name.s3.amazonaws.com`.",
"type": "string"
},
"useMultipleRangeRequest": {
"description": "Whether to use multiple range requests for differential update. Defaults to `true` if `url` doesn't contain `s3.amazonaws.com`.",
"type": "boolean"
}
},
"required": [
"provider",
"url"
],
"type": "object"
},
"GithubOptions": {
"additionalProperties": false,
"description": "[GitHub](https://help.github.com/articles/about-releases/) options.\n\nGitHub [personal access token](https://help.github.com/articles/creating-an-access-token-for-command-line-use/) is required. You can generate by going to [https://github.com/settings/tokens/new](https://github.com/settings/tokens/new). The access token should have the repo scope/permission.\nDefine `GH_TOKEN` environment variable.",
"properties": {
"host": {
"default": "github.com",
"description": "The host (including the port if need).",
"type": [
"null",
"string"
]
},
"owner": {
"description": "The owner.",
"type": [
"null",
"string"
]
},
"private": {
"description": "Whether to use private github auto-update provider if `GH_TOKEN` environment variable is defined. See [Private GitHub Update Repo](/auto-update#private-github-update-repo).",
"type": [
"null",
"boolean"
]
},
"protocol": {
"anyOf": [
{
"enum": [
"http",
"https"
],
"type": "string"
},
{
"type": "null"
}
],
"default": "https",
"description": "The protocol. GitHub Publisher supports only `https`."
},
"provider": {
"description": "The provider. Must be `github`.",
"enum": [
"github"
],
"type": "string"
},
"publishAutoUpdate": {
"default": true,
"description": "Whether to publish auto update info files.\n\nAuto update relies only on the first provider in the list (you can specify several publishers).\nThus, probably, there`s no need to upload the metadata files for the other configured providers. But by default will be uploaded.",
"type": "boolean"
},
"publisherName": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
},
"releaseType": {
"anyOf": [
{
"enum": [
"draft",
"prerelease",
"release"
],
"type": "string"
},
{
"type": "null"
}
],
"default": "draft",
"description": "The type of release. By default `draft` release will be created.\n\nAlso you can set release type using environment variable. If `EP_DRAFT`is set to `true` — `draft`, if `EP_PRE_RELEASE`is set to `true` — `prerelease`."
},
"repo": {
"description": "The repository name. [Detected automatically](#github-repository-and-bintray-package).",
"type": [
"null",
"string"
]
},
"requestHeaders": {
"$ref": "#/definitions/OutgoingHttpHeaders",
"description": "Any custom request headers"
},
"token": {
"description": "The access token to support auto-update from private github repositories. Never specify it in the configuration files. Only for [setFeedURL](/auto-update#appupdatersetfeedurloptions).",
"type": [
"null",
"string"
]
},
"updaterCacheDirName": {
"type": [
"null",
"string"
]
},
"vPrefixedTagName": {
"default": true,
"description": "Whether to use `v`-prefixed tag name.",
"type": "boolean"
}
},
"required": [
"provider"
],
"type": "object"
},
"LinuxConfiguration": {
"additionalProperties": false,
"properties": {
"appId": {
"default": "com.electron.${name}",
"description": "The application id. Used as [CFBundleIdentifier](https://developer.apple.com/library/ios/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/20001431-102070) for MacOS and as\n[Application User Model ID](https://msdn.microsoft.com/en-us/library/windows/desktop/dd378459(v=vs.85).aspx) for Windows (NSIS target only, Squirrel.Windows not supported). It is strongly recommended that an explicit ID is set.",
"type": [
"null",
"string"
]
},
"artifactName": {
"description": "The [artifact file name template](/configuration/configuration#artifact-file-name-template). Defaults to `${productName}-${version}.${ext}` (some target can have other defaults, see corresponding options).",
"type": [
"null",
"string"
]
},
"asar": {
"anyOf": [
{
"$ref": "#/definitions/AsarOptions"
},
{
"type": [
"null",
"boolean"
]
}
],
"default": true,
"description": "Whether to package the application's source code into an archive, using [Electron's archive format](http://electron.atom.io/docs/tutorial/application-packaging/).\n\nNode modules, that must be unpacked, will be detected automatically, you don't need to explicitly set [asarUnpack](#configuration-asarUnpack) - please file an issue if this doesn't work."
},
"asarUnpack": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": [
"null",
"string"
]
}
],
"description": "A [glob patterns](/file-patterns) relative to the [app directory](#MetadataDirectories-app), which specifies which files to unpack when creating the [asar](http://electron.atom.io/docs/tutorial/application-packaging/) archive."
},
"category": {
"description": "The [application category](https://specifications.freedesktop.org/menu-spec/latest/apa.html#main-category-registry).",
"type": [
"null",
"string"
]
},
"compression": {
"anyOf": [
{
"enum": [
"maximum",
"normal",
"store"
],
"type": "string"
},
{
"type": "null"
}
],
"default": "normal",
"description": "The compression level. If you want to rapidly test build, `store` can reduce build time significantly. `maximum` doesn't lead to noticeable size difference, but increase build time."
},
"cscKeyPassword": {
"type": [
"null",
"string"
]
},
"cscLink": {
"type": [
"null",
"string"
]
},
"description": {
"description": "As [description](/configuration/configuration#Metadata-description) from application package.json, but allows you to specify different for Linux.",
"type": [
"null",
"string"
]
},
"desktop": {
"description": "The [Desktop file](https://developer.gnome.org/integration-guide/stable/desktop-files.html.en) entries (name to value)."
},
"detectUpdateChannel": {
"default": true,
"description": "Whether to infer update channel from application version pre-release components. e.g. if version `0.12.1-alpha.1`, channel will be set to `alpha`. Otherwise to `latest`.",
"type": "boolean"
},
"electronUpdaterCompatibility": {
"description": "The [electron-updater compatibility](/auto-update#compatibility) semver range.",
"type": [
"null",
"string"
]
},
"executableArgs": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "The executable parameters. Pass to executableName"
},
"executableName": {
"description": "The executable name. Defaults to `productName`.\nCannot be specified per target, allowed only in the `linux`.",
"type": [
"null",
"string"
]
},
"extraFiles": {
"anyOf": [
{
"$ref": "#/definitions/FileSet"
},
{
"items": {
"anyOf": [
{
"$ref": "#/definitions/FileSet"
},
{
"type": "string"
}
]
},
"type": "array"
},
{
"type": [
"null",
"string"
]
}
]
},
"extraResources": {
"anyOf": [
{
"$ref": "#/definitions/FileSet"
},
{
"items": {
"anyOf": [
{
"$ref": "#/definitions/FileSet"
},
{
"type": "string"
}
]
},
"type": "array"
},
{
"type": [
"null",
"string"
]
}
]
},
"fileAssociations": {
"anyOf": [
{
"$ref": "#/definitions/FileAssociation"
},
{
"items": {
"$ref": "#/definitions/FileAssociation"
},
"type": "array"
}
],
"description": "The file associations."
},
"files": {
"anyOf": [
{
"$ref": "#/definitions/FileSet"
},
{
"items": {
"anyOf": [
{
"$ref": "#/definitions/FileSet"
},
{
"type": "string"
}
]
},
"type": "array"
},
{
"type": [
"null",
"string"
]
}
]
},
"forceCodeSigning": {
"description": "Whether to fail if app will be not code signed.",
"type": "boolean"
},
"generateUpdatesFilesForAllChannels": {
"default": false,
"description": "Please see [Building and Releasing using Channels](https://github.com/electron-userland/electron-builder/issues/1182#issuecomment-324947139).",
"type": "boolean"
},
"icon": {
"description": "The path to icon set directory or one png file, relative to the [build resources](/configuration/configuration#MetadataDirectories-buildResources) or to the project directory. The icon filename must contain the size (e.g. 32x32.png) of the icon.\nBy default will be generated automatically based on the macOS icns file.",
"type": "string"
},
"maintainer": {
"description": "The maintainer. Defaults to [author](/configuration/configuration#Metadata-author).",
"type": [
"null",
"string"
]
},
"mimeTypes": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "The mime types in addition to specified in the file associations. Use it if you don't want to register a new mime type, but reuse existing."
},
"packageCategory": {
"description": "backward compatibility + to allow specify fpm-only category for all possible fpm targets in one place",
"type": [
"null",
"string"
]
},
"protocols": {
"anyOf": [
{
"$ref": "#/definitions/Protocol"
},
{
"items": {
"$ref": "#/definitions/Protocol"
},
"type": "array"
}
],
"description": "The URL protocol schemes."
},
"publish": {
"anyOf": [
{
"$ref": "#/definitions/GithubOptions"
},
{
"$ref": "#/definitions/S3Options"
},
{
"$ref": "#/definitions/SpacesOptions"
},
{
"$ref": "#/definitions/GenericServerOptions"
},
{
"$ref": "#/definitions/BintrayOptions"
},
{
"$ref": "#/definitions/CustomPublishOptions"
},
{
"$ref": "#/definitions/SnapStoreOptions"
},
{
"items": {
"anyOf": [
{
"$ref": "#/definitions/GithubOptions"
},
{
"$ref": "#/definitions/S3Options"
},
{
"$ref": "#/definitions/SpacesOptions"
},
{
"$ref": "#/definitions/GenericServerOptions"
},
{
"$ref": "#/definitions/BintrayOptions"
},
{
"$ref": "#/definitions/CustomPublishOptions"
},
{
"$ref": "#/definitions/SnapStoreOptions"