Expected return codes

[denelon]

Description of the new feature/enhancement

Some .exe installers provide return error codes for known reasons on install. These aren't exactly the same as "SuccessCodes" because the install didn't complete, but they aren't necessarily catastrophic failures either.

We would like to be able to have standard known error messages that can be easily understood and localized for these installers.

Proposed technical implementation details (optional)

The Windows Package Manager would have an enumeration of responses to be localized for mapping to specific return codes from installers.

For example some packages return error codes indicating the program is in use and should be exited before install.

OBS Studio returns "5" when the package is already running.

Installers:
  - InstallerType: exe
    InstallerArchitecture: x64
    InstallerSHA256: 12341234123412341234123412341234123412341234
    InstallerURL: https://www.contoso.com/awesomeapp/1.0.0/awesomeapp.x64.exe
    EpectedReturnCodes:
      - InstallerReturnCode: 5
        ReturnResponse: PACKAGE_IN_USE

[denelon]

This will not be supported fully until the validation pipelines accept the 1.1 schema.

winget-cli/schemas/JSON/manifests/v1.1.0/manifest.installer.1.1.0.json

Lines 154 to 186 in 5a97e26

	"ExpectedReturnCodes": {
	"type": [ "array", "null" ],
	"items": {
	"type": "object",
	"properties": {
	"InstallerReturnCode": {
	"$ref": "#/definitions/InstallerReturnCode"
	},
	"ReturnResponse": {
	"type": "string",
	"enum": [
	"packageInUse",
	"installInProgress",
	"fileInUse",
	"missingDependency",
	"diskFull",
	"insufficientMemory",
	"noNetwork",
	"contactSupport",
	"rebootRequiredToFinish",
	"rebootRequiredForInstall",
	"rebootInitiated",
	"cancelledByUser",
	"alreadyInstalled",
	"downgrade",
	"blockedByPolicy"
	]
	}
	}
	},
	"maxItems": 128,
	"description": "Installer exit codes for common errors"
	},