tauri/tooling/cli.rs/schema.json

1486 lines
43 KiB
JSON
Raw Normal View History

{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "Config",
"description": "The tauri.conf.json mapper.",
"type": "object",
"properties": {
"build": {
"description": "The build configuration.",
"default": {
"devPath": "",
"distDir": "../dist",
"withGlobalTauri": false
},
"allOf": [
{
"$ref": "#/definitions/BuildConfig"
}
]
},
"package": {
"description": "Package settings.",
"default": {},
"allOf": [
{
"$ref": "#/definitions/PackageConfig"
}
]
},
"plugins": {
"description": "The plugins config.",
"default": {},
"allOf": [
{
"$ref": "#/definitions/PluginConfig"
}
]
},
"tauri": {
"description": "The Tauri configuration.",
"default": {
"allowlist": {
"all": false,
"dialog": {
"all": false,
"open": false,
"save": false
},
"fs": {
"all": false,
"copyFile": false,
"createDir": false,
"readBinaryFile": false,
"readDir": false,
"readTextFile": false,
"removeDir": false,
"removeFile": false,
"renameFile": false,
"writeBinaryFile": false,
"writeFile": false
},
"globalShortcut": {
"all": false
},
"http": {
"all": false,
"request": false
},
"notification": {
"all": false
},
"os": {
"all": false
},
"path": {
"all": false
},
"shell": {
"all": false,
"execute": false,
"open": false
},
"window": {
"all": false,
"create": false
}
},
"bundle": {
"active": false,
"deb": {
"files": {},
"useBootstrapper": false
},
"macOS": {
"useBootstrapper": false
},
"windows": {
"certificateThumbprint": null,
"digestAlgorithm": null,
"timestampUrl": null,
"wix": null
}
},
"updater": {
"active": false
},
"windows": []
},
"allOf": [
{
"$ref": "#/definitions/TauriConfig"
}
]
}
},
"additionalProperties": false,
"definitions": {
"AllowlistConfig": {
"type": "object",
"properties": {
"all": {
"description": "Use this flag to enable all API features.",
"default": false,
"type": "boolean"
},
"dialog": {
"description": "Dialog API allowlist.",
"default": {
"all": false,
"open": false,
"save": false
},
"allOf": [
{
"$ref": "#/definitions/DialogAllowlistConfig"
}
]
},
"fs": {
"description": "File system API allowlist.",
"default": {
"all": false,
"copyFile": false,
"createDir": false,
"readBinaryFile": false,
"readDir": false,
"readTextFile": false,
"removeDir": false,
"removeFile": false,
"renameFile": false,
"writeBinaryFile": false,
"writeFile": false
},
"allOf": [
{
"$ref": "#/definitions/FsAllowlistConfig"
}
]
},
"globalShortcut": {
"description": "Global shortcut API allowlist.",
"default": {
"all": false
},
"allOf": [
{
"$ref": "#/definitions/GlobalShortcutAllowlistConfig"
}
]
},
"http": {
"description": "HTTP API allowlist.",
"default": {
"all": false,
"request": false
},
"allOf": [
{
"$ref": "#/definitions/HttpAllowlistConfig"
}
]
},
"notification": {
"description": "Notification API allowlist.",
"default": {
"all": false
},
"allOf": [
{
"$ref": "#/definitions/NotificationAllowlistConfig"
}
]
},
"os": {
"description": "OS allowlist.",
"default": {
"all": false
},
"allOf": [
{
"$ref": "#/definitions/OsAllowlistConfig"
}
]
},
"path": {
"description": "Path API allowlist.",
"default": {
"all": false
},
"allOf": [
{
"$ref": "#/definitions/PathAllowlistConfig"
}
]
},
"shell": {
"description": "Shell API allowlist.",
"default": {
"all": false,
"execute": false,
"open": false
},
"allOf": [
{
"$ref": "#/definitions/ShellAllowlistConfig"
}
]
},
"window": {
"description": "Window API allowlist.",
"default": {
"all": false,
"create": false
},
"allOf": [
{
"$ref": "#/definitions/WindowAllowlistConfig"
}
]
}
},
"additionalProperties": false
},
"AppUrl": {
"description": "The `dev_path` and `dist_dir` options.",
"anyOf": [
{
"description": "The app's external URL, or the path to the directory containing the app assets.",
"type": "string"
},
{
"description": "An array of files to embed on the app.",
"type": "array",
"items": {
"type": "string"
}
}
]
},
"BuildConfig": {
"description": "The Build configuration object.",
"type": "object",
"properties": {
"beforeBuildCommand": {
"description": "A shell command to run before `tauri build` kicks in.\n\nThe PLATFORM, ARCH, FAMILY, PLATFORM_TYPE and TAURI_DEBUG environment variables are set if you perform conditional compilation.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"beforeDevCommand": {
"description": "A shell command to run before `tauri dev` kicks in.\n\nThe PLATFORM, ARCH, FAMILY, PLATFORM_TYPE and TAURI_DEBUG environment variables are set if you perform conditional compilation.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"devPath": {
"description": "The path or URL to use on development.",
"default": "",
"allOf": [
{
"$ref": "#/definitions/AppUrl"
}
]
},
"distDir": {
"description": "The path to the app's dist dir. This path must contain your index.html file.",
"default": "../dist",
"allOf": [
{
"$ref": "#/definitions/AppUrl"
}
]
},
"features": {
"description": "Features passed to `cargo` commands.",
2021-07-04 05:49:01 +03:00
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"runner": {
"description": "The binary used to build and run the application.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"withGlobalTauri": {
"description": "Whether we should inject the Tauri API on `window.__TAURI__` or not.",
"default": false,
"type": "boolean"
}
},
"additionalProperties": false
},
"BundleConfig": {
"type": "object",
"properties": {
"active": {
"description": "Whether we should build your app with tauri-bundler or plain `cargo build`",
"default": false,
"type": "boolean"
},
"category": {
"description": "The application kind.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"copyright": {
"description": "A copyright string associated with your application.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"deb": {
"description": "Configuration for the Debian bundle.",
"default": {
"files": {},
"useBootstrapper": false
},
"allOf": [
{
"$ref": "#/definitions/DebConfig"
}
]
},
"externalBin": {
"description": "A list of—either absolute or relative—paths to binaries to embed with your application.\n\nNote that Tauri will look for system-specific binaries following the pattern \"binary-name{-target-triple}{.system-extension}\".\n\nE.g. for the external binary \"my-binary\", Tauri looks for:\n\n- \"my-binary-x86_64-pc-windows-msvc.exe\" for Windows - \"my-binary-x86_64-apple-darwin\" for macOS - \"my-binary-x86_64-unknown-linux-gnu\" for Linux\n\nso don't forget to provide binaries for all targeted platforms.",
2021-07-04 05:49:01 +03:00
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"icon": {
"description": "The app's icons",
2021-07-04 05:49:01 +03:00
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"identifier": {
"description": "The app's identifier",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"longDescription": {
"description": "A longer, multi-line description of the application.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"macOS": {
"description": "Configuration for the macOS bundles.",
"default": {
"useBootstrapper": false
},
"allOf": [
{
"$ref": "#/definitions/MacConfig"
}
]
},
"resources": {
"description": "App resources to bundle. Each resource is a path to a file or directory. Glob patterns are supported.",
2021-07-04 05:49:01 +03:00
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"shortDescription": {
"description": "A short description of your application.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"targets": {
"description": "The bundle targets, currently supports [\"deb\", \"app\", \"msi\", \"appimage\", \"dmg\"] or \"all\"",
"anyOf": [
{
"$ref": "#/definitions/BundleTarget"
},
{
"type": "null"
}
]
},
"windows": {
"description": "Configuration for the Windows bundle.",
"default": {
"certificateThumbprint": null,
"digestAlgorithm": null,
"timestampUrl": null,
"wix": null
},
"allOf": [
{
"$ref": "#/definitions/WindowsConfig"
}
]
}
},
"additionalProperties": false
},
"BundleTarget": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
]
},
"CliArg": {
"description": "A CLI argument definition",
"type": "object",
2021-07-04 05:49:01 +03:00
"required": [
"name"
],
"properties": {
"conflictsWith": {
"description": "Sets a conflicting argument by name i.e. when using this argument, the following argument can't be present and vice versa.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"conflictsWithAll": {
"description": "The same as conflictsWith but allows specifying multiple two-way conflicts per argument.",
2021-07-04 05:49:01 +03:00
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"description": {
"description": "The argument description which will be shown on the help information. Typically, this is a short (one line) description of the arg.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"index": {
"description": "The positional argument index, starting at 1.\n\nThe index refers to position according to other positional argument. It does not define position in the argument list as a whole. When utilized with multiple=true, only the last positional argument may be defined as multiple (i.e. the one with the highest index).",
2021-07-04 05:49:01 +03:00
"type": [
"integer",
"null"
],
"format": "uint64",
"minimum": 0.0
},
"longDescription": {
"description": "The argument long description which will be shown on the help information. Typically this a more detailed (multi-line) message that describes the argument.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"maxValues": {
"description": "Specifies the maximum number of values are for this argument. For example, if you had a -f <file> argument where you wanted up to 3 'files', you would set .max_values(3), and this argument would be satisfied if the user provided, 1, 2, or 3 values.",
2021-07-04 05:49:01 +03:00
"type": [
"integer",
"null"
],
"format": "uint64",
"minimum": 0.0
},
"minValues": {
"description": "Specifies the minimum number of values for this argument. For example, if you had a -f <file> argument where you wanted at least 2 'files', you would set `minValues: 2`, and this argument would be satisfied if the user provided, 2 or more values.",
2021-07-04 05:49:01 +03:00
"type": [
"integer",
"null"
],
"format": "uint64",
"minimum": 0.0
},
"multiple": {
"description": "Specifies that the argument may appear more than once.\n\n- For flags, this results in the number of occurrences of the flag being recorded. For example -ddd or -d -d -d would count as three occurrences. - For options there is a distinct difference in multiple occurrences vs multiple values. For example, --opt val1 val2 is one occurrence, but two values. Whereas --opt val1 --opt val2 is two occurrences.",
2021-07-04 05:49:01 +03:00
"type": [
"boolean",
"null"
]
},
"multipleOccurrences": {
"description": "specifies that the argument may appear more than once.",
2021-07-04 05:49:01 +03:00
"type": [
"boolean",
"null"
]
},
"name": {
"description": "The unique argument name",
"type": "string"
},
"numberOfValues": {
2021-07-04 05:49:01 +03:00
"type": [
"integer",
"null"
],
"format": "uint64",
"minimum": 0.0
},
"possibleValues": {
"description": "Specifies a list of possible values for this argument. At runtime, the CLI verifies that only one of the specified values was used, or fails with an error message.",
2021-07-04 05:49:01 +03:00
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"requireEquals": {
"description": "Requires that options use the --option=val syntax i.e. an equals between the option and associated value.",
2021-07-04 05:49:01 +03:00
"type": [
"boolean",
"null"
]
},
"required": {
"description": "Sets whether or not the argument is required by default.\n\n- Required by default means it is required, when no other conflicting rules have been evaluated - Conflicting rules take precedence over being required.",
2021-07-04 05:49:01 +03:00
"type": [
"boolean",
"null"
]
},
"requiredIfEq": {
"description": "Allows specifying that an argument is required conditionally with the signature [arg, value] the requirement will only become valid if the `arg`'s value equals `${value}`.",
2021-07-04 05:49:01 +03:00
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"requiredUnlessPresent": {
"description": "Sets an arg that override this arg's required setting i.e. this arg will be required unless this other argument is present.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"requiredUnlessPresentAll": {
"description": "Sets args that override this arg's required setting i.e. this arg will be required unless all these other arguments are present.",
2021-07-04 05:49:01 +03:00
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"requiredUnlessPresentAny": {
"description": "Sets args that override this arg's required setting i.e. this arg will be required unless at least one of these other arguments are present.",
2021-07-04 05:49:01 +03:00
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"requires": {
"description": "Tets an argument by name that is required when this one is present i.e. when using this argument, the following argument must be present.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"requiresAll": {
"description": "Sts multiple arguments by names that are required when this one is present i.e. when using this argument, the following arguments must be present.",
2021-07-04 05:49:01 +03:00
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"requiresIf": {
"description": "Allows a conditional requirement with the signature [arg, value] the requirement will only become valid if `arg`'s value equals `${value}`.",
2021-07-04 05:49:01 +03:00
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"short": {
"description": "The short version of the argument, without the preceding -.\n\nNOTE: Any leading - characters will be stripped, and only the first non - character will be used as the short version.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
],
"maxLength": 1,
"minLength": 1
},
"takesValue": {
"description": "Specifies that the argument takes a value at run time.\n\nNOTE: values for arguments may be specified in any of the following methods - Using a space such as -o value or --option value - Using an equals and no space such as -o=value or --option=value - Use a short and no space such as -ovalue",
2021-07-04 05:49:01 +03:00
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
},
"CliConfig": {
"description": "describes a CLI configuration",
"type": "object",
"properties": {
"afterHelp": {
"description": "adds additional help information to be displayed in addition to auto-generated help this information is displayed after the auto-generated help information this is often used to describe how to use the arguments, or caveats to be noted.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"args": {
"description": "list of args for the command",
2021-07-04 05:49:01 +03:00
"type": [
"array",
"null"
],
"items": {
"$ref": "#/definitions/CliArg"
}
},
"beforeHelp": {
"description": "adds additional help information to be displayed in addition to auto-generated help this information is displayed before the auto-generated help information. this is often used for header information",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"description": {
"description": "command description which will be shown on the help information",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"longDescription": {
"description": "command long description which will be shown on the help information",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"subcommands": {
"description": "list of subcommands of this command.\n\nsubcommands are effectively sub-apps, because they can contain their own arguments, subcommands, usage, etc. they also function just like the app command, in that they get their own auto generated help and usage",
2021-07-04 05:49:01 +03:00
"type": [
"object",
"null"
],
"additionalProperties": {
"$ref": "#/definitions/CliConfig"
}
}
},
"additionalProperties": false
},
"DebConfig": {
"type": "object",
"properties": {
"depends": {
"description": "The list of deb dependencies your application relies on.",
2021-07-04 05:49:01 +03:00
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"files": {
"description": "The files to include on the package.",
"default": {},
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"useBootstrapper": {
"description": "Enable the boostrapper script.",
"default": false,
"type": "boolean"
}
},
"additionalProperties": false
},
"DialogAllowlistConfig": {
"type": "object",
"properties": {
"all": {
"description": "Use this flag to enable all dialog API features.",
"default": false,
"type": "boolean"
},
"open": {
"description": "Open dialog window to pick files.",
"default": false,
"type": "boolean"
},
"save": {
"description": "Open dialog window to pick where to save files.",
"default": false,
"type": "boolean"
}
},
"additionalProperties": false
},
"FsAllowlistConfig": {
"type": "object",
"properties": {
"all": {
"description": "Use this flag to enable all file system API features.",
"default": false,
"type": "boolean"
},
"copyFile": {
"description": "Copy file from local filesystem.",
"default": false,
"type": "boolean"
},
"createDir": {
"description": "Create directory from local filesystem.",
"default": false,
"type": "boolean"
},
"readBinaryFile": {
"description": "Read binary file from local filesystem.",
"default": false,
"type": "boolean"
},
"readDir": {
"description": "Read directory from local filesystem.",
"default": false,
"type": "boolean"
},
"readTextFile": {
"description": "Read text file from local filesystem.",
"default": false,
"type": "boolean"
},
"removeDir": {
"description": "Remove directory from local filesystem.",
"default": false,
"type": "boolean"
},
"removeFile": {
"description": "Remove file from local filesystem.",
"default": false,
"type": "boolean"
},
"renameFile": {
"description": "Rename file from local filesystem.",
"default": false,
"type": "boolean"
},
"writeBinaryFile": {
"description": "Write binary file to local filesystem.",
"default": false,
"type": "boolean"
},
"writeFile": {
"description": "Write text file to local filesystem.",
"default": false,
"type": "boolean"
}
},
"additionalProperties": false
},
"GlobalShortcutAllowlistConfig": {
"type": "object",
"properties": {
"all": {
"description": "Use this flag to enable all global shortcut API features.",
"default": false,
"type": "boolean"
}
},
"additionalProperties": false
},
"HttpAllowlistConfig": {
"type": "object",
"properties": {
"all": {
"description": "Use this flag to enable all HTTP API features.",
"default": false,
"type": "boolean"
},
"request": {
"description": "Allows making HTTP requests.",
"default": false,
"type": "boolean"
}
},
"additionalProperties": false
},
"MacConfig": {
"type": "object",
"properties": {
"entitlements": {
"description": "Path to the entitlements file.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"exceptionDomain": {
"description": "Allows your application to communicate with the outside world. It should be a lowercase, without port and protocol domain name.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"frameworks": {
"description": "A list of strings indicating any macOS X frameworks that need to be bundled with the application.\n\nIf a name is used, \".framework\" must be omitted and it will look for standard install locations. You may also use a path to a specific framework.",
2021-07-04 05:49:01 +03:00
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"license": {
"description": "The path to the license file to add to the DMG bundle.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"minimumSystemVersion": {
"description": "A version string indicating the minimum macOS X version that the bundled application supports.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"signingIdentity": {
"description": "Identity to use for code signing.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"useBootstrapper": {
"description": "Enable the boostrapper script.",
"default": false,
"type": "boolean"
}
},
"additionalProperties": false
},
"NotificationAllowlistConfig": {
"type": "object",
"properties": {
"all": {
"description": "Use this flag to enable all notification API features.",
"default": false,
"type": "boolean"
}
},
"additionalProperties": false
},
"OsAllowlistConfig": {
"type": "object",
"properties": {
"all": {
"description": "Use this flag to enable all OS API features.",
"default": false,
"type": "boolean"
}
},
"additionalProperties": false
},
"PackageConfig": {
"type": "object",
"properties": {
"productName": {
"description": "Application name. Automatically converted to kebab-case on Linux.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"version": {
"description": "Application version.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"PathAllowlistConfig": {
"type": "object",
"properties": {
"all": {
"description": "Use this flag to enable all path API features.",
"default": false,
"type": "boolean"
}
},
"additionalProperties": false
},
"PluginConfig": {
"description": "The plugin configs holds a HashMap mapping a plugin name to its configuration object.",
"type": "object",
"additionalProperties": true
},
"SecurityConfig": {
"type": "object",
"properties": {
"csp": {
"description": "The Content Security Policy that will be injected on all HTML files.\n\nThis is a really important part of the configuration since it helps you ensure your WebView is secured. See https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"ShellAllowlistConfig": {
"type": "object",
"properties": {
"all": {
"description": "Use this flag to enable all shell API features.",
"default": false,
"type": "boolean"
},
"execute": {
"description": "Enable binary execution.",
"default": false,
"type": "boolean"
},
"open": {
"description": "Open URL with the user's default application.",
"default": false,
"type": "boolean"
}
},
"additionalProperties": false
},
"SystemTrayConfig": {
"type": "object",
2021-07-04 05:49:01 +03:00
"required": [
"iconPath"
],
"properties": {
"iconAsTemplate": {
"description": "A Boolean value that determines whether the image represents a [template](https://developer.apple.com/documentation/appkit/nsimage/1520017-template?language=objc) image on macOS.",
"default": false,
"type": "boolean"
},
"iconPath": {
"description": "Path to the icon to use on the system tray.\n\nIt is forced to be a `.png` file on Linux and macOS, and a `.ico` file on Windows.",
"type": "string"
}
},
"additionalProperties": false
},
"TauriConfig": {
"description": "The Tauri configuration object.",
"type": "object",
"properties": {
"allowlist": {
"description": "The allowlist configuration.",
"default": {
"all": false,
"dialog": {
"all": false,
"open": false,
"save": false
},
"fs": {
"all": false,
"copyFile": false,
"createDir": false,
"readBinaryFile": false,
"readDir": false,
"readTextFile": false,
"removeDir": false,
"removeFile": false,
"renameFile": false,
"writeBinaryFile": false,
"writeFile": false
},
"globalShortcut": {
"all": false
},
"http": {
"all": false,
"request": false
},
"notification": {
"all": false
},
"os": {
"all": false
},
"path": {
"all": false
},
"shell": {
"all": false,
"execute": false,
"open": false
},
"window": {
"all": false,
"create": false
}
},
"allOf": [
{
"$ref": "#/definitions/AllowlistConfig"
}
]
},
"bundle": {
"description": "The bundler configuration.",
"default": {
"active": false,
"deb": {
"files": {},
"useBootstrapper": false
},
"macOS": {
"useBootstrapper": false
},
"windows": {
"certificateThumbprint": null,
"digestAlgorithm": null,
"timestampUrl": null,
"wix": null
}
},
"allOf": [
{
"$ref": "#/definitions/BundleConfig"
}
]
},
"cli": {
"description": "The CLI configuration.",
"anyOf": [
{
"$ref": "#/definitions/CliConfig"
},
{
"type": "null"
}
]
},
"security": {
"description": "Security configuration.",
"anyOf": [
{
"$ref": "#/definitions/SecurityConfig"
},
{
"type": "null"
}
]
},
"systemTray": {
"description": "Configuration for app system tray.",
"anyOf": [
{
"$ref": "#/definitions/SystemTrayConfig"
},
{
"type": "null"
}
]
},
"updater": {
"description": "The updater configuration.",
"default": {
"active": false,
"dialog": true
},
"allOf": [
{
"$ref": "#/definitions/UpdaterConfig"
}
]
},
"windows": {
"description": "The windows configuration.",
"default": [],
"type": "array",
"items": {
"$ref": "#/definitions/WindowConfig"
}
}
},
"additionalProperties": false
},
"UpdaterConfig": {
"type": "object",
"properties": {
"active": {
"description": "Whether the updater is active or not.",
"default": false,
"type": "boolean"
},
"dialog": {
"description": "Display built-in dialog or use event system if disabled.",
"default": true,
2021-07-04 05:49:01 +03:00
"type": [
"boolean",
"null"
]
},
"endpoints": {
"description": "The updater endpoints.",
2021-07-04 05:49:01 +03:00
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"pubkey": {
"description": "Optional pubkey.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"WindowAllowlistConfig": {
"type": "object",
"properties": {
"all": {
"description": "Use this flag to enable all window API features.",
"default": false,
"type": "boolean"
},
"create": {
"description": "Allows dynamic window creation.",
"default": false,
"type": "boolean"
}
},
"additionalProperties": false
},
"WindowConfig": {
"description": "The window configuration object.",
"type": "object",
"properties": {
"alwaysOnTop": {
"description": "Whether the window should always be on top of other windows.",
"default": false,
"type": "boolean"
},
"center": {
"description": "Whether or not the window starts centered or not.",
"default": false,
"type": "boolean"
},
"decorations": {
"description": "Whether the window should have borders and bars.",
"default": true,
"type": "boolean"
},
"fileDropEnabled": {
"description": "Whether the file drop is enabled or not on the webview. By default it is enabled.\n\nDisabling it is required to use drag and drop on the frontend on Windows.",
"default": true,
"type": "boolean"
},
"focus": {
"description": "Whether the window will be initially hidden or focused.",
"default": true,
"type": "boolean"
},
"fullscreen": {
"description": "Whether the window starts as fullscreen or not.",
"default": false,
"type": "boolean"
},
"height": {
"description": "The window height.",
2021-07-04 05:49:01 +03:00
"type": [
"number",
"null"
],
"format": "double"
},
"label": {
"description": "The window identifier.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"maxHeight": {
"description": "The max window height.",
2021-07-04 05:49:01 +03:00
"type": [
"number",
"null"
],
"format": "double"
},
"maxWidth": {
"description": "The max window width.",
2021-07-04 05:49:01 +03:00
"type": [
"number",
"null"
],
"format": "double"
},
"maximized": {
"description": "Whether the window is maximized or not.",
"default": false,
"type": "boolean"
},
"minHeight": {
"description": "The min window height.",
2021-07-04 05:49:01 +03:00
"type": [
"number",
"null"
],
"format": "double"
},
"minWidth": {
"description": "The min window width.",
2021-07-04 05:49:01 +03:00
"type": [
"number",
"null"
],
"format": "double"
},
"resizable": {
"description": "Whether the window is resizable or not.",
"default": false,
"type": "boolean"
},
"skipTaskbar": {
"description": "Whether or not the window icon should be added to the taskbar.",
"default": false,
"type": "boolean"
},
"title": {
"description": "The window title.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"transparent": {
"description": "Whether the window is transparent or not.",
"default": false,
"type": "boolean"
},
"url": {
"description": "The window webview URL.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"visible": {
"description": "Whether the window is visible or not.",
"default": true,
"type": "boolean"
},
"width": {
"description": "The window width.",
2021-07-04 05:49:01 +03:00
"type": [
"number",
"null"
],
"format": "double"
},
"x": {
"description": "The horizontal position of the window's top left corner",
2021-07-04 05:49:01 +03:00
"type": [
"number",
"null"
],
"format": "double"
},
"y": {
"description": "The vertical position of the window's top left corner",
2021-07-04 05:49:01 +03:00
"type": [
"number",
"null"
],
"format": "double"
}
},
"additionalProperties": false
},
"WindowsConfig": {
"type": "object",
"properties": {
"certificateThumbprint": {
"description": "Specifies the SHA1 hash of the signing certificate.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"digestAlgorithm": {
"description": "Specifies the file digest algorithm to use for creating file signatures. Required for code signing. SHA-256 is recommended.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"timestampUrl": {
"description": "Server to use during timestamping.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"wix": {
"description": "Configuration for the MSI generated with WiX.",
"anyOf": [
{
"$ref": "#/definitions/WixConfig"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"WixConfig": {
"type": "object",
"properties": {
"bannerPath": {
"description": "Path to a bitmap file to use as the installation user interface banner. This bitmap will appear at the top of all but the first page of the installer.\n\nThe required dimensions are 493px × 58px.",
"type": [
"string",
"null"
]
},
"componentGroupRefs": {
"description": "The ComponentGroup element ids you want to reference from the fragments.",
"default": [],
"type": "array",
"items": {
"type": "string"
}
},
"componentRefs": {
"description": "The Component element ids you want to reference from the fragments.",
"default": [],
"type": "array",
"items": {
"type": "string"
}
},
"dialogImagePath": {
"description": "Path to a bitmap file to use on the installation user interface dialogs. It is used on the welcome and completion dialogs. The required dimensions are 493px × 312px.",
"type": [
"string",
"null"
]
},
"enableElevatedUpdateTask": {
"default": false,
"type": "boolean"
},
"featureGroupRefs": {
"description": "The FeatureGroup element ids you want to reference from the fragments.",
"default": [],
"type": "array",
"items": {
"type": "string"
}
},
"featureRefs": {
"description": "The Feature element ids you want to reference from the fragments.",
"default": [],
"type": "array",
"items": {
"type": "string"
}
},
"fragmentPaths": {
"description": "A list of paths to .wxs files with WiX fragments to use.",
"default": [],
"type": "array",
"items": {
"type": "string"
}
},
"language": {
"description": "The installer language. See https://docs.microsoft.com/en-us/windows/win32/msi/localizing-the-error-and-actiontext-tables.",
"default": "en-US",
"type": "string"
},
"license": {
"description": "The path to the license file to render on the installer.\n\nMust be an RTF file, so if a different extension is provided, we convert it to the RTF format.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
},
"mergeRefs": {
"description": "The Merge element ids you want to reference from the fragments.",
"default": [],
"type": "array",
"items": {
"type": "string"
}
},
"skipWebviewInstall": {
"description": "Disables the Webview2 runtime installation after app install.",
"default": false,
"type": "boolean"
},
"template": {
"description": "A custom .wxs template to use.",
2021-07-04 05:49:01 +03:00
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
}
2021-07-04 05:49:01 +03:00
}