diff --git a/.github/actions/spelling/allow.txt b/.github/actions/spelling/allow.txt index bd1b444151efd..02109d0775d3f 100644 --- a/.github/actions/spelling/allow.txt +++ b/.github/actions/spelling/allow.txt @@ -6,6 +6,7 @@ appsandfeaturesentries appwiz appx arp +authorable bcdboot checkboxes cla @@ -19,6 +20,7 @@ DISM dism distro dsc +DSCv Entra Esco ESRP @@ -76,6 +78,7 @@ rewinged Runtimes russellbanks screenshots +sixel Smartscreen ssh standalone diff --git a/doc/manifest/README.md b/doc/manifest/README.md index 09c8aef751c3d..64b014491ec43 100644 --- a/doc/manifest/README.md +++ b/doc/manifest/README.md @@ -8,6 +8,7 @@ As new releases of the WinGet client are developed with new features and functio The community repository will often delay support for new schema versions until enough devices have been updated so customers can benefit from the newly added manifest keys. Please use the recommended schema version mentioned in the PR template. ## Manifest Schema Versions +* [1.28.0](schema/1.28.0/README.md) * [1.12.0](schema/1.12.0/README.md) * [1.10.0](schema/1.10.0/README.md) * [1.9.0](schema/1.9.0/README.md) diff --git a/doc/manifest/schema/1.28.0/README.md b/doc/manifest/schema/1.28.0/README.md new file mode 100644 index 0000000000000..c3709e7d6f2bb --- /dev/null +++ b/doc/manifest/schema/1.28.0/README.md @@ -0,0 +1,70 @@ +[schemaFolder]: https://github.com/microsoft/winget-cli/tree/master/schemas/JSON/manifests/v1.28.0 +[versionSchema]: https://github.com/microsoft/winget-cli/tree/master/schemas/JSON/manifests/v1.28.0/manifest.version.1.28.0.json +[defaultLocaleSchema]: https://github.com/microsoft/winget-cli/tree/master/schemas/JSON/manifests/v1.28.0/manifest.defaultLocale.1.28.0.json +[localeSchema]: https://github.com/microsoft/winget-cli/tree/master/schemas/JSON/manifests/v1.28.0/manifest.locale.1.28.0.json +[installerSchema]: https://github.com/microsoft/winget-cli/tree/master/schemas/JSON/manifests/v1.28.0/manifest.installer.1.28.0.json +[Windows Package Manager Manifest Creator]: https://github.com/microsoft/winget-create +[YAML Create]: https://github.com/microsoft/winget-pkgs/blob/master/Tools/YamlCreate.ps1 + +# Windows Package Manager + +## Manifest Schema 1.28 + +The Windows Package Manager 1.28 client does not support all fields in the 1.28 schema. + +The Windows Package Manager uses manifests (YAML files) to locate and install packages for Windows users. This specification provides references to JSON schemas as well as best practices. + +Manifests submitted to the Windows Package Manager Community Repository should be submitted as a multi-file manifest. Only one version of a package may be submitted per pull request. The [singleton](singleton.md) manifest format is supported by the client, but has been deprecated in the community repository. Rich tooling exists to generate manifests. The [Windows Package Manager Manifest Creator] and [YAML Create] were both designed to produce well formed and rich manifests. + +A multi-file manifest contains: +* One [version](version.md) ([JSON Schema][versionSchema]) file +* One [default locale](defaultLocale.md) ([JSON Schema][defaultLocaleSchema]) file +* One [installer](installer.md) ([JSON Schema][installerSchema]) file +* Additional optional [locale](locale.md) ([JSON Schema][localeSchema]) files + +## YAML file name and folder structure +YAML files shall be added to the repository with the following folder structure: +manifests / p / publisher / package / packageVersion / publisher.package.<manifestFile>.yaml + +Example: +`manifests/m/Microsoft/WindowsTerminal/1.9.1942/Microsoft.WindowsTerminal.installer.yaml` + +* Manifests are partitioned by the first letter of the publisher name (in lower case). For example: m. +* Publisher folder is the name of the company that publishes the tool. For example: Microsoft. +* The child folder package is the name of the application or tool. For example: WindowsTerminal. +* The child folder package version is the version of the package. For example: 1.6.10571.0. +* The filename must be a combination of the publisher name and the application name. For example: Microsoft.WindowsTerminal.yaml. + +The publisher and application folders MUST match the values used to define the Id. See PackageIdentifier: in the YAML for more detail. +The version in the folder name MUST match the version field value in the YAML file. See PackageVersion: in the YAML for more detail. + +There are two primary types of manifests. A single file manifest (singleton) and a multi-file manifest. +[JSON schemas][schemaFolder] have been provided +to help strongly type attributes and requirements. + +## YAML Syntax +Each field in the file must be PascalCased and cannot be duplicated. + +## Best Practices +The package identifier must be unique. You cannot have multiple submissions with the same package identifier. Only one pull request per package version is allowed. + +Avoid creating multiple publisher folders. For example, do not create "Contoso Ltd." if there is already a "Contoso" folder. + +All tools must support a silent install to be permitted in the Windows Package Manager Community Repository. If you have an executable that does not support a silent install, then we cannot provide that tool at this time. + +Provide as many fields as possible. The more meta-data you provide the better the user experience will be. In some cases, the fields may not yet be supported by the Windows Package Manager client (winget.exe). + +The length of strings in this specification should be limited to 100 characters before a line break. + +## Summary of Changes from 1.12.0 + +### [Version](version.md) +* No Changes +### [Default Locale](defaultLocale.md) +* Added `Icons` + * NOTE: `Icons` is not an authorable field in the community repository. Icon metadata is populated by the validation pipelines during validation and cannot be added in pull requests. +### [Installer](installer.md) +* Added `DesiredStateConfiguration` +### [Locale](locale.md) +* Added `Icons` + * NOTE: `Icons` is not an authorable field in the community repository. Icon metadata is populated by the validation pipelines during validation and cannot be added in pull requests. diff --git a/doc/manifest/schema/1.28.0/defaultLocale.md b/doc/manifest/schema/1.28.0/defaultLocale.md new file mode 100644 index 0000000000000..94657425231b1 --- /dev/null +++ b/doc/manifest/schema/1.28.0/defaultLocale.md @@ -0,0 +1,387 @@ +[JSON schema]: https://github.com/microsoft/winget-cli/blob/master/schemas/JSON/manifests/v1.28.0/manifest.defaultLocale.1.28.0.json +[YAML]: https://yaml.org/spec/ +[semantic version]: https://semver.org +[Available languages for Windows]: https://docs.microsoft.com/windows-hardware/manufacture/desktop/available-language-packs-for-windows +[locales]: https://docs.microsoft.com/windows-hardware/manufacture/desktop/default-input-locales-for-windows-language-packs +[install]: https://docs.microsoft.com/windows/package-manager/winget/install +[list]: https://docs.microsoft.com/windows/package-manager/winget/list +[upgrade]: https://docs.microsoft.com/windows/package-manager/winget/upgrade +[uninstall-registry]: https://learn.microsoft.com/en-us/windows/win32/msi/uninstall-registry-key + +# Windows Package Manager +## Manifest Schema v1.28.0 Default Locale File + +All Windows Package Manager manifests in the Microsoft community repository are submitted using [YAML] syntax. A [JSON schema] is provided to aid authoring these files in editors, and in the other tooling related to the Windows Package Manager. This document provides detailed information regarding the usage of the YAML keys in the defaultLocale file for multi-file manifests. + +### Default Locale Manifest + +```YAML +PackageIdentifier: # The package unique identifier +PackageVersion: # The package version +PackageLocale: # The package meta-data locale +Publisher: # The publisher name +PublisherUrl: # Optional publisher home page +PublisherSupportUrl: # Optional publisher support page +PrivacyUrl: # Optional publisher privacy page +Author: # Optional author +PackageName: # The package name +PackageUrl: # Optional package home page +License: # The package license +LicenseUrl: # Optional package license page +Copyright: # Optional package copyright +CopyrightUrl: # Optional package copyright page +ShortDescription: # The short package description +Description: # Optional full package description +Moniker: # Optional most common package term +Tags: # Optional list of package terms +Agreements: # Optional package agreements + - AgreementLabel: # Optional agreement label + Agreement: # Optional agreement text + AgreementUrl: # Optional agreement URL +Documentations: # Optional documentation + - DocumentLabel: # Optional documentation label + DocumentUrl: # Optional documentation URL +ReleaseNotes: # Optional release notes +ReleaseNotesUrl: # Optional release notes URL +PurchaseUrl: # Optional purchase URL +InstallationNotes: # Optional notes displayed upon installation +ManifestType: defaultLocale # The manifest type +ManifestVersion: 1.28.0 # The manifest syntax version +``` + +## Fields + +
+ PackageIdentifier - The package unique identifier + + **Required Field** + + This key is the unique identifier for a given package. This value is generally in the form of `Publisher.Package`. It is case sensitive, and this value must match the folder structure under the partition directory in GitHub. +
+ +
+ PackageVersion - The package version + + **Required Field** + + This key represents the version of the package. It is related to the specific release this manifests targets. In some cases you will see a perfectly formed [semantic version] number, and in other cases you might see something different. These may be date driven, or they might have other characters with some package specific meaning for example. + + The Windows Package Manager client uses this version to determine whether or not an upgrade for a package is available. In some cases, packages may be released with a marketing driven version, and that causes trouble with the `winget upgrade` command. + + The current best practice for the Windows Package Manager 1.28 client is to use the value reported in Windows Apps & Features when this version of the package is installed. In some cases, packages do not report a version resulting in an upgrade loop or other unwanted behavior. +
+ +
+ PackageLocale - The package meta-data locale + + **Required Field** + + This key represents the locale for package meta-data. The format is BCP-47. This value identifies the language for meta-data to be displayed to a user when no locale file matching their preferences is available. The Microsoft community package repository validation pipelines also use this value to determine appropriate validation rules for this file. + + **References:** + +* [Available languages for Windows] +* [Default Input Profiles (Input Locales) in Windows][locales] + + NOTE: This field is the key to determining which fields are required for the Microsoft community repository. The default locale specified in the version file must match with this value. +
+ + +
+ Publisher - The publisher name + + **Required Field** + + This key represents the name of the publisher for a given package. This field is intended to allow the full publisher's or ISV's name to be displayed as they wish. + + NOTE: With the 1.28 release of the Windows Package Manager, this name affects how packages from a source are mapped to Apps installed in Windows 10 and Windows 11 via Add / Remove Programs (ARP) and Windows Apps & Features respectively. The best practice is to ensure this matches the entry for the package when it has been installed. This should be the value of the `Publisher` subkey for the package in the [Windows registry][uninstall-registry]. The impact is associated with `winget upgrade` and `winget list`. +
+ +
+ PublisherUrl - The publisher home page + + **Optional Field** + + This key represents the web site for the publisher or ISV. +
+ +
+ PublisherSupportUrl - The publisher support page + + **Optional Field** + + This key represents the customer support web site or specific web page provided by the publisher or ISV. +
+ +
+ PrivacyUrl - The publisher privacy page or the package privacy page + + **Optional Field** + + This key represents the privacy web site or specific web page provided the publisher or ISV. If there is a privacy web site or specific web page for the package it is preferred over a generic privacy page for the publisher. +
+ +
+ Author - The package author + + **Optional Field** + + This key represents the author of a package. In some cases, the author is an individual who develops and or maintains the package. In other cases this may be a URL pointing to the contributors web page for a package. +
+ +
+ PackageName - The package name + + **Required Field** + + This key represents the name of the package. This field is intended to allow the full package name to be displayed as the publisher or ISV wishes. + + NOTE: With the 1.28 release of the Windows Package Manager, this name affects how packages from a source are mapped to Apps installed in Windows 10 via Add / Remove Programs (ARP). The best practice is to ensure this matches the ARP entry for the package name when it has been installed. This should be the value of the `DisplayName` subkey for the package in the [Windows registry][uninstall-registry]. The impact is associated with `winget upgrade` and `winget list`. +
+ +
+ PackageUrl - The package home page + + **Optional Field** + + This key represents the web site for the package. +
+ +
+ License - The package license + + **Required Field** + + This key represents the license governing the use and or distribution for the product. This could be an open source license, or a commercial license. Please note that a copyright is not considered a license. If there is no available information on a product's license, "Proprietary" should be the value in this field. +
+ +
+ LicenseUrl - The license page + + **Optional Field** + + This key represents the license web site or specific web page provided the publisher or ISV. If there is a license web site or specific web page for the package it is preferred over a generic license page for the publisher. + + If this is a link to the license file for an open source project, it should be specific to the version for the package. Some open source projects change their license over time. +
+ +
+ Copyright - The package copyright + + **Optional Field** + + This key represents the copyright for the package. +
+ +
+ CopyrightUrl - The package copyright page + + **Optional Field** + + This key represents the copyright web site or specific web page provided the publisher or ISV. If there is a copyright web site or specific web page for the package it is preferred over a generic copyright page for the publisher. + + If this is a link to the copyright file for an open source project, it should be specific to the version for the package. Some open source projects change their copyright over time. +
+ +
+ ShortDescription - The short package description + + **Required Field** + + This key represents the description for a package. It is intended for use in `winget show` to help a user understand what the package is. + + The value must be at least 3 characters long, and at most 256 characters long. + + NOTE: This should be something descriptive about what the package does, and it should not simply state something like "<package name> installer" or "<package name> setup". +
+ +
+ Description - The full package description + + **Optional Field** + + This key represents the full or long description for a package. It is *not* currently used in the Windows Package Manager. + + NOTE: This was included for integration with the Microsoft Store source to provide the ability to display the full package description. +
+ +
+ Moniker - The most common package term + + **Optional Field** + + This key represents the most common term users would search for when installing or upgrading a package. If only one package uses this moniker, then the [install], [list] and [upgrade] command may match with this package. + + NOTE: Moniker is the third property evaluated when searching for a matching package. +
+ +
+ Tags - List of additional package search terms + + **Optional Field** + + This key represents other common term users would search for when looking for packages. Tags should be pertinent to what a user might search for when looking for a specific package. + + A maximum of 16 tags can be added. + + NOTE: The best practice is to present these terms in all lower case with hyphens rather than spaces. +
+ + +
+ Agreements - List of package agreements + + **Optional Field** + + This key holds any agreements a user must accept prior to download and subsequent install or upgrade. + + **Windows Package Manager Community Repository** + + Agreements are only allowed in the community repository when the manifest is maintained by a verified developer. +
+ +
+ AgreementLabel - The label for a package agreement + + **Optional Field** + + This key represents the label for a package agreement. +
+ +
+ Agreement - The text for a package agreement + + **Restricted Field** + + This key represents the text or body of a package agreement. +
+ +
+ AgreementUrl - The URL for a package agreement + + **Optional Field** + + This key represents the URL for a package agreement. +
+ +
+ Documentations - List of documentation + + **Optional Field** + + This key holds any documentation for providing software guides such as manuals and troubleshooting URLs. +
+ +
+ DocumentLabel - The documentation label + + **Optional Field** + + This key represents the label for a documentation. +
+ +
+ DocumentUrl - List of documentation + + **Optional Field** + + This key represents the URL for a documentation. +
+ +
+ ReleaseNotes - The Release Notes for a package. + + **Optional Field** + + This key represents release notes for a package. +
+ +
+ ReleaseNotesUrl - The Release Notes web page for a package. + + **Optional Field** + + This key represents release notes web page for a package. +
+ +
+ PurchaseUrl - The Purchase URL for a package. + + **Optional Field** + + This key represents the purchase url for acquiring entitlement for a package. +
+ +
+ InstallationNotes - The Installation Notes for a package. + + **Optional Field** + + This key represents the notes displayed to the user upon completion of a package installation. +
+ +
+ Icons - The icons for the package + + **Optional Field** + + NOTE: Icon metadata is populated during validation and is not authored in pull requests. When present, icons are rendered by the Windows Package Manager client when the sixel feature is enabled in [settings](https://github.com/microsoft/winget-cli/blob/master/doc/Settings.md#enablesixels). + + This key represents the icons for the package. +
+ +
+ IconUrl - The url of the hosted icon file + + **Required Field** + + This key represents the url of the hosted icon file. +
+ +
+ IconFileType - The type of the icon file + + **Required Field** + + This key represents the type of the icon file. Supported values are `png`, `jpeg`, and `ico`. +
+ +
+ IconResolution - The resolution of the icon + + **Optional Field** + + This key represents the resolution of the icon. +
+ +
+ IconTheme - The theme of the icon + + **Optional Field** + + This key represents the theme of the icon. +
+ +
+ IconSha256 - The SHA256 hash of the icon file + + **Optional Field** + + This key represents the SHA256 hash of the icon file. +
+ +
+ ManifestType - The manifest type + + **Required Field** + + This key must have the value "defaultLocale". The Microsoft community package repository validation pipelines also use this value to determine appropriate validation rules when evaluating this file. +
+ +
+ ManifestVersion - The manifest syntax version + + **Required Field** + + This key must have the value "1.28.0". The Microsoft community package repository validation pipelines also use this value to determine appropriate validation rules when evaluating this file. +
diff --git a/doc/manifest/schema/1.28.0/installer.md b/doc/manifest/schema/1.28.0/installer.md new file mode 100644 index 0000000000000..07bd9fd585f28 --- /dev/null +++ b/doc/manifest/schema/1.28.0/installer.md @@ -0,0 +1,1102 @@ +[JSON Schema]: https://github.com/microsoft/winget-cli/blob/master/schemas/JSON/manifests/v1.28.0/manifest.installer.1.28.0.json +[Windows Package Manager Manifest Creator]: https://github.com/microsoft/winget-create +[YAML]: https://yaml.org/spec +[semantic version]: https://semver.org +[`winget upgrade`]: https://docs.microsoft.com/windows/package-manager/winget/upgrade +[App capability declarations]: https://docs.microsoft.com/windows/uwp/packaging/app-capability-declarations +[package family name]: https://learn.microsoft.com/en-us/windows/apps/desktop/modernize/package-identity-overview#package-family-name +[product code]: https://learn.microsoft.com/en-us/windows/win32/msi/product-codes +[upgrade code]: https://learn.microsoft.com/en-us/windows/win32/msi/using-an-upgradecode +[uninstall-registry]: https://learn.microsoft.com/en-us/windows/win32/msi/uninstall-registry-key +[MSIX]: https://docs.microsoft.com/windows/msix/overview +[MSI]: https://docs.microsoft.com/windows/win32/msi/windows-installer-portal +[Inno]: https://jrsoftware.org/isinfo.php +[Nullsoft]: https://sourceforge.net/projects/nsis +[WiX]: https://wixtoolset.org +[Burn]: https://wixtoolset.org/docs/v3/bundle/ + +# Windows Package Manager + +## Manifest Schema v1.28.0 Installer File + +All Windows Package Manager manifests in the Microsoft community repository are submitted using [YAML] syntax. A [JSON schema] is provided to aid authoring these files in editors, and in the other tooling related to the Windows Package Manager. This document provides detailed information regarding the usage of the YAML keys in the installer file for multi-file manifests. + +> [!IMPORTANT] +> The 1.28 manifest schema was released with the Windows Package Manager 1.28. Any fields marked _Not implemented_ are not supported in the 1.28 client, but may be supported in newer versions of the client. + +### Installer Manifest + +```YAML +PackageIdentifier: # The package unique identifier +PackageVersion: # The package version +Channel: # *Not implemented* distribution channel +Installers: # The list of package installers + - Architecture: # The architecture of the installer + InstallerLocale: # Optional locale of the installer + Platform: # Optional installer supported operating system + MinimumOSVersion: # Optional installer minimum operating system version + InstallerType: # The installer type + InstallerUrl: # The installer URL + InstallerSha256: # The SHA256 hash of the installer + SignatureSha256: # Optional SHA256 hash of the MSIX signature + NestedInstallerType: # The installer type when InstallerType is an archive type + NestedInstallerFiles: # Details about the installers when InstallerType is an archive type + - RelativeFilePath: # The relative path to the nested installer file + PortableCommandAlias: # Optional command alias to be used for calling the package. Only applies when NestedInstallerType is 'portable' + Scope: # Optional installer scope + InstallModes: # Optional installer modes + InstallerSwitches: # Optional installer switches + Silent: # Optional installer switches for silent + SilentWithProgress: # Optional installer switches for silent with progress + Interactive: # Optional installer switches for interactive + InstallLocation: # Optional install location path + Log: # Optional installer log file path + Upgrade: # Optional installer switches for upgrade + Custom: # Optional installer switches for custom behavior + Repair: # Optional installer switches to use when repairing the package installation + UpgradeBehavior: # Optional upgrade method + Commands: # Optional commands or aliases to run the package + Protocols: # Optional list of protocols supported by the package + FileExtensions: # Optional list of file extensions supported by the package + Dependencies: # Optional list of dependencies required by the package + - ExternalDependencies: # *Not implemented* list of external dependencies + PackageDependencies: # Optional list of package dependencies + WindowsFeatures: # Optional list of Windows feature dependencies + WindowsLibraries: # *Not implemented* list of Windows library dependencies + PackageFamilyName: # Optional MSIX package family name + Capabilities: # Optional list of MSIX package capabilities + RestrictedCapabilities: # Optional list of MSIX package restricted capabilities + InstallerAbortsTerminal: # Optional indicator for packages that abort terminal + InstallLocationRequired: # Optional indicator for packages that require install location + RequireExplicitUpgrade: # Optional indicator for packages that upgrade themselves + ElevationRequirement: # Optional scope required to install package + UnsupportedOSArchitectures: # Optional architectures the package is not supported on + Markets: # Optional markets the package is allowed to be installed + ExcludedMarkets: # Optional markets the package is not allowed to be installed + InstallerSuccessCodes: # Optional non-zero installer success codes + ExpectedReturnCodes: # Optional non-zero installer return codes + - InstallerReturnCode: # Optional non-zero installer return code + ReturnResponse: # Optional response for an expected return code + ReturnResponseUrl: # Optional response URL for an expected return code + ProductCode: # Optional product code of the installer + AppsAndFeaturesEntries: # Optional entries from the Add and Remove Programs (ARP) table + - DisplayName: # Optional program name shown in the ARP entry + DisplayVersion: # Optional version displayed in the ARP entry + Publisher: # Optional publisher displayed in the ARP entry + ProductCode: # Optional product code of the installer + UpgradeCode: # Optional upgrade code of the installer + InstallerType: # Optional installer type + UnsupportedArguments: # Optional list of Windows Package Manager Client arguments the installer does not support + - UnsupportedArgument: # Optional unsupported Windows Package Manager Client argument + DisplayInstallWarnings: # *Not implemented* Optional indicator for packages that are known to interfere with running application during install + ReleaseDate: # Optional release date + InstallationMetadata: # Optional metadata for deeper installation detection + - DefaultInstallLocation: # Optional default install location for the package + Files: # Optional list of files installed by the package + - RelativeFilePath: # Optional relative path to the installed file + FileSha256: # Optional Sha256 of the installed file + FileType: # Optional installed file type. Treated as 'other' if not specified + InvocationParameter: # Optional parameter for invocable files + DisplayName: # Optional display name for invocable files + DownloadCommandProhibited: # Optional indicator for packages which cannot be downloaded for offline installation + RepairBehavior: # Optional repair method to use with 'winget repair` + ArchiveBinariesDependOnPath: # Optional indication to add the install location directly to PATH. Only applies to an archive containing portable packages + Authentication: # Authentication information for Entra Id secured private sources + AuthenticationType: # What type of authentication to use for Entra Id authentication + MicrosoftEntraIdAuthenticationInfo: # Information required for Entra Id authentication in private sources + Resource: # The resource to use for Microsoft Entra Id authentication + Scope: # The scope of Microsoft Entra Id authentication for the resource + DesiredStateConfiguration: # *Not implemented* References to desired state configuration (DSC) resources related to the package + PowerShell: # *Not implemented* DSC resources contained in PowerShell modules + - RepositoryUrl: # *Not implemented* The URL of the repository hosting the PowerShell module + ModuleName: # *Not implemented* The name of the PowerShell module containing the DSC resources + Resources: # *Not implemented* The DSC resources contained in the PowerShell module + - Name: # *Not implemented* The name of the PowerShell DSC resource + DSCv3: # *Not implemented* DSC resources contained in the package using the DSC v3 specification + Resources: # *Not implemented* The DSC v3 resources contained in the package + - Type: # *Not implemented* The fully qualified type name of the DSC v3 resource +ManifestType: installer # The manifest type +ManifestVersion: 1.28.0 # The manifest syntax version +``` + +### Installer Minimal Example + +Path: manifests/m/Microsoft/WindowsTerminal/1.9.1942/Microsoft.WindowsTerminal.installer.yaml + +```YAML +PackageIdentifier: Microsoft.WindowsTerminal +PackageVersion: 1.9.1942.0 +Installers: + - Architecture: x64 + InstallerType: msix + InstallerUrl: https://github.com/microsoft/terminal/releases/download/v1.9.1942.0/Microsoft.WindowsTerminal_1.9.1942.0_8wekyb3d8bbwe.msixbundle + InstallerSha256: 578D987D58B3CE5F6BF3316C6A5AECE8EB6B94DBCD1963413D81CB313D6C28D5 +ManifestType: installer +ManifestVersion: 1.28.0 +``` + +### Installer Complex Example + +Path: manifests/m/Microsoft/WindowsTerminal/1.9.1942/Microsoft.WindowsTerminal.installer.yaml + +```YAML +PackageIdentifier: Microsoft.WindowsTerminal +PackageVersion: 1.9.1942.0 +Platform: +- Windows.Desktop +MinimumOSVersion: 10.0.18362.0 +InstallerType: msix +InstallModes: +- silent +PackageFamilyName: Microsoft.WindowsTerminal_8wekyb3d8bbwe +Installers: +- Architecture: x64 + InstallerUrl: https://github.com/microsoft/terminal/releases/download/v1.9.1942.0/Microsoft.WindowsTerminal_1.9.1942.0_8wekyb3d8bbwe.msixbundle + InstallerSha256: 578D987D58B3CE5F6BF3316C6A5AECE8EB6B94DBCD1963413D81CB313D6C28D5 + SignatureSha256: 889A0BA756E74386F95A37F6A813C6D383DC21349A2D18E2B192D4E0E7F80659 +- Architecture: arm64 + InstallerUrl: https://github.com/microsoft/terminal/releases/download/v1.9.1942.0/Microsoft.WindowsTerminal_1.9.1942.0_8wekyb3d8bbwe.msixbundle + InstallerSha256: 578D987D58B3CE5F6BF3316C6A5AECE8EB6B94DBCD1963413D81CB313D6C28D5 + SignatureSha256: 889A0BA756E74386F95A37F6A813C6D383DC21349A2D18E2B192D4E0E7F80659 +- Architecture: x86 + InstallerUrl: https://github.com/microsoft/terminal/releases/download/v1.9.1942.0/Microsoft.WindowsTerminal_1.9.1942.0_8wekyb3d8bbwe.msixbundle + InstallerSha256: 578D987D58B3CE5F6BF3316C6A5AECE8EB6B94DBCD1963413D81CB313D6C28D5 + SignatureSha256: 889A0BA756E74386F95A37F6A813C6D383DC21349A2D18E2B192D4E0E7F80659 +ManifestType: installer +ManifestVersion: 1.28.0 +``` + +## Fields + +
+ PackageIdentifier - The package unique identifier + +**Required Field** + +This key is the unique identifier for a given package. This value is generally in the form of `Publisher.Package`. It is case sensitive, and this value must match the folder structure under the partition directory in GitHub. + +
+ +
+ PackageVersion - The package version + +**Required Field** + +This key represents the version of the package. It is related to the specific release this manifests targets. In some cases you will see a perfectly formed [semantic version] number, and in other cases you might see something different. These may be date driven, or they might have other characters with some package specific meaning for example. + +The Windows Package Manager client uses this version to determine if an upgrade for a package is available. In some cases, packages may be released with a marketing driven version, and that causes trouble with the [`winget upgrade`] command. + +NOTE: The current best practice is to use the value reported in Add / Remove Programs when this version of the package is installed. In some cases, packages do not report a version resulting in an upgrade loop or other unwanted behavior. This practice may seem contrary to using semantic versioning, but it provides the best end to end experience for customers. It will take time for publishers and ISVs to migrate to semantic versioning, and some may intentionally choose to preserve other versioning schemes. In these cases, it is best practice to include the "AppsAndFeaturesEntries" section for each installer. + +
+ +
+ Channel - The distribution channel + +**Optional Field** + +This key represents the distribution channel for a package. Examples may include "stable" or "beta". + +NOTE: This key is included for future use. The Windows Package Manager currently does not have any behavior associated with this key. The intent behind this key is to help disambiguate the different channels for packages lacking support for side by side installation. Some packages support having more than one package channel available on a system simultaneously; in this case it is better to use unique packages rather than channels. This key is intended to ensure the proper channel for a package is used during install and upgrade scenarios. + +
+ +
+ Installers - Package installer + +**Required Field** + +The key represents an installer for a package. + +IMPORTANT: Many of the keys related to installers may either be at the root level of the manifest, or included in an installer. Any values provided at the root level and not specified in an installer will be inherited. + +
+ +
+ Architecture - The installer target architecture + +**Required Field** + +This key represents the hardware architecture targeted by the installer. The Windows Package Manager will attempt to determine the best architecture to use. If emulation is available and the native hardware architecture does not have a supported installer, the emulated architecture may be used. + +Available architectures: + +- x86 +- x64 +- arm +- arm64 +- neutral + +
+ +
+ InstallerLocale - Locale for package installer + +**Optional Field** + +This key represents the locale for an installer _not_ the package meta-data. Some installers are compiled with locale or language specific properties. If this key is present, it is used to represent the package locale for an installer. + +NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. + +
+ +
+ Platform - The installer supported operating system + +**Optional Field** + +This key represents the Windows platform targeted by the installer. The Windows Package Manager currently supports "Windows.Desktop" and "Windows.Universal". The Windows Package Manager client currently has no behavior associated with this property. It was added for future looking scenarios. + +NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. + +
+ +
+ MinimumOSVersion - The installer minimum operating system version + +**Optional Field** + +This key represents the minimum version of the Windows operating system supported by the package. + +NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. + +
+ +
+ InstallerType - Enumeration of supported installer types. + +**Required Field** + +This key represents the installer type for the package. The Windows Package Manager supports [MSIX], [MSI], and executable installers. Some well known formats ([Inno], [Nullsoft], [WiX], and [Burn]) provide standard sets of installer switches to provide different installer experiences. Portable packages are supported as of Windows Package Manager 1.3. Zip packages are supported as of Windows Package Manager 1.5. + +InstallerType Font is supported as of Windows Package Manager 1.12. Font InstallerType includes the following types file extensions: .otf, .otc, .ttf, .ttc, and .fnt. + +IMPORTANT: The Windows Package Manager 1.28 does not support loose executables with the .com file extension directly. Progressive Web Applications (PWAs) and fonts are also not supported. + +NOTE: The Windows Package Manager defaults to the install mode providing install progress. A best practice is to determine if one of the supported installer technologies was used to build an installer with the .exe file extension. The [Windows Package Manager Manifest Creator] tool can be used to determine if one of the known tools was used to build an installer with the .exe file extension. + +NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. + +NOTE: Using InstallerType or NestedInstallerType Font requires that the manifest root be "fonts" in order to pass submission validation. Font installer types are not permitted to be included in the "manifests" root. This is not a technical limitation in the Windows Package Manager; this is a submission policy requirement. + +
+ +
+ InstallerUrl - The installer Url + +**Required Field** + +This key represents the URL to download the installer. + +
+ +
+ InstallerSha256 - Sha256 is required. Sha256 of the installer + +**Required Field** + +This key represents the SHA 256 hash for the installer. It is used to confirm the installer has not been modified. The Windows Package Manager will compare the hash in the manifest with the calculated hash of the installer after it has been downloaded. + +NOTE: The [Windows Package Manager Manifest Creator] can be used to determine the SHA 256 of the installer. The `winget hash <pathToInstaller>` command can also be used to determine the SHA 256 of the installer. + +
+ +
+ SignatureSha256 - SignatureSha256 is recommended for appx or msix. It is the sha256 of signature file inside appx or msix. Could be used during streaming install if applicable + +**Optional Field** + +This key represents the signature file (AppxSignature.p7x) inside an MSIX installer. It is used to provide streaming install for MSIX packages. + +IMPORTANT: MSIX installers must be signed to be included in the Microsoft community package repository. If the installer is an MSIX this signature should be included in the manifest. The [Windows Package Manager Manifest Creator] can be used to determine the signature SHA 256. The `winget hash --msix` command can also be used to determine the signature SHA 256. + +
+ +
+ NestedInstallerType - NestedInstallerType is required when InstallerType is an archive type such as '.zip' + +**Required Field** + +This key represents the installer type of the file within the archive which will be used as the installer. + +NestedInstallerType Font is supported as of Windows Package Manager 1.12. + +
+ +
+ NestedInstallerFiles - NestedInstallerFiles is required when InstallerType is an archive type such as '.zip' + +**Required Field** + +This key is a list of all the installers to be executed within an archive. + +IMPORTANT: This field can only contain one nested installer file unless the NestedInstallerType is 'portable' + +
+ +
+ RelativeFilePath - RelativeFilePath is required within NestedInstallerFiles + +**Required Field** + +The relative path to the installer file contained within the archive. + +
+ +
+ PortableCommandAlias - The command alias to be used for calling the package + +**Optional Field** + +The alias which is added to the PATH for calling the package from the command line. + +IMPORTANT: This field is only valid when NestedInstallerType is 'portable' + +
+ +
+ Scope - Scope indicates if the installer is per user or per machine + +**Optional Field** + +This key represents the scope the package is installed under. The two configurations are "user" and "machine". Some installers support only one of these scopes while others support both via arguments passed to the installer using "InstallerSwitches". + +NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. + +
+ +
+ InstallModes - List of supported installer modes + +**Optional Field** + +This key represents the install modes supported by the installer. The Microsoft community package repository requires a package support "silent" and "silent with progress". The Windows Package Manager also supports "interactive" installers. The Windows Package Manager client does not have any behavior associated with this key. + +IMPORTANT: Some installers will attempt to install missing dependencies. If these dependencies require user interaction, the package will not be allowed into the Microsoft community package repository. + +NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. + +
+ +
+ InstallerSwitches - Switches passed to installers + +**Optional Field** + +This key represents the set of switches passed to installers. + +**Windows Package Manager Community Repository** + +The Microsoft community repository currently requires support for silent and silent with progress installation. Many custom .exe installers will require the proper switches to meet this requirement. The [Windows Package Manager Manifest Creator] tool can be used to determine if one of the known tools was used to build an installer with the .exe file extension. In the event the tool is unable to determine the tool used to build the installer, the publisher may have documentation for the proper switches. + +
+ +
+ Silent - Silent is the value that should be passed to the installer when user chooses a silent or quiet install + +**Optional Field** + +This key represents switches passed to the installer to provide a silent install experience. These would be used when the command `winget install --silent` is executed. + +NOTE: When the Windows Package Manager installs a package using the "silent" install mode, any custom switches will also be passed to the installer. If a user applies override switches via command line via the Windows Package Manager, none of the switches from the manifest will be passed to the installer. + +NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. + +
+ +
+ SilentWithProgress - SilentWithProgress is the value that should be passed to the installer when user chooses a non-interactive install + +**Optional Field** + +This key represents switches passed to the installer to provide a silent with progress install experience. This is intended to allow a progress indication to the user, and the indication may come from an installer UI dialogue, but it must not require user interaction to complete. The Windows Package Manager currently defaults to this install experience. + +NOTE: When the Windows Package Manager installs a package using the "silent with progress" install mode, any custom switches will also be passed to the installer. If a user applies override switches via command line via the Windows Package Manager, none of the switches from the manifest will be passed to the installer. + +
+ +
+ Interactive - Interactive is the value that should be passed to the installer when user chooses an interactive install + +**Optional Field** + +This key represents switches passed to the installer to provide an interactive install experience. This is intended to allow a user to interact with the installer. These would be used when the command `winget install --interactive` is executed. + +NOTE: When the Windows Package Manager installs a package using the "interactive" install mode, any custom switches will also be passed to the installer. If a user applies override switches via command line via the Windows Package Manager, none of the switches from the manifest will be passed to the installer. + +
+ +
+ InstallLocation - InstallLocation is the value passed to the installer for custom install location. + +**Optional Field** + +This key represents the path to install the package if the installer supports installing the package in a user configurable location. The **<INSTALLPATH>** token can be included in the switch value so the Windows Package Manager will replace the token with user provided path. + +
+ +
+ Log - Log is the value passed to the installer for custom log file path. + +**Optional Field** + +This key represents the path logs will be directed to if the installer supports specifying the log path in a user configurable location. The **<LOGPATH>** token can be included in the switch value so the Windows Package Manager will replace the token with user provided path. + +
+ +
+ Upgrade - Upgrade is the value that should be passed to the installer when user chooses an upgrade. + +**Optional Field** + +This key represents the switches to be passed to the installer during an upgrade. This will happen only if the upgrade behavior is "install". + +NOTE: If a user applies override switches via command line via the Windows Package Manager, none of the switches from the manifest will be passed to the installer. + +
+ +
+ Custom - Custom switches will be passed directly to the installer by the Windows Package Manager. + +**Optional Field** + +This key represents any switches the Windows Package Manager will pass to the installer in addition to "Silent", "SilentWithProgress", and "Interactive". + +NOTE: If a user applies override switches via command line via the Windows Package Manager, none of the switches from the manifest will be passed to the installer. + +
+ +
+ Repair - Repair is the value that should be passed to the installer when a user chooses to repair an existing installation + +**Optional Field** + +This key represents the switches to be passed during the repair of an existing installation. This will be passed to the installer, ModifyPath ARP command, or Uninstaller ARP command depending on the RepairBehavior specified in the manifest. + +NOTE: If a user applies override switches via command line via the Windows Package Manager, none of the switches from the manifest will be passed to the installer. + +
+ +
+ UpgradeBehavior - The upgrade method + +**Optional Field** + +This key represents what the Windows Package Manager should do regarding the currently installed package during a package upgrade. If the package should be uninstalled first, the "uninstallPrevious" value should be specified. If the package should not be upgraded through WinGet, the "deny" value should be specified. + +NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. + +
+ +
+ Commands - List of commands or aliases to run the package + +**Optional Field** + +This key represents any commands or aliases used to execute the package after it has been installed. + +IMPORTANT: The Windows Package Manager does not update the path during the install workflow. In those cases, the user may need to restart their shell or terminal before the command will execute the newly installed package. The Windows Package Manager does not support any behavior related to commands or aliases. + +NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. + +
+ +
+ Protocols - List of protocols the package provides a handler for + +**Optional Field** + +This key represents any protocols (i.e. URI schemes) supported by the package. For example: `["ftp", "ldap"]`. Entries shouldn't have trailing colons. The Windows Package Manager does not support any behavior related to protocols handled by a package. + +NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. + +
+ +
+ FileExtensions - List of file extensions the package could support + +**Optional Field** + +This key represents any file extensions supported by the package. For example: `["html", "jpg"]`. Entries shouldn't have leading dots. The Windows Package Manager does not support any behavior related to the file extensions supported by the package. + +NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. + +
+ +
+ Dependencies - List of dependencies needed to install or execute the package + +**Optional Field** + +This key represents any dependencies required to install or run the package. + +IMPORTANT: External Dependencies are not supported. Package dependencies are referenced by their package identifier and must come from the same source. Windows Features may require a reboot before they are enabled. Windows Libraries are not supported. + +NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. + +
+ +
+ ExternalDependencies - List of external package dependencies + +**Optional Field** + +This key represents any external dependencies required to install or run the package. + +IMPORTANT: The Windows Package Manager does not support any behavior related to external dependencies. + +
+ +
+ PackageDependencies - List of package dependencies from current source + +**Optional Field** + +This key represents any packages from the same source required to install or run the package. + +IMPORTANT: Dependencies are referenced by their package identifier and must come from the same source. + +
+ +
+ WindowsFeatures - List of Windows feature dependencies + +**Optional Field** + +This key represents any Windows features required to install or run the package. + +
+ +
+ WindowsLibraries - List of Windows library dependencies + +**Optional Field** + +This key represents any Windows libraries required to install or run the package. + +IMPORTANT: The Windows Package Manager does not support any behavior related to Windows Libraries. + +
+ +
+ PackageFamilyName - PackageFamilyName for appx or msix installer. Could be used for correlation of packages across sources + +**Optional Field** + +This key represents the [package family name] specified in an MSIX installer. This value is used to assist with matching packages from a source to the program installed in Windows via Add / Remove Programs for list, and upgrade behavior. + +NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. + +
+ +
+ Capabilities - List of appx or msix installer capabilities + +**Restricted Field** + +This key represents the capabilities provided by an MSIX package. More information is available for [App capability declarations] + +NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. + +
+ +
+ RestrictedCapabilities - List of appx or msix installer restricted capabilities + +**Restricted Field** + +This key represents the restricted capabilities provided by an MSIX package. More information is available for [App capability declarations] + +NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. + +
+ +
+ InstallerAbortsTerminal - Indicator for installers that abort the terminal. + +**Optional Field** + +This key represents the behavior associated with installers that abort the terminal. This most often occurs when a user is performing an upgrade of the running terminal. + +NOTE: Windows Terminal no longer causes this to occur as the MSIX install behavior from the Windows Package Manager is deferred registration. + +
+ +
+ InstallLocationRequired - Indicator for packages requiring an install location to be specified. + +**Optional Field** + +This key represents the requirement to have an install location specified. These installers are known to deploy files to the location the installer is executed in. + +
+ +
+ RequireExplicitUpgrade - Indicator for packages that upgrade themselves. + +**Optional Field** + +This key identifies packages that upgrade themselves. By default, they are excluded from `winget upgrade --all`. + +
+ +
+ ElevationRequirement - Indicator for elevation behavior when installing or upgrading packages. + +**Optional Field** + +This key describes how the installer interacts with elevation (administrator privileges). It tells WinGet whether to request elevation on the user's behalf, whether the installer handles elevation itself, or whether elevation must be avoided entirely. + +- **elevationRequired** — The installer always requires administrator privileges to complete (e.g., it writes to `Program Files`, modifies system registry keys, or installs a Windows service). If WinGet is running in a non-elevated context, it will launch the installer elevated via a UAC prompt. +- **elevatesSelf** — The installer contains its own logic to determine whether elevation is needed and will request it when necessary. For example, the installer may check whether the current user is a member of the local Administrators group and automatically switch between a per-user and machine-wide installation. WinGet will not elevate the installer itself but will warn the user that a UAC prompt may appear. +- **elevationProhibited** — The installer must not be run from an elevated (administrator) context. If WinGet is running elevated, the installation will be blocked. + +> **Choosing between `elevationRequired` and `elevatesSelf`:** Use `elevationRequired` when the installer unconditionally needs administrator privileges due to what it installs (protected file locations, HKLM registry, system services). Use `elevatesSelf` when the installer has built-in logic that conditionally decides whether elevation is needed based on runtime checks. +
+ +
+ UnsupportedOSArchitectures - List of unsupported architectures for a package. + +**Optional Field** + +This key represents any architectures a package is known not to be compatible with. Generally, this is associated with emulation modes. + +
+ +
+ Markets - List of supported markets for a package. + +**Restricted Field** + +This key represents any markets a package may be installed in. + +IMPORTANT: If a market is listed in both this key and the ExcludedMarkets key, the market will be excluded. Both keys are present to reduce the need to list the larger set of markets. + +
+ +
+ ExcludedMarkets - List of unsupported markets for a package. + +**Restricted Field** + +This key represents any markets a package may not be installed in. + +IMPORTANT: If a market is listed in both this key and the Markets key, the market will be excluded. Both keys are present to reduce the need to list the larger set of markets. + +
+ +
+ InstallerSuccessCodes - List of additional non-zero installer success exit codes other than known default values by the Windows Package Manager. + +**Optional Field** + +This key represents any status codes returned by the installer representing a success condition other than zero. + +IMPORTANT: Some return codes indicate a reboot is suggested or required. The Windows Package Manager does not support the reboot behavior currently. Some installers will force a reboot, and the Windows Package Manager does not currently suppress reboot behavior. + +NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. + +
+ +
+ ExpectedReturnCodes - List of additional non-zero installer exit codes other than known default values by the Windows Package Manager. + +**Optional Field** + +This key represents any status codes returned by the installer representing a condition other than zero. + +IMPORTANT: Some return codes indicate a reboot is suggested or required. The Windows Package Manager does not support the reboot behavior currently. Some installers will force a reboot, and the Windows Package Manager does not currently suppress reboot behavior. + +NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. + +
+ +
+ InstallerReturnCode - The non-zero installer exit code other than known default values by the Windows Package Manager. + +**Optional Field** + +This key represents any status code returned by the installer representing a condition other than zero. MSIX and MSI packages have well known return codes. This is primarily intended for executable installers that have custom or unique return codes that can be mapped to a return response. + +
+ +
+ ReturnResponse - The return response to be displayed in the event an expected return code is encountered. + +**Optional Field** + +This key represents a return response to display when an installer returns an expected return code. MSIX and MSI packages have well known return codes. This is primarily intended for executable installers that have custom or unique return codes that can be mapped to a return response. + +NOTE: An enumerated list of values in the JSON schema must be specified for consistency of user experience. + +
+ +
+ ReturnResponseUrl - The return response URL to be displayed in the event an expected return code is encountered. + +**Optional Field** + +This key represents a return response URL to display when an installer returns an expected return code. MSIX and MSI packages have well known return codes. This is primarily intended for executable installers that have custom or unique return codes that can be mapped to a return response. + +NOTE: An enumerated list of values in the JSON schema must be specified for consistency of user experience. + +
+ +
+ ProductCode - ProductCode is used for correlation of packages with manifests is configured sources. + +**Optional Field** + +This key represents the [product code] specified in an MSI installer. This value is used to assist with matching packages from a source to the program installed in Windows via Add / Remove Programs for list, and upgrade behavior. + +NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. + +
+ +
+ AppsAndFeaturesEntries - AppsAndFeaturesEntries are used to match installed packages with manifests in configured sources. + +**Optional Field** + +This key represents the values reported by Windows Apps & Features. When a package is installed, entries are made into the Windows Registry. + +
+ +
+ DisplayName - DisplayName is what is displayed in the Control Panel for installed packages. + +**Optional Field** + +This key represents the package name as displayed in Windows Apps & Features. This is the value of the `DisplayName` subkey for the package in the [Windows registry][uninstall-registry]. It is used to help correlate installed packages with manifests in configured sources. + +
+ +
+ DisplayVersion - DisplayVersion is the version displayed in the Control Panel for installed packages. + +**Optional Field** + +This key represents the package version as displayed in Windows Apps & Features. This is the value of the `DisplayVersion` subkey for the package in the [Windows registry][uninstall-registry]. It is used to help correlate installed packages with manifests in configured sources. + +> Note: When the PackageVersion and DisplayVersion are the same, the DisplayVersion should be omitted from the AppsAndFeaturesEntries + +
+ +
+ Publisher - Publisher is the value of the package publisher reported in the Windows registry. + +**Optional Field** + +This key represents the package publisher as displayed in Windows Apps & Features. This is the value of the `Publisher` subkey for the package in the [Windows registry][uninstall-registry]. It is used to help correlate installed packages with manifests in configured sources. + +
+ +
+ ProductCode - ProductCode is used for correlation of packages with manifests in configured sources. + +**Optional Field** + +This key represents the [product code] for a package. It is used to help correlate installed packages with manifests in configured sources. + +NOTE: This key is displayed twice for completeness. When AppsAndFeaturesEntries are specified, the ProductCode should be placed both within the installer and the AppsAndFeaturesEntries + +
+ +
+ UpgradeCode - UpgradeCode is used for correlation of packages with manifests in configured sources. + +**Optional Field** + +This key represents the [upgrade code] for a package. It is used to help correlate installed packages with manifests in configured sources. + +
+ +
+ InstallerType - Enumeration of supported installer types. + +**Optional Field** + +This key represents the installer type for the package. It is used to help correlate installed packages with manifests in configured sources. In some cases, an installer is an .exe based installer, but contains an MSI installer. This key will help the Windows Package Manager understand if upgrading an MSI should be performed when it is contained in an .exe installer. + +NOTE: This key is displayed twice for completeness. When AppsAndFeaturesEntries are specified, the InstallerType should be placed within the installer only, unless the AppsAndFeaturesEntries represent a different InstallerType + +
+ +
+ UnsupportedArguments - List of unsupported Windows Package Manager Client arguments for an installer. + +**Optional Field** + +This key represents the list of Windows Package Manager Client arguments the installer does not support. Only the `--log` and `--location` arguments can be specified as unsupported arguments for an installer. + +
+ +
+ DisplayInstallWarnings - Indicator for displaying a warning message prior to install or upgrade. + +**Optional Field** + +This key represents whether a warning message is displayed to the user prior to install or upgrade if the package is known to interfere with any running applications. + +NOTE: The DisplayInstallWarnings behavior is not implemented in the Windows Package Manager 1.28 client. + +
+ +
+ ReleaseDate - The Release Date for a package. + +**Optional Field** + +This key represents the release date for a package, in RFC 3339 / ISO 8601 format, i.e. "YYYY-MM-DD". + +
+ +
+ InstallationMetadata - Details about the installation. + +**Optional Field** + +This key allows for additional metadata to be used for deeper installation detection. + +
+ +
+ DefaultInstallLocation - The default installed package location. + +**Optional Field** + +This key represents the default install location for the package. + +
+ +
+ Files - The list of installed files. + +**Optional Field** + +This key represents the files installed for the package. + +
+ +
+ RelativeFilePath - The relative path to the installed file. + +**Optional Field** + +This key represents the path to the installed file relative to the default install location. + +
+ +
+ FileSha256 - The optional Sha256 of the installed file. + +**Optional Field** + +This key represents the Sha256 hash of the installed file. + +
+ +
+ FileType - The optional installed file type. + +**Optional Field** + +This key represents the type of the installed file - `launch`, `uninstall`, or `other`. If not specified, the file is treated as `other`. + +
+ +
+ InvocationParameter - Optional parameter for invocable files. + +**Optional Field** + +This key represents the parameter to use for invocable files. + +
+ +
+ DisplayName - Optional display name for invocable files + +**Optional Field** + +This key represents the display name to use for invocable files. + +
+ +
+ DownloadCommandProhibited - Optional indicator for packages which cannot be downloaded for offline installation + +**Optional Field** + +When `true`, this flag will prohibit the manifest from being downloaded for offline installation with the `winget download` command + +
+ +
+ RepairBehavior - Optional repair method to use with 'winget repair` + +**Optional Field** + +This field controls what method is used to repair existing installations of packages. Specifying `modify` will use the ModifyPath string from the package's ARP data, `uninstaller` will use the Uninstall string from the package's ARP data, and `installer` will download and run the installer. In each case, the `Repair` value from `InstallerSwitches` will be added as an argument when invoking the command to repair the package. + +
+ +
+ ArchiveBinariesDependOnPath - Optional indication to add the install location directly to PATH. Only applies to an archive containing portable packages + +**Optional Field** + +This field controls the behavior of environment variables when installing portable packages from an archive (i.e `zip`). Specifying `true` will add the install location directly to the `PATH` environment variable. Specifying `false` or leaving the value unset will use the default behavior of adding a symlink to the `links` folder, if supported, or adding the install location directly to `PATH` if symlinks are not supported. + +
+ +
+ Authentication - Authentication information for Entra Id secured private sources + +**Restricted Field** + +This field controls the authentication for Entra ID secured private sources. Authentication type is required. Resource and scope information can be included if a specific resource is needed to download or install the package. + +
+ +
+ AuthenticationType - What type of authentication to use for Entra Id authentication + +**Restricted Field** + +This field controls the whether to use no authentication, Entra ID, or Entra ID for Azure Blob Storage. + +
+ +
+ MicrosoftEntraIdAuthenticationInfo - Information required for Entra Id authentication in private sources + +**Restricted Field** + +This field controls the authentication details used when downloading or installing packages from Entra Id secured private sources. + +
+ +
+ Resource - The resource to use for Microsoft Entra Id authentication + +**Restricted Field** + +This field controls the resource which will be used when using Entra Id for downloading or installing packages + +
+ +
+ Scope - The scope of Microsoft Entra Id authentication for the resource + +**Restricted Field** + +This field controls the scope which will be used when using Entra Id for downloading or installing packages + +
+ +
+ DesiredStateConfiguration - References to desired state configuration (DSC) resources that are related to the package + +**Optional Field** + +NOTE: The DesiredStateConfiguration behavior is not implemented in the Windows Package Manager 1.28 client. + +This field contains references to desired state configuration (DSC) resources that are related to the package. Resources may be provided as PowerShell modules or using the DSC v3 specification. + +
+ +
+ PowerShell - DSC resources contained in PowerShell modules + +**Restricted Field** + +NOTE: The PowerShell behavior is not implemented in the Windows Package Manager 1.28 client. + +This field references DSC resources contained in PowerShell modules. Adding references to PowerShell DSC resources requires participation in the Verified Developer program. The Verified Developer program is new and currently limited to a subset of Microsoft packages. A third-party Verified Developer program is planned for the future. + +
+ +
+ RepositoryUrl - The URL of the repository hosting the PowerShell module + +**Restricted Field** + +NOTE: The RepositoryUrl behavior is not implemented in the Windows Package Manager 1.28 client. + +This field controls the URL of the repository where the PowerShell module containing the DSC resources is published. + +
+ +
+ ModuleName - The name of the PowerShell module containing the DSC resources + +**Restricted Field** + +NOTE: The ModuleName behavior is not implemented in the Windows Package Manager 1.28 client. + +This field controls the name of the PowerShell module containing the DSC resources. + +
+ +
+ Resources - The DSC resources contained in the PowerShell module + +**Restricted Field** + +NOTE: The Resources behavior is not implemented in the Windows Package Manager 1.28 client. + +This field lists the DSC resources contained in the PowerShell module. + +
+ +
+ Name - The name of the PowerShell DSC resource + +**Restricted Field** + +NOTE: The Name behavior is not implemented in the Windows Package Manager 1.28 client. + +This field controls the name of an individual PowerShell DSC resource contained in the module. + +
+ +
+ DSCv3 - DSC resources contained in the package using the DSC v3 specification + +**Optional Field** + +NOTE: The DSCv3 behavior is not implemented in the Windows Package Manager 1.28 client. + +This field references DSC resources implemented in the package using the DSC v3 specification. + +
+ +
+ Type - The fully qualified type name of the DSC v3 resource + +**Optional Field** + +NOTE: The Type behavior is not implemented in the Windows Package Manager 1.28 client. + +This field controls the fully qualified type name of the DSC v3 resource. The type name matches the pattern `Publisher.Product.Component/ResourceName`, where Product and Component are optional. + +
+ +
+ ManifestType - The manifest type + +**Required Field** + +This key must have the value "installer". The Microsoft community package repository validation pipelines also use this value to determine appropriate validation rules when evaluating this file. + +
+ +
+ ManifestVersion - The manifest syntax version + +**Required Field** + +This key must have the value "1.28.0". The Microsoft community package repository validation pipelines also use this value to determine appropriate validation rules when evaluating this file. + +
diff --git a/doc/manifest/schema/1.28.0/locale.md b/doc/manifest/schema/1.28.0/locale.md new file mode 100644 index 0000000000000..8f3fa1565d7dc --- /dev/null +++ b/doc/manifest/schema/1.28.0/locale.md @@ -0,0 +1,368 @@ +[JSON schema]: https://github.com/microsoft/winget-cli/blob/master/schemas/JSON/manifests/v1.28.0/manifest.locale.1.28.0.json +[YAML]: https://yaml.org/spec +[semantic version]: https://semver.org +[Available languages for Windows]: https://docs.microsoft.com/windows-hardware/manufacture/desktop/available-language-packs-for-windows +[locales]: https://docs.microsoft.com/windows-hardware/manufacture/desktop/default-input-locales-for-windows-language-packs +[install]: https://docs.microsoft.com/windows/package-manager/winget/install +[list]: https://docs.microsoft.com/windows/package-manager/winget/list +[upgrade]: https://docs.microsoft.com/windows/package-manager/winget/upgrade +[uninstall-registry]: https://learn.microsoft.com/en-us/windows/win32/msi/uninstall-registry-key + +# Windows Package Manager +## Manifest Schema v1.28.0 Locale File + +All Windows Package Manager manifests in the Microsoft community repository are submitted using [YAML] syntax. A [JSON schema] is provided to aid authoring these files in editors, and in the other tooling related to the Windows Package Manager. This document provides detailed information regarding the usage of the YAML keys in the locale file for multi-file manifests. + +### Locale Manifest + +```YAML +PackageIdentifier: # The package unique identifier +PackageVersion: # The package version +PackageLocale: # The package meta-data locale +Publisher: # Optional publisher name +PublisherUrl: # Optional publisher home page +PublisherSupportUrl: # Optional publisher support page +PrivacyUrl: # Optional publisher privacy page +Author: # Optional author +PackageName: # Optional package name +PackageUrl: # Optional package home page +License: # Optional package license +LicenseUrl: # Optional package license page +Copyright: # Optional package copyright +CopyrightUrl: # Optional package copyright page +ShortDescription: # Optional short package description +Description: # Optional full package description +Tags: # Optional list of package terms +Agreements: # Optional package agreements + - AgreementLabel: # Optional agreement label + Agreement: # Optional agreement text + AgreementUrl: # Optional agreement URL +Documentations: # Optional documentation + - DocumentLabel: # Optional documentation label + DocumentUrl: # Optional documentation URL +ReleaseNotes: # Optional release notes +ReleaseNotesUrl: # Optional release notes URL +PurchaseUrl: # Optional purchase URL +InstallationNotes: # Optional notes displayed upon installation +ManifestType: locale # The manifest type +ManifestVersion: 1.28.0 # The manifest syntax version +``` + +## Fields + +
+ PackageIdentifier - The package unique identifier + + **Required Field** + + This key is the unique identifier for a given package. This value is generally in the form of `Publisher.Package`. It is case sensitive, and this value must match the folder structure under the partition directory in GitHub. +
+ +
+ PackageVersion - The package version + + **Required Field** + + This key represents the version of the package. It is related to the specific release this manifests targets. In some cases you will see a perfectly formed [semantic version] number, and in other cases you might see something different. These may be date driven, or they might have other characters with some package specific meaning for example. + + The Windows Package Manager client uses this version to determine whether or not an upgrade for a package is available. In some cases, packages may be released with a marketing driven version, and that causes trouble with the `winget upgrade` command. + + The current best practice is to use the value reported in Add / Remove Programs when this version of the package is installed. In some cases, packages do not report a version resulting in an upgrade loop or other unwanted behavior. +
+ +
+ PackageLocale - The package meta-data locale + + **Required Field** + + This key represents the locale for package meta-data. The format is BCP-47. This value identifies the language for meta-data to be displayed to a user when no locale file matching their preferences is available. The Microsoft community package repository validation pipelines also use this value to determine appropriate validation rules for this file. + + **References** + +* [Available languages for Windows] +* [Default Input Profiles (Input Locales) in Windows][locales] + + NOTE: This field is the key to determining which fields are required for the Microsoft community repository. The default locale specified in the version file must match with this value. +
+ +
+ Publisher - The publisher name + + **Optional Field** + + This key represents the name of the publisher for a given package. This field is intended to allow the full publisher's or ISV's name to be displayed as they wish. + + NOTE: With the 1.28 release of the Windows Package Manager, this name affects how packages from a source are mapped to Apps installed in Windows 10 and Windows 11 via Add / Remove Programs (ARP). The best practice is to ensure this matches the ARP entry for the package when it has been installed. This should be the value of the `Publisher` subkey for the package in the [Windows registry][uninstall-registry]. The impact is associated with `winget upgrade` and `winget list`. +
+ +
+ PublisherUrl - The publisher home page + + **Optional Field** + + This key represents the web site for the publisher or ISV. +
+ +
+ PublisherSupportUrl - The publisher support page + + **Optional Field** + + This key represents the customer support web site or specific web page provided by the publisher or ISV. +
+ +
+ PrivacyUrl - The publisher privacy page or the package privacy page + + **Optional Field** + + This key represents the privacy web site or specific web page provided the publisher or ISV. If there is a privacy web site or specific web page for the package, it is preferred over a generic privacy page for the publisher. +
+ +
+ Author - The package author + + **Optional Field** + + This key represents the author of a package. In some cases, the author is an individual who develops and or maintains the package. +
+ +
+ PackageName - The package name + + **Optional Field** + + This key represents the name of the package. This field is intended to allow the full package name to be displayed as the publisher or ISV wishes. + + NOTE: With the 1.28 release of the Windows Package Manager, this name affects how packages from a source are mapped to Apps installed in Windows 10 via Add / Remove Programs (ARP). The best practice is to ensure this matches the ARP entry for the package name when it has been installed. This should be the value of the `DisplayName` subkey for the package in the [Windows registry][uninstall-registry]. The impact is associated with `winget upgrade` and `winget list`. +
+ +
+ PackageUrl - The package home page + + **Optional Field** + + This key represents the web site for the package. +
+ +
+ License - The package license + + **Optional Field** + + This key represents the license governing the use and or distribution for the product. This could be an open source license, or a commercial license. Please note that a copyright is not considered a license. If there is no available information on a product's license, "Proprietary" should be the value in this field. +
+ +
+ LicenseUrl - The license page + + **Optional Field** + + This key represents the license web site or specific web page provided the publisher or ISV. If there is a license web site or specific web page for the package, it is preferred over a generic license page for the publisher. + + If this is a link to the license file for an open source project, it should be specific to the version for the package. Some open source projects change their license over time. +
+ +
+ Copyright - The package copyright + + **Optional Field** + + This key represents the copyright for the package. +
+ +
+ CopyrightUrl - The package copyright page + + **Optional Field** + + This key represents the copyright web site or specific web page provided the publisher or ISV. If there is a copyright web site or specific web page for the package, it is preferred over a generic copyright page for the publisher. + + If this is a link to the copyright file for an open source project, it should be specific to the version for the package. Some open source projects change their copyright over time. +
+ +
+ ShortDescription - The short package description + + **Optional Field** + + This key represents the description for a package. It is intended for use in `winget show` to help a user understand what the package is. + + NOTE: This should be something descriptive about what the package does, and it should not simply state something like "<package name> installer" or "<package name> setup". +
+ +
+ Description - The full package description + + **Optional Field** + + This key represents the full or long description for a package. It is *not* currently used in the Windows Package Manager. + + NOTE: This was included for future integration with the Microsoft Store source to provide the ability to display the full package description. +
+ +
+ Tags - List of additional package search terms + + **Optional Field** + + This key represents other common term users would search for when looking for packages. + + NOTE: The best practice is to present these terms in all lower case with hyphens rather than spaces. +
+ +
+ Agreements - List of package agreements + + **Optional Field** + + This key holds any agreements a user must accept prior to download and subsequent install or upgrade. + + IMPORTANT: In the Windows Package Manager Community Repository, these are only allowed to be submitted by verified developers. +
+ +
+ AgreementLabel - The label for a package agreement + + **Optional Field** + + This key represents the label for a package agreement. +
+ +
+ Agreement - The text for a package agreement + + **Restricted Field** + + This key represents the text or body of a package agreement. +
+ +
+ AgreementUrl - The URL for a package agreement + + **Optional Field** + + This key represents the URL for a package agreement. +
+ +
+ Documentations - List of documentation + + **Optional Field** + + This key holds any documentation for providing software guides such as manuals and troubleshooting URLs. +
+ +
+ DocumentLabel - The documentation label + + **Optional Field** + + This key represents the label for a documentation. +
+ +
+ DocumentUrl - List of documentation + + **Optional Field** + + This key represents the URL for a documentation. +
+ +
+ ReleaseNotes - The Release Notes for a package. + + **Optional Field** + + This key represents release notes for a package. +
+ +
+ ReleaseNotesUrl - The Release Notes web page for a package. + + **Optional Field** + + This key represents release notes web page for a package. +
+ +
+ PurchaseUrl - The Purchase URL for a package. + + **Optional Field** + + This key represents the purchase url for acquiring entitlement for a package. +
+ +
+ InstallationNotes - The Installation Notes for a package. + + **Optional Field** + + This key represents the notes displayed to the user upon completion of a package installation. +
+ +
+ Icons - The icons for the package + + **Optional Field** + + NOTE: Icon metadata is populated during validation and is not authored in pull requests. When present, icons are rendered by the Windows Package Manager client when the sixel feature is enabled in [settings](https://github.com/microsoft/winget-cli/blob/master/doc/Settings.md#enablesixels). + + This key represents the icons for the package. +
+ +
+ IconUrl - The url of the hosted icon file + + **Required Field** + + This key represents the url of the hosted icon file. +
+ +
+ IconFileType - The type of the icon file + + **Required Field** + + This key represents the type of the icon file. Supported values are `png`, `jpeg`, and `ico`. +
+ +
+ IconResolution - The resolution of the icon + + **Optional Field** + + This key represents the resolution of the icon. +
+ +
+ IconTheme - The theme of the icon + + **Optional Field** + + This key represents the theme of the icon. +
+ +
+ IconSha256 - The SHA256 hash of the icon file + + **Optional Field** + + This key represents the SHA256 hash of the icon file. +
+ +
+ ManifestType - The manifest type + + **Required Field** + + This key must have the value "locale". The Microsoft community package repository validation pipelines also use this value to determine appropriate validation rules when evaluating this file. +
+ +
+ ManifestVersion - The manifest syntax version + + **Required Field** + + This key must have the value "1.28.0". The Microsoft community package repository validation pipelines also use this value to determine appropriate validation rules when evaluating this file. +
diff --git a/doc/manifest/schema/1.28.0/singleton.md b/doc/manifest/schema/1.28.0/singleton.md new file mode 100644 index 0000000000000..044c8583fb2a1 --- /dev/null +++ b/doc/manifest/schema/1.28.0/singleton.md @@ -0,0 +1,1172 @@ +[JSON schema]: https://github.com/microsoft/winget-cli/blob/master/schemas/JSON/manifests/v1.28.0/manifest.singleton.1.28.0.json +[semantic version]: https://semver.org +[install]: https://docs.microsoft.com/windows/package-manager/winget/install +[list]: https://docs.microsoft.com/windows/package-manager/winget/list +[upgrade]: https://docs.microsoft.com/windows/package-manager/winget/upgrade +[MSIX]: https://docs.microsoft.com/windows/msix/overview +[MSI]: https://docs.microsoft.com/windows/win32/msi/windows-installer-portal +[Inno]: https://jrsoftware.org/isinfo.php +[Nullsoft]: https://sourceforge.net/projects/nsis +[WiX]: https://wixtoolset.org +[Burn]: https://wixtoolset.org/docs/v3/bundle/ +[Windows Package Manager Manifest Creator]: https://github.com/microsoft/winget-create +[App capability declarations]: https://docs.microsoft.com/windows/uwp/packaging/app-capability-declarations + +## Minimal singleton YAML file example +As specified in the singleton [JSON schema], only a number of fields are required. The singleton format is only valid for packages containing a single installer and a single locale. If more than one installer or locale is provided, the multiple YAML file format and schema must be used. + +> [!WARNING] +The singleton manifest format has been deprecated in the Windows Package Manager Community Repository. The Windows Package Manager 1.28 client still supports singleton manifests. + +### Singleton Manifest + +```YAML +PackageIdentifier: # The package unique identifier +PackageVersion: # The package version +Channel: # *Not implemented* distribution channel +PackageLocale: # The package meta-data locale +Publisher: # The publisher name +PackageName: # The package name +License: # The package license +ShortDescription: # The short package description +Description: # Optional full package description +Moniker: # Optional most common package term +Tags: # Optional list of package terms +Agreements: # Optional package agreements + - AgreementLabel: # Optional agreement label + Agreement: # Optional agreement text + AgreementUrl: # Optional agreement URL +Documentations: # Optional documentation + - DocumentLabel: # Optional documentation label + DocumentUrl: # Optional documentation URL +ReleaseDate: # Optional release date +ReleaseNotes: # Optional release notes +ReleaseNotesUrl: # Optional release notes URL +PurchaseUrl: # Optional purchase URL +InstallationNotes: # Optional notes displayed upon installation +Installers: # The package installer + - Architecture: # The architecture of the installer + InstallerLocale: # Optional locale of the installer + Platform: # Optional installer supported operating system + MinimumOSVersion: # Optional installer minimum operating system version + InstallerType: # The installer type + InstallerUrl: # The installer URL + InstallerSha256: # The SHA256 hash of the installer + SignatureSha256: # Optional SHA256 hash of the MSIX signature + NestedInstallerType: # The installer type when InstallerType is an archive type + NestedInstallerFiles: # Details about the installers when InstallerType is an archive type + - RelativeFilePath: # The relative path to the nested installer file + PortableCommandAlias: # The command alias to be used for calling the package. Only applies when NestedInstallerType is 'portable' + Scope: # Optional installer scope + InstallModes: # Optional installer modes + InstallerSwitches: # Optional installer switches + Silent: # Optional installer switches for silent + SilentWithProgress: # Optional installer switches for silent with progress + Interactive: # Optional installer switches for interactive + InstallLocation: # Optional install location path + Log: # Optional installer log file path + Upgrade: # Optional installer switches for upgrade + Custom: # Optional installer switches for custom behavior + Repair: # Optional installer switches to use when repairing the package installation + UpgradeBehavior: # Optional upgrade method + Commands: # Optional commands or aliases to run the package + Protocols: # Optional list of protocols supported by the package + FileExtensions: # Optional list of file extensions supported by the package + Dependencies: # Optional list of dependencies required by the package + - ExternalDependencies: # *Not implemented* list of external dependencies + PackageDependencies: # Optional list of package dependencies + WindowsFeatures: # Optional list of Windows feature dependencies + WindowsLibraries: # *Not implemented* list of Windows library dependencies + PackageFamilyName: # Optional MSIX package family name + Capabilities: # Optional list of MSIX package capabilities + RestrictedCapabilities: # Optional list of MSIX package restricted capabilities + InstallerAbortsTerminal: # Optional indicator for packages that abort terminal + InstallLocationRequired: # Optional indicator for packages that require install location + RequireExplicitUpgrade: # Optional indicator for packages that upgrade themselves + ElevationRequirement: # Scope required to install package + UnsupportedOSArchitectures: # Optional architectures the package is not supported on + Markets: # Optional markets the package is allowed to be installed + ExcludedMarkets: # Optional markets the package is not allowed to be installed + InstallerSuccessCodes: # Optional non-zero installer success codes + ExpectedReturnCodes: # Optional non-zero installer return codes + - InstallerReturnCode: # Optional non-zero installer return code + ReturnResponse: # Optional response for an expected return code + ReturnResponseUrl: # Optional response URL for an expected return code + ProductCode: # Optional product code of the installer + AppsAndFeaturesEntries: # Optional entries from the Add and Remove Programs (ARP) table + - DisplayName: # Optional program name shown in the ARP entry + DisplayVersion: # Optional version displayed in the ARP entry + Publisher: # Optional publisher displayed in the ARP entry + ProductCode: # Optional product code of the installer + UpgradeCode: # Optional upgrade code of the installer + InstallerType: # Optional installer type + UnsupportedArguments: # Optional list of Windows Package Manager Client arguments the installer does not support + - UnsupportedArgument: # Optional unsupported Windows Package Manager Client argument + DisplayInstallWarnings: # *Not implemented* Optional indicator for packages that are known to interfere with running application during install + InstallationMetadata: # Optional metadata for deeper installation detection + - DefaultInstallLocation: # Optional default install location for the package + Files: # Optional list of files installed by the package + - RelativeFilePath: # Optional relative path to the installed file + FileSha256: # Optional Sha256 of the installed file + FileType: # Optional installed file type. Treated as 'other' if not specified + InvocationParameter: # Optional parameter for invocable files + DisplayName: # Optional display name for invocable files + DownloadCommandProhibited: # Optional indicator for packages which cannot be downloaded for offline installation + RepairBehavior: # Optional repair method to use with 'winget repair` + ArchiveBinariesDependOnPath: # Optional indication to add the install location directly to PATH. Only applies to an archive containing portable packages + Authentication: # Authentication information for Entra Id secured private sources + AuthenticationType: # What type of authentication to use for Entra Id authentication + MicrosoftEntraIdAuthenticationInfo: # Information required for Entra Id authentication in private sources + Resource: # The resource to use for Microsoft Entra Id authentication + Scope: # The scope of Microsoft Entra Id authentication for the resource + DesiredStateConfiguration: # *Not implemented* References to desired state configuration (DSC) resources related to the package + PowerShell: # *Not implemented* DSC resources contained in PowerShell modules + - RepositoryUrl: # *Not implemented* The URL of the repository hosting the PowerShell module + ModuleName: # *Not implemented* The name of the PowerShell module containing the DSC resources + Resources: # *Not implemented* The DSC resources contained in the PowerShell module + - Name: # *Not implemented* The name of the PowerShell DSC resource + DSCv3: # *Not implemented* DSC resources contained in the package using the DSC v3 specification + Resources: # *Not implemented* The DSC v3 resources contained in the package + - Type: # *Not implemented* The fully qualified type name of the DSC v3 resource +ManifestType: singleton # The manifest type +ManifestVersion: 1.28.0 # The manifest syntax version +``` + +### [Singleton Minimal Example](#tab/minimal/) + +```YAML +PackageIdentifier: Microsoft.WindowsTerminal +PackageVersion: 1.6.10571.0 +PackageLocale: en-US +Publisher: Microsoft +PackageName: Windows Terminal +License: MIT +ShortDescription: The new Windows Terminal, a tabbed command line experience for Windows. +Installers: + - Architecture: x64 + InstallerType: msix + InstallerUrl: https://github.com/microsoft/terminal/releases/download/v1.6.10571.0/Microsoft.WindowsTerminal_1.6.10571.0_8wekyb3d8bbwe.msixbundle + InstallerSha256: 092aa89b1881e058d31b1a8d88f31bb298b5810afbba25c5cb341cfa4904d843 + SignatureSha256: e53f48473621390c8243ada6345826af7c713cf1f4bbbf0d030599d1e4c175ee +ManifestType: singleton +ManifestVersion: 1.28.0 +``` + +## Fields + +
+ PackageIdentifier - The package unique identifier + + **Required Field** + + This key is the unique identifier for a given package. This value is generally in the form of `Publisher.Package`. It is case sensitive, and this value must match the folder structure under the partition directory in GitHub. +
+ +
+ PackageVersion - The package version + + **Required Field** + + This key represents the version of the package. It is related to the specific release this manifests targets. In some cases you will see a perfectly formed [semantic version] number, and in other cases you might see something different. These may be date driven, or they might have other characters with some package specific meaning for example. + + The Windows Package Manager client uses this version to determine if an upgrade for a package is available. In some cases, packages may be released with a marketing driven version, and that causes trouble with the [`winget upgrade`][upgrade] command. + + NOTE: The current best practice is to use the value reported in Add / Remove Programs when this version of the package is installed. In some cases, packages do not report a version resulting in an upgrade loop or other unwanted behavior. This practice may seem contrary to using semantic versioning, but it provides the best end to end experience for customers. It will take time for publishers and ISVs to migrate to semantic versioning, and some may intentionally choose to preserve other versioning schemes. In these cases, it is best practice to include the "AppsAndFeaturesEntries" section for each installer. +
+ +
+ Channel - The distribution channel + + **Optional Field** + + This key represents the distribution channel for a package. Examples may include "stable" or "beta". + + NOTE: This key is included for future use. The Windows Package Manager currently does not have any behavior associated with this key. The intent behind this key is to help disambiguate the different channels for packages lacking support for side by side installation. Some packages support having more than one package channel available on a system simultaneously; in this case it is better to use unique packages rather than channels. This key is intended to ensure the proper channel for a package is used during install and upgrade scenarios. +
+ +
+ Description - The full package description + + **Optional Field** + + This key represents the full or long description for a package. It is *not* currently used in the Windows Package Manager. + + NOTE: This was included for future integration with the Microsoft Store source to provide the ability to display the full package description. +
+ +
+ Moniker - The most common package term + + **Optional Field** + + This key represents the most common term users would search for when installing or upgrading a package. If only one package uses this moniker, then the [install], [list] and [upgrade] command may match with this package. + + NOTE: Moniker is the third property evaluated when searching for a matching package. +
+ +
+ Tags - List of additional package search terms + + **Optional Field** + + This key represents other common term users would search for when looking for packages. + + NOTE: The best practice is to present these terms in all lower case with hyphens rather than spaces. +
+ +
+ Agreements - List of package agreements + + **Optional Field** + + This key holds any agreements a user must accept prior to download and subsequent install or upgrade. + + IMPORTANT: In the Windows Package Manager Community Repository, these are only allowed to be submitted by verified developers. +
+ +
+ AgreementLabel - The label for a package agreement + + **Optional Field** + + This key represents the label for a package agreement. +
+ +
+ Agreement - The text for a package agreement + + **Restricted Field** + + This key represents the text or body of a package agreement. +
+ +
+ AgreementUrl - The URL for a package agreement + + **Optional Field** + + This key represents the URL for a package agreement. +
+ +
+ Documentations - List of documentation + + **Optional Field** + + This key holds any documentation for providing software guides such as manuals and troubleshooting URLs. +
+ +
+ DocumentLabel - The documentation label + + **Optional Field** + + This key represents the label for a documentation. +
+ +
+ DocumentUrl - List of documentation + + **Optional Field** + + This key represents the URL for a documentation. +
+ +
+ ReleaseDate - The Release Date for a package. + + **Optional Field** + + This key represents the release date for a package, in RFC 3339 / ISO 8601 format, i.e. "YYYY-MM-DD". +
+ +
+ ReleaseNotes - The Release Notes for a package. + + **Optional Field** + + This key represents release notes for a package. +
+ +
+ ReleaseNotesUrl - The Release Notes web page for a package. + + **Optional Field** + + This key represents release notes web page for a package. +
+ +
+ PurchaseUrl - The Purchase URL for a package. + + **Optional Field** + + This key represents the purchase url for acquiring entitlement for a package. +
+ +
+ InstallationNotes - The Installation Notes for a package. + + **Optional Field** + + This key represents the notes displayed to the user upon completion of a package installation. +
+ +
+ Icons - The icons for the package + + **Optional Field** + + NOTE: Icon metadata is populated during validation and is not authored in pull requests. When present, icons are rendered by the Windows Package Manager client when the sixel feature is enabled in [settings](https://github.com/microsoft/winget-cli/blob/master/doc/Settings.md#enablesixels). + + This key represents the icons for the package. +
+ +
+ IconUrl - The url of the hosted icon file + + **Required Field** + + This key represents the url of the hosted icon file. +
+ +
+ IconFileType - The type of the icon file + + **Required Field** + + This key represents the type of the icon file. Supported values are `png`, `jpeg`, and `ico`. +
+ +
+ IconResolution - The resolution of the icon + + **Optional Field** + + This key represents the resolution of the icon. +
+ +
+ IconTheme - The theme of the icon + + **Optional Field** + + This key represents the theme of the icon. +
+ +
+ IconSha256 - The SHA256 hash of the icon file + + **Optional Field** + + This key represents the SHA256 hash of the icon file. +
+ +
+ Installers - Package installer + + **Required Field** + + The key represents an installer for a package. + + IMPORTANT: Many of the keys related to installers may either be at the root level of the manifest, or included in an installer. Any values provided at the root level and not specified in an installer will be inherited. +
+ +
+ Architecture - The installer target architecture + + **Required Field** + + This key represents the hardware architecture targeted by the installer. The Windows Package Manager will attempt to determine the best architecture to use. If emulation is available and the native hardware architecture does not have a supported installer, the emulated architecture may be used. +
+ +
+ InstallerLocale - Locale for package installer + + **Optional Field** + + This key represents the locale for an installer *not* the package meta-data. Some installers are compiled with locale or language specific properties. If this key is present, it is used to represent the package locale for an installer. + + NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. + +
+ +
+ Platform - The installer supported operating system + + **Optional Field** + + This key represents the Windows platform targeted by the installer. The Windows Package Manager currently supports "Windows.Desktop" and "Windows.Universal". The Windows Package Manager client currently has no behavior associated with this property. It was added for future looking scenarios. + + NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. +
+ +
+ MinimumOSVersion - The installer minimum operating system version + + **Optional Field** + + This key represents the minimum version of the Windows operating system supported by the package. + + NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. +
+ +
+ InstallerType - Enumeration of supported installer types. + + **Required Field** + + This key represents the installer type for the package. The Windows Package Manager supports [MSIX], [MSI], and executable installers. Some well known formats ([Inno], [Nullsoft], [WiX], and [Burn]) provide standard sets of installer switches to provide different installer experiences. Portable packages are supported as of Windows Package Manager 1.3. Zip packages are supported as of Windows Package Manager 1.5. + + IMPORTANT: The Windows Package Manager does not support loose executables with the .exe or .com file extension directly. Progressive Web Applications (PWAs) and fonts are also not supported. + + NOTE: The Windows Package Manager defaults to the install mode providing install progress. A best practice is to determine if one of the supported installer technologies was used to build an installer with the .exe file extension. The [Windows Package Manager Manifest Creator] tool can be used to determine if one of the known tools was used to build an installer with the .exe file extension. + + NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. +
+ +
+ InstallerUrl - The installer Url + + **Required Field** + + This key represents the URL to download the installer. +
+ +
+ InstallerSha256 - Sha256 is required. Sha256 of the installer + + **Required Field** + + This key represents the SHA 256 hash for the installer. It is used to confirm the installer has not been modified. The Windows Package Manager will compare the hash in the manifest with the calculated hash of the installer after it has been downloaded. + + NOTE: The [Windows Package Manager Manifest Creator] can be used to determine the SHA 256 of the installer. The `winget hash <pathToInstaller>` command can also be used to determine the SHA 256 of the installer. +
+ +
+ SignatureSha256 - SignatureSha256 is recommended for appx or msix. It is the sha256 of the signature file inside the appx or msix. Could be used during streaming install if applicable. + + **Optional Field** + + This key represents the signature file (AppxSignature.p7x) inside an MSIX installer. It is used to provide streaming install for MSIX packages. + + IMPORTANT: MSIX installers must be signed to be included in the Microsoft community package repository. If the installer is an MSIX this signature should be included in the manifest. The [Windows Package Manager Manifest Creator] can be used to determine the signature SHA 256. The `winget hash --msix` command can also be used to determine the signature SHA 256. +
+ +
+ NestedInstallerType - NestedInstallerType is required when InstallerType is an archive type such as '.zip' + + **Required Field** + + This key represents the installer type of the file within the archive which will be used as the installer. +
+ +
+ NestedInstallerFiles - NestedInstallerFiles is required when InstallerType is an archive type such as '.zip' + + **Required Field** + + This key is a list of all the installers to be executed within an archive. + + > Note: This field can only contain one nested installer file unless the NestedInstallerType is 'portable' +
+ +
+ RelativeFilePath - RelativeFilePath is required within NestedInstallerFiles + + **Required Field** + + The relative path to the installer file contained within the archive. +
+ +
+ PortableCommandAlias - The command alias to be used for calling the package + + **Required Field** + + The alias which is added to the PATH for calling the package from the command line. + + > Note: This field is only valid when NestedInstallerType is 'portable' +
+ +
+ Scope - Scope indicates if the installer is per user or per machine + + **Optional Field** + + This key represents the scope the package is installed under. The two configurations are "user" and "machine". Some installers support only one of these scopes while others support both via arguments passed to the installer using "InstallerSwitches". + + NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. +
+ +
+ InstallModes - List of supported installer modes + + **Optional Field** + + This key represents the install modes supported by the installer. The Microsoft community package repository requires a package support "silent" and "silent with progress". The Windows Package Manager also supports "interactive" installers. The Windows Package Manager client does not have any behavior associated with this key. + + IMPORTANT: Some installers will attempt to install missing dependencies. If these dependencies require user interaction, the package will not be allowed into the Microsoft community package repository. + + NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. +
+ +
+ InstallerSwitches - Switches passed to installers + + **Optional Field** + + This key represents the set of switches passed to installers. + + IMPORTANT: The Microsoft community repository currently requires support for silent and silent with progress installation. Many custom .exe installers will require the proper switches to meet this requirement. The [Windows Package Manager Manifest Creator] tool can be used to determine if one of the known tools was used to build an installer with the .exe file extension. In the event the tool is unable to determine the tool used to build the installer, the publisher may have documentation for the proper switches. +
+ +
+ Silent - Silent is the value that should be passed to the installer when user chooses a silent or quiet install + + **Optional Field** + + This key represents switches passed to the installer to provide a silent install experience. These would be used when the command `winget install --silent` is executed. + + NOTE: When the Windows Package Manager installs a package using the "silent" install mode, any custom switches will also be passed to the installer. If a user applies override switches via command line via the Windows Package Manager, none of the switches from the manifest will be passed to the installer. + + NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. +
+ +
+ SilentWithProgress - SilentWithProgress is the value that should be passed to the installer when user chooses a non-interactive install + + **Optional Field** + + This key represents switches passed to the installer to provide a silent with progress install experience. This is intended to allow a progress indication to the user, and the indication may come from an installer UI dialogue, but it must not require user interaction to complete. The Windows Package Manager currently defaults to this install experience. + + NOTE: When the Windows Package Manager installs a package using the "silent with progress" install mode, any custom switches will also be passed to the installer. If a user applies override switches via command line via the Windows Package Manager, none of the switches from the manifest will be passed to the installer. +
+ +
+ Interactive - Interactive is the value that should be passed to the installer when user chooses an interactive install + + **Optional Field** + + This key represents switches passed to the installer to provide an interactive install experience. This is intended to allow a user to interact with the installer. These would be used when the command `winget install --interactive` is executed. + + NOTE: When the Windows Package Manager installs a package using the "interactive" install mode, any custom switches will also be passed to the installer. If a user applies override switches via command line via the Windows Package Manager, none of the switches from the manifest will be passed to the installer. +
+ +
+ InstallLocation - InstallLocation is the value passed to the installer for custom install location. + + **Optional Field** + + This key represents the path to install the package if the installer supports installing the package in a user configurable location. The **<INSTALLPATH>** token can be included in the switch value so the Windows Package Manager will replace the token with the user provided path. +
+ +
+ Log - Log is the value passed to the installer for custom log file path. + + **Optional Field** + + This key represents the path logs will be directed to if the installer supports specifying the log path in a user configurable location. The **<LOGPATH>** token can be included in the switch value so the Windows Package Manager will replace the token with the user provided path. +
+ +
+ Upgrade - Upgrade is the value that should be passed to the installer when user chooses an upgrade. + + **Optional Field** + + This key represents the switches to be passed to the installer during an upgrade. This will happen only if the upgrade behavior is "install". + + NOTE: If a user applies override switches via command line via the Windows Package Manager, none of the switches from the manifest will be passed to the installer. +
+ +
+ Custom - Custom switches will be passed directly to the installer by the Windows Package Manager. + + **Optional Field** + + This key represents any switches the Windows Package Manager will pass to the installer in addition to "Silent", "SilentWithProgress", and "Interactive". + + NOTE: If a user applies override switches via command line via the Windows Package Manager, none of the switches from the manifest will be passed to the installer. +
+ +
+ Repair - Repair is the value that should be passed to the installer when a user chooses to repair an existing installation + + **Optional Field** + + This key represents the switches to be passed during the repair of an existing installation. This will be passed to the installer, ModifyPath ARP command, or Uninstaller ARP command depending on the RepairBehavior specified in the manifest. + + NOTE: If a user applies override switches via command line via the Windows Package Manager, none of the switches from the manifest will be passed to the installer. +
+ +
+ UpgradeBehavior - The upgrade method + + **Optional Field** + + This key represents what the Windows Package Manager should do regarding the currently installed package during a package upgrade. If the package should be uninstalled first, the "uninstallPrevious" value should be specified. If the package should not be upgraded through WinGet, the "deny" value should be specified. + + NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. +
+ +
+ Commands - List of commands or aliases to run the package + + **Optional Field** + + This key represents any commands or aliases used to execute the package after it has been installed. + + IMPORTANT: The Windows Package Manager does not update the path during the install workflow. In those cases, the user may need to restart their shell or terminal before the command will execute the newly installed package. The Windows Package Manager does not support any behavior related to commands or aliases. + + NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. +
+ +
+ Protocols - List of protocols the package provides a handler for + + **Optional Field** + + This key represents any protocols supported by the package. The Windows Package Manager does not support any behavior related to protocols handled by a package. + + NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. +
+ +
+ FileExtensions - List of file extensions the package could support + + **Optional Field** + + This key represents any file extensions supported by the package. The Windows Package Manager does not support any behavior related to the file extensions supported by the package. + + NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. +
+ +
+ Dependencies - List of dependencies needed to install or execute the package + + **Optional Field** + + This key represents any dependencies required to install or run the package. + + IMPORTANT: The Windows Package Manager does not support any behavior related to dependencies. + + NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. +
+ +
+ ExternalDependencies - List of external package dependencies + + **Optional Field** + + This key represents any external dependencies required to install or run the package. + + IMPORTANT: The Windows Package Manager does not support any behavior related to dependencies. +
+ +
+ PackageDependencies - List of package dependencies from current source + + **Optional Field** + + This key represents any packages from the same source required to install or run the package. + + IMPORTANT: The Windows Package Manager does not support any behavior related to dependencies. +
+ +
+ WindowsFeatures - List of Windows feature dependencies + + **Optional Field** + + This key represents any Windows features required to install or run the package. + + IMPORTANT: The Windows Package Manager does not support any behavior related to dependencies. +
+ +
+ WindowsLibraries - List of Windows library dependencies + + **Optional Field** + + This key represents any Windows libraries required to install or run the package. + + IMPORTANT: The Windows Package Manager does not support any behavior related to dependencies. +
+ +
+ PackageFamilyName - PackageFamilyName for appx or msix installer. Could be used for correlation of packages across sources + + **Optional Field** + + This key represents the package family name specified in an MSIX installer. This value is used to assist with matching packages from a source to the program installed in Windows via Add / Remove Programs for list, and upgrade behavior. + + NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. +
+ +
+ Capabilities - List of appx or msix installer capabilities + + **Restricted Field** + + This key represents the capabilities provided by an MSIX package. More information is available for [App capability declarations] + + NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. +
+ +
+ RestrictedCapabilities - List of appx or msix installer restricted capabilities + + **Restricted Field** + + This key represents the restricted capabilities provided by an MSIX package.More information is available for [App capability declarations] + + NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. +
+ +
+ InstallerAbortsTerminal - Indicator for installers that abort the terminal. + + **Optional Field** + + This key represents the behavior associated with installers that abort the terminal. This most often occurs when a user is performing an upgrade of the running terminal. + + NOTE: Windows Terminal no longer causes this to occur as the MSIX install behavior from the Windows Package Manager is deferred registration. +
+ +
+ InstallLocationRequired - Indicator for packages requiring an install location to be specified. + + **Optional Field** + + This key represents the requirement to have an install location specified. These installers are known to deploy files to the location the installer is executed in. +
+ +
+ RequireExplicitUpgrade - Indicator for packages that upgrade themselves. + + **Optional Field** + + This key identifies packages that upgrade themselves. By default, they are excluded from `winget upgrade --all`. +
+ +
+ ElevationRequirement - Indicator for elevation behavior when installing or upgrading packages. + + **Optional Field** + + This key describes how the installer interacts with elevation (administrator privileges). It tells WinGet whether to request elevation on the user's behalf, whether the installer handles elevation itself, or whether elevation must be avoided entirely. + + - **elevationRequired** — The installer always requires administrator privileges to complete (e.g., it writes to `Program Files`, modifies system registry keys, or installs a Windows service). If WinGet is running in a non-elevated context, it will launch the installer elevated via a UAC prompt. + - **elevatesSelf** — The installer contains its own logic to determine whether elevation is needed and will request it when necessary. For example, the installer may check whether the current user is a member of the local Administrators group and automatically switch between a per-user and machine-wide installation. WinGet will not elevate the installer itself but will warn the user that a UAC prompt may appear. + - **elevationProhibited** — The installer must not be run from an elevated (administrator) context. If WinGet is running elevated, the installation will be blocked. + + > **Choosing between `elevationRequired` and `elevatesSelf`:** Use `elevationRequired` when the installer unconditionally needs administrator privileges due to what it installs (protected file locations, HKLM registry, system services). Use `elevatesSelf` when the installer has built-in logic that conditionally decides whether elevation is needed based on runtime checks. +
+ +
+ UnsupportedOSArchitectures - List of unsupported architectures for a package. + + **Optional Field** + + This key represents any architectures a package is known not to be compatible with. Generally, this is associated with emulation modes. +
+ +
+ Markets - List of supported markets for a package. + + **Restricted Field** + + This key represents any markets a package may be installed in. + + IMPORTANT: If a market is listed in both this key and the ExcludedMarkets key, the market will be excluded. Both keys are present to reduce the need to list the larger set of markets. +
+ +
+ ExcludedMarkets - List of unsupported markets for a package. + + **Restricted Field** + + This key represents any markets a package may not be installed in. + + IMPORTANT: If a market is listed in both this key and the Markets key, the market will be excluded. Both keys are present to reduce the need to list the larger set of markets. +
+ +
+ InstallerSuccessCodes - List of additional non-zero installer success exit codes other than known default values by the Windows Package Manager. + + **Optional Field** + + This key represents any status codes returned by the installer representing a success condition other than zero. + + IMPORTANT: Some return codes indicate a reboot is suggested or required. The Windows Package Manager does not support the reboot behavior currently. Some installers will force a reboot, and the Windows Package Manager does not currently suppress reboot behavior. + + NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. +
+ +
+ ExpectedReturnCodes - List of additional non-zero installer exit codes other than known default values by the Windows Package Manager. + + **Optional Field** + + This key represents any status codes returned by the installer representing a condition other than zero. + + IMPORTANT: Some return codes indicate a reboot is suggested or required. The Windows Package Manager does not support the reboot behavior currently. Some installers will force a reboot, and the Windows Package Manager does not currently suppress reboot behavior. + + NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. +
+ +
+ InstallerReturnCode - The non-zero installer exit code other than known default values by the Windows Package Manager. + + **Optional Field** + + This key represents any status code returned by the installer representing a condition other than zero. MSIX and MSI packages have well known return codes. This is primarily intended for executable installers that have custom or unique return coes that can be mapped to a return response. +
+ +
+ ReturnResponse - The return response to be displayed in the event an expected return code is encountered. + + **Optional Field** + + This key represents a return response to display when an installer returns an expected return code. MSIX and MSI packages have well known return codes. This is primarily intended for executable installers that have custom or unique return coes that can be mapped to a return response. + + NOTE: An enumerated list of values in the JSON schema must be specified for consistency of user experience. +
+ +
+ ReturnResponseUrl - The return response URL to be displayed in the event an expected return code is encountered. + + **Optional Field** + + This key represents a return response URL to display when an installer returns an expected return code. MSIX and MSI packages have well known return codes. This is primarily intended for executable installers that have custom or unique return codes that can be mapped to a return response. + + NOTE: An enumerated list of values in the JSON schema must be specified for consistency of user experience. +
+ +
+ ProductCode - ProductCode is used for correlation of packages with manifests in configured sources. + + **Optional Field** + + This key represents the product code specified in an MSI installer. This value is used to assist with matching packages from a source to the program installed in Windows via Add / Remove Programs for list, and upgrade behavior. + + NOTE: This key may be present in the root of the manifest as the default value for all installer nodes. This key may also be present in an individual installer node as well. If this key is in the manifest root and in an installer node, the value in the installer node will apply. +
+ +
+ AppsAndFeaturesEntries - AppsAndFeaturesEntries are used to match installed packages with manifests in configured sources. + + **Optional Field** + + This key represents the values reported by Windows Apps & Features. When a package is installed, entries are made into the Windows Registry. +
+ +
+ DisplayName - DisplayName is what is displayed in the Control Panel for installed packages. + + **Optional Field** + + This key represents the package name as displayed in Windows Apps & Features. It is used to help correlate installed packages with manifests in configured sources. +
+ +
+ DisplayVersion - DisplayVersion is the version displayed in the Control Panel for installed packages. + + **Optional Field** + + This key represents the package version as displayed in Windows Apps & Features. It is used to help correlate installed packages with manifests in configured sources. + + > Note: When the PackageVersion and DisplayVersion are the same, the DisplayVersion should be omitted from the AppsAndFeaturesEntries +
+ +
+ Publisher - Publisher is the value of the package publisher reported in the Windows registry. + + **Optional Field** + + This key represents the Publisher reported in the Windows registry. It is used to help correlate installed packages with manifests in configured sources. +
+ +
+ ProductCode - ProductCode is used for correlation of packages with manifests in configured sources. + + **Optional Field** + + This key represents the product code for a package. It is used to help correlate installed packages with manifests in configured sources. + + NOTE: This key is displayed twice for completeness. When AppsAndFeaturesEntries are specified, the ProductCode should be placed both within the installer and the AppsAndFeaturesEntries +
+ +
+ UpgradeCode - UpgradeCode is used for correlation of packages with manifests in configured sources. + + **Optional Field** + + This key represents the upgrade code for a package. It is used to help correlate installed packages with manifests in configured sources. +
+ +
+ InstallerType - Enumeration of supported installer types. + + **Optional Field** + + This key represents the installer type for the package. It is used to help correlate installed packages with manifests in configured sources. In some cases, an installer is an .exe based installer, but contains an MSI installer. This key will help the Windows Package Manager understand if upgrading an MSI should be performed when it is contained in an .exe installer. + + NOTE: This key is displayed twice for completeness. When AppsAndFeaturesEntries are specified, the InstallerType should be placed within the installer only, unless the AppsAndFeaturesEntries represent a different InstallerType +
+ +
+ UnsupportedArguments - List of unsupported Windows Package Manager Client arguments for an installer. + + **Optional Field** + + This key represents the list of Windows Package Manager Client arguments the installer does not support. Only the `--log` and `--location` arguments can be specified as unsupported arguments for an installer. + +
+ +
+ DisplayInstallWarnings - Indicator for displaying a warning message prior to install or upgrade. + + **Optional Field** + +This key represents whether a warning message is displayed to the user prior to install or upgrade if the package is known to interfere with any running applications. + +NOTE: The DisplayInstallWarnings behavior is not implemented in the Windows Package Manager 1.28 client. +
+ +
+ InstallationMetadata - Details about the installation. + + **Optional Field** + + This key allows for additional metadata to be used for deeper installation detection. +
+ +
+ DefaultInstallLocation - The default installed package location. + + **Optional Field** + + This key represents the default install location for the package. +
+ +
+ Files - The list of installed files. + + **Optional Field** + + This key represents the files installed for the package. +
+ +
+ RelativeFilePath - The relative path to the installed file. + + **Optional Field** + + This key represents the path to the installed file relative to the default install location. +
+ +
+ FileSha256 - The optional Sha256 of the installed file. + + **Optional Field** + + This key represents the Sha256 hash of the installed file. +
+ +
+ FileType - The optional installed file type. + + **Optional Field** + + This key represents the type of the installed file - `launch`, `uninstall`, or `other`. If not specified, the file is treated as `other`. +
+ +
+ InvocationParameter - Optional parameter for invocable files. + + **Optional Field** + + This key represents the parameter to use for invocable files. +
+ +
+ DisplayName - Optional display name for invocable files + + **Optional Field** + + This key represents the display name to use for invocable files. +
+ +
+ DownloadCommandProhibited - Optional indicator for packages which cannot be downloaded for offline installation + + **Optional Field** + + When `true`, this flag will prohibit the manifest from being downloaded for offline installation with the `winget download` command +
+ +
+ RepairBehavior - Optional repair method to use with 'winget repair` + + **Optional Field** + + This field controls what method is used to repair existing installations of packages. Specifying `modify` will use the ModifyPath string from the package's ARP data, `uninstaller` will use the Uninstall string from the package's ARP data, and `installer` will download and run the installer. In each case, the `Repair` value from `InstallerSwitches` will be added as an argument when invoking the command to repair the package. +
+ +
+ ArchiveBinariesDependOnPath - Optional indication to add the install location directly to PATH. Only applies to an archive containing portable packages + + **Optional Field** + + This field controls the behavior of environment variables when installing portable packages from an archive (i.e `zip`). Specifying `true` will add the install location directly to the `PATH` environment variable. Specifying `false` or leaving the value unset will use the default behavior of adding a symlink to the `links` folder, if supported, or adding the install location directly to `PATH` if symlinks are not supported. +
+ +
+ Authentication - Authentication information for Entra Id secured private sources + +**Restricted Field** + +This field controls the authentication for Entra ID secured private sources. Authentication type is required. Resource and scope information can be included if a specific resource is needed to download or install the package. + +
+ +
+ AuthenticationType - What type of authentication to use for Entra Id authentication + +**Restricted Field** + +This field controls the whether to use no authentication, Entra ID, or Entra ID for Azure Blob Storage. + +
+ +
+ MicrosoftEntraIdAuthenticationInfo - Information required for Entra Id authentication in private sources + +**Restricted Field** + +This field controls the authentication details used when downloading or installing packages from Entra Id secured private sources. + +
+ +
+ Resource - The resource to use for Microsoft Entra Id authentication + +**Restricted Field** + +This field controls the resource which will be used when using Entra Id for downloading or installing packages + +
+ +
+ Scope - The scope of Microsoft Entra Id authentication for the resource + +**Restricted Field** + +This field controls the scope which will be used when using Entra Id for downloading or installing packages + +
+ +
+ DesiredStateConfiguration - References to desired state configuration (DSC) resources that are related to the package + +**Optional Field** + +NOTE: The DesiredStateConfiguration behavior is not implemented in the Windows Package Manager 1.28 client. + +This field contains references to desired state configuration (DSC) resources that are related to the package. Resources may be provided as PowerShell modules or using the DSC v3 specification. + +
+ +
+ PowerShell - DSC resources contained in PowerShell modules + +**Restricted Field** + +NOTE: The PowerShell behavior is not implemented in the Windows Package Manager 1.28 client. + +This field references DSC resources contained in PowerShell modules. Adding references to PowerShell DSC resources requires participation in the Verified Developer program. The Verified Developer program is new and currently limited to a subset of Microsoft packages. A third-party Verified Developer program is planned for the future. + +
+ +
+ RepositoryUrl - The URL of the repository hosting the PowerShell module + +**Restricted Field** + +NOTE: The RepositoryUrl behavior is not implemented in the Windows Package Manager 1.28 client. + +This field controls the URL of the repository where the PowerShell module containing the DSC resources is published. + +
+ +
+ ModuleName - The name of the PowerShell module containing the DSC resources + +**Restricted Field** + +NOTE: The ModuleName behavior is not implemented in the Windows Package Manager 1.28 client. + +This field controls the name of the PowerShell module containing the DSC resources. + +
+ +
+ Resources - The DSC resources contained in the PowerShell module + +**Restricted Field** + +NOTE: The Resources behavior is not implemented in the Windows Package Manager 1.28 client. + +This field lists the DSC resources contained in the PowerShell module. + +
+ +
+ Name - The name of the PowerShell DSC resource + +**Restricted Field** + +NOTE: The Name behavior is not implemented in the Windows Package Manager 1.28 client. + +This field controls the name of an individual PowerShell DSC resource contained in the module. + +
+ +
+ DSCv3 - DSC resources contained in the package using the DSC v3 specification + +**Optional Field** + +NOTE: The DSCv3 behavior is not implemented in the Windows Package Manager 1.28 client. + +This field references DSC resources implemented in the package using the DSC v3 specification. + +
+ +
+ Type - The fully qualified type name of the DSC v3 resource + +**Optional Field** + +NOTE: The Type behavior is not implemented in the Windows Package Manager 1.28 client. + +This field controls the fully qualified type name of the DSC v3 resource. The type name matches the pattern `Publisher.Product.Component/ResourceName`, where Product and Component are optional. + +
+ +
+ ManifestType - The manifest type + + **Required Field** + + This key must have the value "installer". The Microsoft community package repository validation pipelines also use this value to determine appropriate validation rules when evaluating this file. +
+ +
+ ManifestVersion - The manifest syntax version + + **Required Field** + + This key must have the value "1.28.0". The Microsoft community package repository validation pipelines also use this value to determine appropriate validation rules when evaluating this file. +
diff --git a/doc/manifest/schema/1.28.0/version.md b/doc/manifest/schema/1.28.0/version.md new file mode 100644 index 0000000000000..13ddcf3875239 --- /dev/null +++ b/doc/manifest/schema/1.28.0/version.md @@ -0,0 +1,71 @@ +[JSON schema]: https://github.com/microsoft/winget-cli/blob/master/schemas/JSON/manifests/v1.28.0/manifest.version.1.28.0.json +[YAML]: https://yaml.org/spec +[semantic version]: https://semver.org + +# Windows Package Manager +## Manifest Schema v1.28.0 Version File + +All Windows Package Manager manifests in the Microsoft community repository are submitted using [YAML] syntax. A [JSON schema] is provided to aid authoring these files in editors, and in the other tooling related to the Windows Package Manager. This document provides detailed information regarding the usage of the YAML keys in the version file for multi-file manifests. + +### Version Manifest + +```YAML +PackageIdentifier: # The package unique identifier +PackageVersion: # The package version +DefaultLocale: # The default package meta-data locale +ManifestType: version # The manifest type +ManifestVersion: 1.28.0 # The manifest syntax version +``` + +## Fields + +
+ PackageIdentifier - The package unique identifier + + **Required Field** + + This key is the unique identifier for a given package. + + **Windows Package Manager Community Repository** + + This value is generally in the form of `Publisher.Package`. It is case sensitive, and this value must match the folder structure under the partition directory. +
+ +
+ PackageVersion - The package version + + **Required Field** + + This key represents the version of the package. It is related to the specific release this manifests targets. In some cases you will see a perfectly formed [semantic version] number, and in other cases you might see something different. These may be date driven, or they might have other characters with some package specific meaning for example. + + The Windows Package Manager client uses this version to determine whether or not an upgrade for a package is available. In some cases, packages may be released with a marketing driven version, and that causes trouble with the `winget upgrade` command. + + The current best practice is to use the value reported in Add / Remove Programs when this version of the package is installed. In some cases, packages do not report a version resulting in an upgrade loop or other unwanted behavior. +
+ +
+ DefaultLocale - The default package meta-data locale + + **Required Field** + + This key represents the default locale for package meta-data. The format is BCP-47. This value identifies the language for meta-data to be displayed to a user when no locale file matching their preferences is available. + + **Windows Package Manager Community Repository** + + The validation pipelines use this value to ensure the corresponding locale file is present and conforms with the defaultLocale YAML specification. +
+ +
+ ManifestType - The manifest type + + **Required Field** + + This key must have the value "version". The Microsoft community package repository validation pipelines also use this value to determine appropriate validation rules when evaluating this file. +
+ +
+ ManifestVersion - The manifest syntax version + + **Required Field** + This key must have the value "1.28.0". The Microsoft community package repository validation pipelines also use this value to determine appropriate validation rules when evaluating this file. +
diff --git a/manifests/a/Alibaba/OpenCodeReview/1.8.8/Alibaba.OpenCodeReview.installer.yaml b/manifests/a/Alibaba/OpenCodeReview/1.8.8/Alibaba.OpenCodeReview.installer.yaml new file mode 100644 index 0000000000000..c5e8b7a5129f0 --- /dev/null +++ b/manifests/a/Alibaba/OpenCodeReview/1.8.8/Alibaba.OpenCodeReview.installer.yaml @@ -0,0 +1,18 @@ +# Created with YamlCreate.ps1 Dumplings Mod +# yaml-language-server: $schema=https://aka.ms/winget-manifest.installer.1.12.0.schema.json + +PackageIdentifier: Alibaba.OpenCodeReview +PackageVersion: 1.8.8 +InstallerType: portable +Commands: +- opencodereview +ReleaseDate: 2026-08-04 +Installers: +- Architecture: x64 + InstallerUrl: https://github.com/alibaba/open-code-review/releases/download/v1.8.8/opencodereview-windows-amd64.exe + InstallerSha256: 67825FC8A35CDF2AF484CEE6CB232AC53C4A4E83D4B6F13599A37D7F716F32D6 +- Architecture: arm64 + InstallerUrl: https://github.com/alibaba/open-code-review/releases/download/v1.8.8/opencodereview-windows-arm64.exe + InstallerSha256: 044D16A38F4B115FF225816FD9CB384D002B8A3AAF788091F7A00CB074103B8B +ManifestType: installer +ManifestVersion: 1.12.0 diff --git a/manifests/a/Alibaba/OpenCodeReview/1.8.8/Alibaba.OpenCodeReview.locale.en-US.yaml b/manifests/a/Alibaba/OpenCodeReview/1.8.8/Alibaba.OpenCodeReview.locale.en-US.yaml new file mode 100644 index 0000000000000..e2552300cdca6 --- /dev/null +++ b/manifests/a/Alibaba/OpenCodeReview/1.8.8/Alibaba.OpenCodeReview.locale.en-US.yaml @@ -0,0 +1,38 @@ +# Created with YamlCreate.ps1 Dumplings Mod +# yaml-language-server: $schema=https://aka.ms/winget-manifest.defaultLocale.1.12.0.schema.json + +PackageIdentifier: Alibaba.OpenCodeReview +PackageVersion: 1.8.8 +PackageLocale: en-US +Publisher: Alibaba +PublisherUrl: https://github.com/alibaba +PublisherSupportUrl: https://github.com/alibaba/open-code-review/issues +PackageName: Open Code Review +PackageUrl: https://github.com/alibaba/open-code-review +License: Apache-2.0 +LicenseUrl: https://github.com/alibaba/open-code-review/blob/HEAD/LICENSE +Copyright: Copyright 2026 Alibaba +ShortDescription: The open source AI code review agent. +Description: |- + Open Code Review is an AI-powered code review CLI tool. It originated as Alibaba Group's internal official AI code review assistant — over the past two years, it has served tens of thousands of developers and identified millions of code defects. After thorough validation at massive scale, we incubated it into an open source project for the community. Simply configure a model endpoint to get started. + It reads Git diffs, sends changed files to a configurable LLM via an agent with tool-use capabilities, and generates structured review comments with line-level precision. The agent can read full file contents, search the codebase, inspect other changed files for context, and produce deep reviews — not just surface-level diff feedback. +Tags: +- ai +- code +- review +ReleaseNotes: |- + 🚀 Features + - feat(viewer): add repository search filter (#642) + - feat(allowlist): add Nix support (#615) + - feat(allowlist): add Haskell support (#672) + 🐛 Bug Fixes + - fix(vscode): upgrade transitive deps to resolve security alerts (#713) + 🔧 Refactoring + - refactor(session): use strings.Contains in resume_test.go (#708) + Other Changes + - Create codeql.yml (#714) + - ci: limit container CPU to 2 cores for stable multi-runner concurrency (#711) + Full Changelog: https://github.com/alibaba/open-code-review/compare/v1.8.7...v1.8.8 +ReleaseNotesUrl: https://github.com/alibaba/open-code-review/releases/tag/v1.8.8 +ManifestType: defaultLocale +ManifestVersion: 1.12.0 diff --git a/manifests/a/Alibaba/OpenCodeReview/1.8.8/Alibaba.OpenCodeReview.locale.zh-CN.yaml b/manifests/a/Alibaba/OpenCodeReview/1.8.8/Alibaba.OpenCodeReview.locale.zh-CN.yaml new file mode 100644 index 0000000000000..5e4ac5b90de3b --- /dev/null +++ b/manifests/a/Alibaba/OpenCodeReview/1.8.8/Alibaba.OpenCodeReview.locale.zh-CN.yaml @@ -0,0 +1,16 @@ +# Created with YamlCreate.ps1 Dumplings Mod +# yaml-language-server: $schema=https://aka.ms/winget-manifest.locale.1.12.0.schema.json + +PackageIdentifier: Alibaba.OpenCodeReview +PackageVersion: 1.8.8 +PackageLocale: zh-CN +ShortDescription: 开源的 AI 代码审查智能体。 +Description: |- + Open Code Review 是一款 AI 驱动的代码审查 CLI 工具。它的前身是阿里集团内部官方 AI 代码审查助手,过去两年在内部服务了数万开发者,识别了数百万个代码缺陷。经过大规模充分验证后,我们将其孵化为开源项目,对社区开放。只需配置一个模型端点即可使用。 + 它读取 Git diff,通过具备工具调用能力的 Agent 将变更文件发送至可配置的 LLM,生成具有行级精度的结构化审查意见。Agent 可以读取完整文件内容、搜索代码库、检查其他变更文件以获取上下文,从而进行深度审查——而非仅停留在表面的 diff 反馈。 +Tags: +- 人工智能 +- 代码 +- 审查 +ManifestType: locale +ManifestVersion: 1.12.0 diff --git a/manifests/a/Alibaba/OpenCodeReview/1.8.8/Alibaba.OpenCodeReview.yaml b/manifests/a/Alibaba/OpenCodeReview/1.8.8/Alibaba.OpenCodeReview.yaml new file mode 100644 index 0000000000000..24b7937006196 --- /dev/null +++ b/manifests/a/Alibaba/OpenCodeReview/1.8.8/Alibaba.OpenCodeReview.yaml @@ -0,0 +1,8 @@ +# Created with YamlCreate.ps1 Dumplings Mod +# yaml-language-server: $schema=https://aka.ms/winget-manifest.version.1.12.0.schema.json + +PackageIdentifier: Alibaba.OpenCodeReview +PackageVersion: 1.8.8 +DefaultLocale: en-US +ManifestType: version +ManifestVersion: 1.12.0 diff --git a/manifests/a/Amazon/AWSCLI/2.36.16/Amazon.AWSCLI.installer.yaml b/manifests/a/Amazon/AWSCLI/2.36.16/Amazon.AWSCLI.installer.yaml new file mode 100644 index 0000000000000..adafc35886e8a --- /dev/null +++ b/manifests/a/Amazon/AWSCLI/2.36.16/Amazon.AWSCLI.installer.yaml @@ -0,0 +1,24 @@ +# Created with YamlCreate.ps1 Dumplings Mod +# yaml-language-server: $schema=https://aka.ms/winget-manifest.installer.1.12.0.schema.json + +PackageIdentifier: Amazon.AWSCLI +PackageVersion: 2.36.16 +InstallerType: wix +Scope: machine +InstallerSwitches: + InstallLocation: AWSCLIV2="" +UpgradeBehavior: install +Commands: +- aws +ProductCode: '{CC0B1052-33AC-4C08-88EF-36AD7435543E}' +ReleaseDate: 2026-08-04 +AppsAndFeaturesEntries: +- UpgradeCode: '{E1C1971C-384E-4D6D-8D02-F1AC48281CF8}' +InstallationMetadata: + DefaultInstallLocation: '%ProgramFiles%\Amazon\AWSCLIV2' +Installers: +- Architecture: x64 + InstallerUrl: https://awscli.amazonaws.com/AWSCLIV2-2.36.16.msi + InstallerSha256: 0B94DE55CD02D573F7EA0C4EC0EEF14917F79563C0E3CD8AC1BF8478B0DCDB39 +ManifestType: installer +ManifestVersion: 1.12.0 diff --git a/manifests/a/Amazon/AWSCLI/2.36.16/Amazon.AWSCLI.locale.en-US.yaml b/manifests/a/Amazon/AWSCLI/2.36.16/Amazon.AWSCLI.locale.en-US.yaml new file mode 100644 index 0000000000000..07d8843196aae --- /dev/null +++ b/manifests/a/Amazon/AWSCLI/2.36.16/Amazon.AWSCLI.locale.en-US.yaml @@ -0,0 +1,28 @@ +# Created with YamlCreate.ps1 Dumplings Mod +# yaml-language-server: $schema=https://aka.ms/winget-manifest.defaultLocale.1.12.0.schema.json + +PackageIdentifier: Amazon.AWSCLI +PackageVersion: 2.36.16 +PackageLocale: en-US +Publisher: Amazon Web Services +PublisherUrl: https://aws.amazon.com/ +PublisherSupportUrl: https://github.com/aws/aws-cli/issues +PrivacyUrl: https://aws.amazon.com/privacy/ +Author: Amazon Web Services, Inc +PackageName: AWS Command Line Interface +PackageUrl: https://aws.amazon.com/cli/ +License: Apache-2.0 +LicenseUrl: https://github.com/aws/aws-cli/blob/HEAD/LICENSE.txt +Copyright: Copyright 2012-2026 Amazon.com, Inc. +CopyrightUrl: https://aws.amazon.com/agreement/ +ShortDescription: Universal Command Line Interface for Amazon Web Services +Description: The AWS Command Line Interface (AWS CLI) is an open source tool that enables you to interact with AWS services using commands in your command-line shell. With minimal configuration, the AWS CLI enables you to start running commands that implement functionality equivalent to that provided by the browser-based AWS Management Console from the command prompt in your terminal program. +Tags: +- aws +- awscli +- cli +- cloud +- s3 +- web +ManifestType: defaultLocale +ManifestVersion: 1.12.0 diff --git a/manifests/a/Amazon/AWSCLI/2.36.16/Amazon.AWSCLI.locale.zh-CN.yaml b/manifests/a/Amazon/AWSCLI/2.36.16/Amazon.AWSCLI.locale.zh-CN.yaml new file mode 100644 index 0000000000000..4b6e9372d823f --- /dev/null +++ b/manifests/a/Amazon/AWSCLI/2.36.16/Amazon.AWSCLI.locale.zh-CN.yaml @@ -0,0 +1,14 @@ +# Created with YamlCreate.ps1 Dumplings Mod +# yaml-language-server: $schema=https://aka.ms/winget-manifest.locale.1.12.0.schema.json + +PackageIdentifier: Amazon.AWSCLI +PackageVersion: 2.36.16 +PackageLocale: zh-CN +PublisherUrl: https://aws.amazon.com/cn/ +PrivacyUrl: https://aws.amazon.com/cn/privacy/ +PackageUrl: https://aws.amazon.com/cn/cli/ +CopyrightUrl: https://aws.amazon.com/cn/agreement/ +ShortDescription: Amazon Web Services 的通用命令行界面 +Description: AWS 命令行界面(AWS CLI)是一种开源工具,让您能够使用命令行 Shell 中的命令与 AWS 服务进行交互。AWS CLI 让您只需极少的配置,就能从终端程序的命令提示符中运行命令,以实施与基于浏览器的 AWS 管理控制台提供的功能等效的命令。 +ManifestType: locale +ManifestVersion: 1.12.0 diff --git a/manifests/a/Amazon/AWSCLI/2.36.16/Amazon.AWSCLI.yaml b/manifests/a/Amazon/AWSCLI/2.36.16/Amazon.AWSCLI.yaml new file mode 100644 index 0000000000000..11009e1db1ecd --- /dev/null +++ b/manifests/a/Amazon/AWSCLI/2.36.16/Amazon.AWSCLI.yaml @@ -0,0 +1,8 @@ +# Created with YamlCreate.ps1 Dumplings Mod +# yaml-language-server: $schema=https://aka.ms/winget-manifest.version.1.12.0.schema.json + +PackageIdentifier: Amazon.AWSCLI +PackageVersion: 2.36.16 +DefaultLocale: en-US +ManifestType: version +ManifestVersion: 1.12.0 diff --git a/manifests/a/Ankama/AnkamaLauncher/3.14.9.20391/Ankama.AnkamaLauncher.locale.en-US.yaml b/manifests/a/Ankama/AnkamaLauncher/3.14.9.20391/Ankama.AnkamaLauncher.locale.en-US.yaml deleted file mode 100644 index e03a0bd9028f1..0000000000000 --- a/manifests/a/Ankama/AnkamaLauncher/3.14.9.20391/Ankama.AnkamaLauncher.locale.en-US.yaml +++ /dev/null @@ -1,13 +0,0 @@ -# Automatically updated by the winget bot at 2026/May/05 -# yaml-language-server: $schema=https://aka.ms/winget-manifest.defaultLocale.1.12.0.schema.json - -PackageIdentifier: Ankama.AnkamaLauncher -PackageVersion: 3.14.9.20391 -PackageLocale: en-US -Publisher: Ankama -PackageName: Ankama Launcher -License: https://account.ankama.com/en/tou -Copyright: Copyright © 2025 Ankama -ShortDescription: Ankama portal and game launcher -ManifestType: defaultLocale -ManifestVersion: 1.12.0 diff --git a/manifests/a/Ankama/AnkamaLauncher/3.14.9.20391/Ankama.AnkamaLauncher.installer.yaml b/manifests/a/Ankama/AnkamaLauncher/3.15.2.20509/Ankama.AnkamaLauncher.installer.yaml similarity index 61% rename from manifests/a/Ankama/AnkamaLauncher/3.14.9.20391/Ankama.AnkamaLauncher.installer.yaml rename to manifests/a/Ankama/AnkamaLauncher/3.15.2.20509/Ankama.AnkamaLauncher.installer.yaml index bf7239736704d..ad704084a310f 100644 --- a/manifests/a/Ankama/AnkamaLauncher/3.14.9.20391/Ankama.AnkamaLauncher.installer.yaml +++ b/manifests/a/Ankama/AnkamaLauncher/3.15.2.20509/Ankama.AnkamaLauncher.installer.yaml @@ -1,18 +1,16 @@ -# Automatically updated by the winget bot at 2026/May/05 # yaml-language-server: $schema=https://aka.ms/winget-manifest.installer.1.12.0.schema.json PackageIdentifier: Ankama.AnkamaLauncher -PackageVersion: 3.14.9.20391 +PackageVersion: 3.15.2.20509 +ReleaseDate: 2026-07-27 InstallerLocale: en-US InstallerType: nullsoft -ReleaseDate: 2026-03-02 ProductCode: 410fcd79-1be8-5bf1-986e-ea09c55f7edf AppsAndFeaturesEntries: -- DisplayName: Ankama Launcher 3.14.2 - DisplayVersion: 3.14.9 +- ProductCode: 410fcd79-1be8-5bf1-986e-ea09c55f7edf Installers: - Architecture: x64 InstallerUrl: https://launcher.cdn.ankama.com/installers/production/Ankama%20Launcher-Setup.exe - InstallerSha256: 2CC51AC7A05D0180C068F0A4BF352D8890093118BC03988FC6CB560BB7B35F8E + InstallerSha256: 9742C4449FE415148B42882477915AB2555834499A887BF9A02D51AAEC9A2F14 ManifestType: installer ManifestVersion: 1.12.0 diff --git a/manifests/a/Ankama/AnkamaLauncher/3.15.2.20509/Ankama.AnkamaLauncher.locale.en-US.yaml b/manifests/a/Ankama/AnkamaLauncher/3.15.2.20509/Ankama.AnkamaLauncher.locale.en-US.yaml new file mode 100644 index 0000000000000..119b3016860e6 --- /dev/null +++ b/manifests/a/Ankama/AnkamaLauncher/3.15.2.20509/Ankama.AnkamaLauncher.locale.en-US.yaml @@ -0,0 +1,31 @@ +# yaml-language-server: $schema=https://aka.ms/winget-manifest.defaultLocale.1.12.0.schema.json + +PackageIdentifier: Ankama.AnkamaLauncher +PackageVersion: 3.15.2.20509 +PackageLocale: en-US +Publisher: Ankama +PackageName: Ankama Launcher +License: https://account.ankama.com/en/tou +Copyright: © 2026 Ankama +ShortDescription: A portal that lets you access all of Ankama's many universes with just a single click! Connect to our video games, VOD animations, webtoons, and even our livestreams. Download updates, stay up to date with the latest news, and chat with your friends. +PackageUrl: https://www.ankama.com/en/launcher +Moniker: ankamalauncher +Tags: +- ankama-launcher +- game-launcher +- game-client +- abraca +- dofus +- fly'n +- flyn +- krosfighter +- maliki-poison-of-the-past +- malikipoisonofthepast +- mmorpg +- savara +- super-nano-blaster +- supernanoblaster +- wakfu +- waven +ManifestType: defaultLocale +ManifestVersion: 1.12.0 diff --git a/manifests/a/Ankama/AnkamaLauncher/3.15.2.20509/Ankama.AnkamaLauncher.locale.fr-FR.yaml b/manifests/a/Ankama/AnkamaLauncher/3.15.2.20509/Ankama.AnkamaLauncher.locale.fr-FR.yaml new file mode 100644 index 0000000000000..b7607feec6174 --- /dev/null +++ b/manifests/a/Ankama/AnkamaLauncher/3.15.2.20509/Ankama.AnkamaLauncher.locale.fr-FR.yaml @@ -0,0 +1,25 @@ +# yaml-language-server: $schema=https://aka.ms/winget-manifest.locale.1.12.0.schema.json + +PackageIdentifier: Ankama.AnkamaLauncher +PackageVersion: 3.15.2.20509 +PackageLocale: fr-FR +PackageUrl: https://www.ankama.com/fr/games +Tags: +- ankama-launcher +- ankamalauncher +- client-de-jeux +- abraca +- dofus +- fly'n +- flyn +- krosfighter +- maliki-poison-of-the-past +- malikipoisonofthepast +- mmorpg +- savara +- super-nano-blaster +- supernanoblaster +- wakfu +- waven +ManifestType: locale +ManifestVersion: 1.12.0 \ No newline at end of file diff --git a/manifests/a/Ankama/AnkamaLauncher/3.14.9.20391/Ankama.AnkamaLauncher.yaml b/manifests/a/Ankama/AnkamaLauncher/3.15.2.20509/Ankama.AnkamaLauncher.yaml similarity index 67% rename from manifests/a/Ankama/AnkamaLauncher/3.14.9.20391/Ankama.AnkamaLauncher.yaml rename to manifests/a/Ankama/AnkamaLauncher/3.15.2.20509/Ankama.AnkamaLauncher.yaml index e3accfc24f712..49098a403fde0 100644 --- a/manifests/a/Ankama/AnkamaLauncher/3.14.9.20391/Ankama.AnkamaLauncher.yaml +++ b/manifests/a/Ankama/AnkamaLauncher/3.15.2.20509/Ankama.AnkamaLauncher.yaml @@ -1,8 +1,8 @@ -# Automatically updated by the winget bot at 2026/May/05 +# Automatically updated by the winget bot at 2026/Aug/02 # yaml-language-server: $schema=https://aka.ms/winget-manifest.version.1.12.0.schema.json PackageIdentifier: Ankama.AnkamaLauncher -PackageVersion: 3.14.9.20391 +PackageVersion: 3.15.2.20509 DefaultLocale: en-US ManifestType: version ManifestVersion: 1.12.0 diff --git a/manifests/a/Asana/Asana/2.8.0/Asana.Asana.installer.yaml b/manifests/a/Asana/Asana/2.8.0/Asana.Asana.installer.yaml new file mode 100644 index 0000000000000..46a41ba8863ae --- /dev/null +++ b/manifests/a/Asana/Asana/2.8.0/Asana.Asana.installer.yaml @@ -0,0 +1,23 @@ +# Created with YamlCreate.ps1 Dumplings Mod +# yaml-language-server: $schema=https://aka.ms/winget-manifest.installer.1.12.0.schema.json + +PackageIdentifier: Asana.Asana +PackageVersion: 2.8.0 +InstallerType: exe +Scope: user +InstallModes: +- interactive +- silent +InstallerSwitches: + Silent: --silent + SilentWithProgress: --silent +Protocols: +- asanadesktop +ProductCode: Asana +ReleaseDate: 2026-08-04 +Installers: +- Architecture: x64 + InstallerUrl: https://desktop-downloads.asana.com/win32_x64/prod/v2.8.0/AsanaSetup.exe + InstallerSha256: D66ED0F30B7B9DB1D102622A9BE1C6B7C2459033EF85CA7BA2F19B700257CFEE +ManifestType: installer +ManifestVersion: 1.12.0 diff --git a/manifests/a/Asana/Asana/2.8.0/Asana.Asana.locale.en-US.yaml b/manifests/a/Asana/Asana/2.8.0/Asana.Asana.locale.en-US.yaml new file mode 100644 index 0000000000000..3bf5323897efa --- /dev/null +++ b/manifests/a/Asana/Asana/2.8.0/Asana.Asana.locale.en-US.yaml @@ -0,0 +1,36 @@ +# Created with YamlCreate.ps1 Dumplings Mod +# yaml-language-server: $schema=https://aka.ms/winget-manifest.defaultLocale.1.12.0.schema.json + +PackageIdentifier: Asana.Asana +PackageVersion: 2.8.0 +PackageLocale: en-US +Publisher: Asana, Inc. +PublisherUrl: https://asana.com/ +PublisherSupportUrl: https://help.asana.com/ +PrivacyUrl: https://asana.com/terms/privacy-statement +Author: Asana, Inc. +PackageName: Asana +PackageUrl: https://asana.com/download +License: Proprietary +LicenseUrl: https://asana.com/terms/terms-of-service +Copyright: © 2026 Asana, Inc. +CopyrightUrl: https://asana.com/terms/terms-of-service +ShortDescription: Manage your team’s work, projects, & tasks online +Description: Asana is a leader in collaborative project management software for teams, no matter their size or locational distribution. Asana helps you, your teams, and your stakeholders collaborate faster and smoother to achieve business objectives. +Tags: +- billboard +- collaborate +- collaboration +- docs +- document +- manage +- management +- office +- project +- task +- team +- work +- working +PurchaseUrl: https://asana.com/pricing +ManifestType: defaultLocale +ManifestVersion: 1.12.0 diff --git a/manifests/a/Asana/Asana/2.8.0/Asana.Asana.locale.zh-CN.yaml b/manifests/a/Asana/Asana/2.8.0/Asana.Asana.locale.zh-CN.yaml new file mode 100644 index 0000000000000..ccfc06cf96507 --- /dev/null +++ b/manifests/a/Asana/Asana/2.8.0/Asana.Asana.locale.zh-CN.yaml @@ -0,0 +1,22 @@ +# Created with YamlCreate.ps1 Dumplings Mod +# yaml-language-server: $schema=https://aka.ms/winget-manifest.locale.1.12.0.schema.json + +PackageIdentifier: Asana.Asana +PackageVersion: 2.8.0 +PackageLocale: zh-CN +License: 专有软件 +ShortDescription: 在线管理团队的工作、项目与任务 +Description: Asana 是团队协作项目管理软件的领军者,无论团队规模大小或地域分布如何。它能帮助您、您的团队及相关方更高效顺畅地协作,共同达成业务目标。 +Tags: +- 任务 +- 办公 +- 协作 +- 协同 +- 团队 +- 工作 +- 文档 +- 看板 +- 管理 +- 项目 +ManifestType: locale +ManifestVersion: 1.12.0 diff --git a/manifests/a/Asana/Asana/2.8.0/Asana.Asana.yaml b/manifests/a/Asana/Asana/2.8.0/Asana.Asana.yaml new file mode 100644 index 0000000000000..e820f8b5b499a --- /dev/null +++ b/manifests/a/Asana/Asana/2.8.0/Asana.Asana.yaml @@ -0,0 +1,8 @@ +# Created with YamlCreate.ps1 Dumplings Mod +# yaml-language-server: $schema=https://aka.ms/winget-manifest.version.1.12.0.schema.json + +PackageIdentifier: Asana.Asana +PackageVersion: 2.8.0 +DefaultLocale: en-US +ManifestType: version +ManifestVersion: 1.12.0 diff --git a/manifests/a/Atuinsh/Atuin/18.19.0/Atuinsh.Atuin.installer.yaml b/manifests/a/Atuinsh/Atuin/18.19.0/Atuinsh.Atuin.installer.yaml new file mode 100644 index 0000000000000..84a6c060fa50f --- /dev/null +++ b/manifests/a/Atuinsh/Atuin/18.19.0/Atuinsh.Atuin.installer.yaml @@ -0,0 +1,23 @@ +# Created with komac v2.16.0 +# yaml-language-server: $schema=https://aka.ms/winget-manifest.installer.1.12.0.schema.json + +PackageIdentifier: Atuinsh.Atuin +PackageVersion: 18.19.0 +InstallerType: zip +NestedInstallerType: portable +NestedInstallerFiles: +- RelativeFilePath: atuin.exe + PortableCommandAlias: atuin +InstallModes: +- silent +- silentWithProgress +UpgradeBehavior: install +Commands: +- atuin +ReleaseDate: 2026-08-03 +Installers: +- Architecture: x64 + InstallerUrl: https://github.com/atuinsh/atuin/releases/download/v18.19.0/atuin-x86_64-pc-windows-msvc.zip + InstallerSha256: 905F4C08D05E018723341DABDCB2FD5BEE705BB1E1B76D876A6CEDEECE9BB307 +ManifestType: installer +ManifestVersion: 1.12.0 diff --git a/manifests/a/Atuinsh/Atuin/18.19.0/Atuinsh.Atuin.locale.en-US.yaml b/manifests/a/Atuinsh/Atuin/18.19.0/Atuinsh.Atuin.locale.en-US.yaml new file mode 100644 index 0000000000000..7e8696ee40ed0 --- /dev/null +++ b/manifests/a/Atuinsh/Atuin/18.19.0/Atuinsh.Atuin.locale.en-US.yaml @@ -0,0 +1,138 @@ +# Created with komac v2.16.0 +# yaml-language-server: $schema=https://aka.ms/winget-manifest.defaultLocale.1.12.0.schema.json + +PackageIdentifier: Atuinsh.Atuin +PackageVersion: 18.19.0 +PackageLocale: en-US +Publisher: Atuin +PublisherUrl: https://atuin.sh/ +PublisherSupportUrl: https://github.com/atuinsh/atuin/issues +Author: Ellie Huxtable +PackageName: Atuin +PackageUrl: https://github.com/atuinsh/atuin +License: MIT +LicenseUrl: https://github.com/atuinsh/atuin/blob/HEAD/LICENSE +Copyright: Ellie Huxtable +ShortDescription: ✨ Magical shell history +Description: Atuin replaces your existing shell history with a SQLite database, and records additional context for your commands. +Moniker: atuin +Tags: +- history +- powershell +- rust +- shell +ReleaseNotes: |- + Release Notes + Bug Fixes + - (client) Avoid panic decoding an empty encryption key (#3803) + - (client) Keep sqlx-postgres out of the client crate (#2884) (#3823) + - (config) Preserve comments in atuin config set (#3766) + - (search) Correct fuzzy result ranking (#3603) (#3624) + - Fix atuin-search-bench/benches/search.rs (#3788) + - Close OSC133 C when launching Atuin AI to prevent content erasure (#3794) + - Authenticate beta release push as atuin-bot (#3809) + - Copy vendored axoasset into docker builder stage (#3816) + Documentation + - Clarify update check network, provide build command (#3767) + - Remove old i18n docs (#3787) + - Use shell-agnostic install command in quickstart pages (#3820) + - Document named stats periods (today/week/month/year) (#3821) + - State minimum supported Rust version in install guide (#3822) + - Document iTerm2 tmux popup incompatibility (#3826) + - Clarify key binding snippets belong in shell startup file (#3837) + - Mention RustRover in IDE integration guidance (#3834) + Features + - (client) Show intent in inspector (#3804) + - (client) Enable pty-proxy via config (#3828) + - (config) Validate new settings in atuin config set before writing them to disk (#3769) + - (lab) Experimental atuin lab share + - (search) Remove the "skim" engine (#3825) + - Remove word with ALT-Backspace ALT-D (#2457) + - Add scheduled beta release workflow (#3805) + - Migrate TLS backend from rustls to native-tls (#3807) + - Make update a real subcommand (#3813) + - Capability negotiation protocol (client + server) (#3797) + Miscellaneous Tasks + - (ci) Fix package step (#3770) + - Remove Store trait (#3779) + - Daemon search benchmark (divan + CodSpeed) (#3763) + - Run CodSpeed benchmarks on macro runners in walltime mode (#3786) + - Add OrFilter as a replacement for Vecs as filter lists (#3768) + - Add atuin-domain crate for shared domain types (#3790) + - Run CodSpeed walltime benchmarks on depot-macos-26 (#3791) + - Fix deny.toml and get it to run in CI (#3808) + - Remove codspeed workflow (#3812) + - Richer logging for atuin-server (#2564) + - Hide --active sharing (#3846) + Refactor + - (deps) Bump thiserror from 2.0.18 to 2.0.19 (#3839) + - (deps) Bump strum_macros from 0.27.2 to 0.28.0 (#3841) + - (deps) Bump tonic-types from 0.14.5 to 0.14.6 (#3842) + - (deps) Bump pulldown-cmark from 0.13.3 to 0.13.4 (#3840) + - (deps) Bump itertools from 0.14.0 to 0.15.0 (#3838) + - Adopt enum_dispatch for enum trait delegation (#3806) + Testing + - Adopt rstest across the workspace test suite (#3785) + Daemon + - Replace nucleo with frizbee, rank by match quality with frecency tiebreak (#3782) + atuin 18.19.0 + Install atuin 18.19.0 + Install prebuilt binaries via shell script + curl --proto '=https' --tlsv1.2 -LsSf https://github.com/atuinsh/atuin/releases/download/v18.19.0/atuin-installer.sh | sh + Install prebuilt binaries via powershell script + powershell -ExecutionPolicy Bypass -c "irm https://github.com/atuinsh/atuin/releases/download/v18.19.0/atuin-installer.ps1 | iex" + Download atuin 18.19.0 + ────────────────────────────────────────────┬───────────────────┬───────────── + File │Platform │Checksum + ────────────────────────────────────────────┼───────────────────┼───────────── + atuin-aarch64-apple-darwin.tar.gz │Apple Silicon macOS│checksum + ────────────────────────────────────────────┼───────────────────┼───────────── + atuin-x86_64-apple-darwin.tar.gz │Intel macOS │checksum + ────────────────────────────────────────────┼───────────────────┼───────────── + atuin-x86_64-pc-windows-msvc.zip │x64 Windows │checksum + ────────────────────────────────────────────┼───────────────────┼───────────── + atuin-aarch64-unknown-linux-gnu.tar.gz │ARM64 Linux │checksum + ────────────────────────────────────────────┼───────────────────┼───────────── + atuin-x86_64-unknown-linux-gnu.tar.gz │x64 Linux │checksum + ────────────────────────────────────────────┼───────────────────┼───────────── + atuin-aarch64-unknown-linux-musl.tar.gz │ARM64 MUSL Linux │checksum + ────────────────────────────────────────────┼───────────────────┼───────────── + atuin-x86_64-unknown-linux-musl.tar.gz │x64 MUSL Linux │checksum + ────────────────────────────────────────────┴───────────────────┴───────────── + Verifying GitHub Artifact Attestations + The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI: + gh attestation verify --repo atuinsh/atuin + You can also download the attestation from GitHub and verify against that directly: + gh attestation verify --bundle + atuin-server 18.19.0 + Install atuin-server 18.19.0 + Install prebuilt binaries via shell script + curl --proto '=https' --tlsv1.2 -LsSf https://github.com/atuinsh/atuin/releases/download/v18.19.0/atuin-server-installer.sh | sh + Install prebuilt binaries via powershell script + powershell -ExecutionPolicy Bypass -c "irm https://github.com/atuinsh/atuin/releases/download/v18.19.0/atuin-server-installer.ps1 | iex" + Download atuin-server 18.19.0 + ───────────────────────────────────────────────────┬───────────────────┬───────────── + File │Platform │Checksum + ───────────────────────────────────────────────────┼───────────────────┼───────────── + atuin-server-aarch64-apple-darwin.tar.gz │Apple Silicon macOS│checksum + ───────────────────────────────────────────────────┼───────────────────┼───────────── + atuin-server-x86_64-apple-darwin.tar.gz │Intel macOS │checksum + ───────────────────────────────────────────────────┼───────────────────┼───────────── + atuin-server-x86_64-pc-windows-msvc.zip │x64 Windows │checksum + ───────────────────────────────────────────────────┼───────────────────┼───────────── + atuin-server-aarch64-unknown-linux-gnu.tar.gz │ARM64 Linux │checksum + ───────────────────────────────────────────────────┼───────────────────┼───────────── + atuin-server-x86_64-unknown-linux-gnu.tar.gz │x64 Linux │checksum + ───────────────────────────────────────────────────┼───────────────────┼───────────── + atuin-server-aarch64-unknown-linux-musl.tar.gz │ARM64 MUSL Linux │checksum + ───────────────────────────────────────────────────┼───────────────────┼───────────── + atuin-server-x86_64-unknown-linux-musl.tar.gz │x64 MUSL Linux │checksum + ───────────────────────────────────────────────────┴───────────────────┴───────────── + Verifying GitHub Artifact Attestations + The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI: + gh attestation verify --repo atuinsh/atuin + You can also download the attestation from GitHub and verify against that directly: + gh attestation verify --bundle +ReleaseNotesUrl: https://github.com/atuinsh/atuin/releases/tag/v18.19.0 +ManifestType: defaultLocale +ManifestVersion: 1.12.0 diff --git a/manifests/a/Atuinsh/Atuin/18.19.0/Atuinsh.Atuin.yaml b/manifests/a/Atuinsh/Atuin/18.19.0/Atuinsh.Atuin.yaml new file mode 100644 index 0000000000000..e6f623f50a3b0 --- /dev/null +++ b/manifests/a/Atuinsh/Atuin/18.19.0/Atuinsh.Atuin.yaml @@ -0,0 +1,8 @@ +# Created with komac v2.16.0 +# yaml-language-server: $schema=https://aka.ms/winget-manifest.version.1.12.0.schema.json + +PackageIdentifier: Atuinsh.Atuin +PackageVersion: 18.19.0 +DefaultLocale: en-US +ManifestType: version +ManifestVersion: 1.12.0 diff --git a/manifests/a/AurelioAvila/PCTweaker/0.1.0/AurelioAvila.PCTweaker.installer.yaml b/manifests/a/AurelioAvila/PCTweaker/0.1.0/AurelioAvila.PCTweaker.installer.yaml new file mode 100644 index 0000000000000..12a1131619bed --- /dev/null +++ b/manifests/a/AurelioAvila/PCTweaker/0.1.0/AurelioAvila.PCTweaker.installer.yaml @@ -0,0 +1,18 @@ +# Created using wingetcreate 1.12.8.0 +# yaml-language-server: $schema=https://aka.ms/winget-manifest.installer.1.6.0.schema.json + +PackageIdentifier: AurelioAvila.PCTweaker +PackageVersion: 0.1.0 +InstallModes: +- interactive +- silent +UpgradeBehavior: install +Installers: +- Architecture: x64 + InstallerType: nullsoft + InstallerUrl: https://github.com/AurelioAvila/pc-tweaker-app/releases/download/v0.1.0/pc-tweaker-app_0.1.0_x64-setup.exe + InstallerSha256: 6927613B770FCC93ED06716016A5288F3F71ED2106634F2D2B31EADB45684647 + InstallerSwitches: + Silent: /S +ManifestType: installer +ManifestVersion: 1.6.0 diff --git a/manifests/a/AurelioAvila/PCTweaker/0.1.0/AurelioAvila.PCTweaker.locale.en-US.yaml b/manifests/a/AurelioAvila/PCTweaker/0.1.0/AurelioAvila.PCTweaker.locale.en-US.yaml new file mode 100644 index 0000000000000..67e3d39f1bf5e --- /dev/null +++ b/manifests/a/AurelioAvila/PCTweaker/0.1.0/AurelioAvila.PCTweaker.locale.en-US.yaml @@ -0,0 +1,23 @@ +# Created using wingetcreate 1.12.8.0 +# yaml-language-server: $schema=https://aka.ms/winget-manifest.defaultLocale.1.6.0.schema.json + +PackageIdentifier: AurelioAvila.PCTweaker +PackageVersion: 0.1.0 +PackageLocale: en-US +Publisher: Aurelio Avila +PublisherUrl: https://github.com/AurelioAvila +PublisherSupportUrl: https://github.com/AurelioAvila/pc-tweaker-app/issues +PackageName: PC Tweaker +PackageUrl: https://github.com/AurelioAvila/pc-tweaker-app +License: Proprietary +ShortDescription: Desktop app for Windows that applies performance, privacy, gaming and maintenance tweaks with automatic one-click rollback. +Description: PC Tweaker applies real Windows system tweaks (registry, power plan, network DNS, temp file cleanup) across Performance, Privacy, Gaming and Maintenance categories. Every change saves a snapshot of the previous value before it's applied, so any tweak can be reverted with one click. +Tags: +- windows +- performance +- tweak +- optimizer +- gaming +- privacy +ManifestType: defaultLocale +ManifestVersion: 1.6.0 diff --git a/manifests/a/AurelioAvila/PCTweaker/0.1.0/AurelioAvila.PCTweaker.yaml b/manifests/a/AurelioAvila/PCTweaker/0.1.0/AurelioAvila.PCTweaker.yaml new file mode 100644 index 0000000000000..5d50149feb060 --- /dev/null +++ b/manifests/a/AurelioAvila/PCTweaker/0.1.0/AurelioAvila.PCTweaker.yaml @@ -0,0 +1,8 @@ +# Created using wingetcreate 1.12.8.0 +# yaml-language-server: $schema=https://aka.ms/winget-manifest.version.1.6.0.schema.json + +PackageIdentifier: AurelioAvila.PCTweaker +PackageVersion: 0.1.0 +DefaultLocale: en-US +ManifestType: version +ManifestVersion: 1.6.0 diff --git a/manifests/a/Axonara/Searchmonkey/0.3.3/Axonara.Searchmonkey.installer.yaml b/manifests/a/Axonara/Searchmonkey/0.3.3/Axonara.Searchmonkey.installer.yaml new file mode 100644 index 0000000000000..ecbc71e5d9477 --- /dev/null +++ b/manifests/a/Axonara/Searchmonkey/0.3.3/Axonara.Searchmonkey.installer.yaml @@ -0,0 +1,14 @@ +# yaml-language-server: $schema=https://aka.ms/winget-manifest.installer.1.12.0.schema.json + +PackageIdentifier: Axonara.Searchmonkey +PackageVersion: 0.3.3 +InstallerType: nullsoft +Scope: user +UpgradeBehavior: install +ProductCode: Searchmonkey +Installers: + - Architecture: x64 + InstallerUrl: https://github.com/cottrela/searchmonkey-III/releases/download/v0.3.3/Searchmonkey_0.3.3_x64-setup.exe + InstallerSha256: f85972b6092500ce923050f343b611a8bcc6d992ca174b41ee28652df22f162e +ManifestType: installer +ManifestVersion: 1.12.0 diff --git a/manifests/a/Axonara/Searchmonkey/0.3.3/Axonara.Searchmonkey.locale.en-US.yaml b/manifests/a/Axonara/Searchmonkey/0.3.3/Axonara.Searchmonkey.locale.en-US.yaml new file mode 100644 index 0000000000000..f124377d9a1c1 --- /dev/null +++ b/manifests/a/Axonara/Searchmonkey/0.3.3/Axonara.Searchmonkey.locale.en-US.yaml @@ -0,0 +1,23 @@ +# yaml-language-server: $schema=https://aka.ms/winget-manifest.defaultLocale.1.12.0.schema.json + +PackageIdentifier: Axonara.Searchmonkey +PackageVersion: 0.3.3 +PackageLocale: en-US +Publisher: Axonara +PublisherUrl: https://searchmonkey.dev +PublisherSupportUrl: https://github.com/cottrela/searchmonkey-III/issues +PackageName: Searchmonkey III +PackageUrl: https://searchmonkey.dev +License: MIT +LicenseUrl: https://github.com/cottrela/searchmonkey-III/blob/main/LICENSE +ShortDescription: Real-time desktop file search with regex support and no indexing. +Description: Searchmonkey III is a modern desktop search tool for finding text in your files instantly. It searches directly on disk with no indexing, no background services, and no stale results. +Tags: + - search + - file-search + - ripgrep + - regex + - no-index + - desktop +ManifestType: defaultLocale +ManifestVersion: 1.12.0 diff --git a/manifests/a/Axonara/Searchmonkey/0.3.3/Axonara.Searchmonkey.yaml b/manifests/a/Axonara/Searchmonkey/0.3.3/Axonara.Searchmonkey.yaml new file mode 100644 index 0000000000000..7a29e14aaf00b --- /dev/null +++ b/manifests/a/Axonara/Searchmonkey/0.3.3/Axonara.Searchmonkey.yaml @@ -0,0 +1,7 @@ +# yaml-language-server: $schema=https://aka.ms/winget-manifest.version.1.12.0.schema.json + +PackageIdentifier: Axonara.Searchmonkey +PackageVersion: 0.3.3 +DefaultLocale: en-US +ManifestType: version +ManifestVersion: 1.12.0 diff --git a/manifests/a/aelassas/Servy/9.0/aelassas.Servy.installer.yaml b/manifests/a/aelassas/Servy/9.0/aelassas.Servy.installer.yaml new file mode 100644 index 0000000000000..7ce22dbad4444 --- /dev/null +++ b/manifests/a/aelassas/Servy/9.0/aelassas.Servy.installer.yaml @@ -0,0 +1,32 @@ +# Created with WinGet Releaser using komac v2.16.0 +# yaml-language-server: $schema=https://aka.ms/winget-manifest.installer.1.12.0.schema.json + +PackageIdentifier: aelassas.Servy +PackageVersion: '9.0' +InstallerLocale: en-US +InstallerType: inno +Scope: machine +InstallModes: +- interactive +- silent +- silentWithProgress +UpgradeBehavior: install +ReleaseDate: 2026-08-04 +ElevationRequirement: elevatesSelf +InstallationMetadata: + DefaultInstallLocation: '%ProgramFiles%\Servy' +Installers: +- Architecture: x64 + InstallerUrl: https://github.com/aelassas/servy/releases/download/v9.0/servy-9.0-x64-installer.exe + InstallerSha256: 2618CFB276F6A1764CA173ADA7F63C61F35914241642A31AFE10D6D4530530CA + ProductCode: '{8343B121-BE1C-463F-AA5B-FD237DD2F8D0}_is1' + AppsAndFeaturesEntries: + - ProductCode: '{8343B121-BE1C-463F-AA5B-FD237DD2F8D0}_is1' +- Architecture: arm64 + InstallerUrl: https://github.com/aelassas/servy/releases/download/v9.0/servy-9.0-arm64-installer.exe + InstallerSha256: B3AADF4EFA2C6F36CFC0918E62D2F804A370BA7787C143303782603AF2270A8C + ProductCode: '{8343B121-BE1C-463F-AA5B-FD237DD2F8D1}_is1' + AppsAndFeaturesEntries: + - ProductCode: '{8343B121-BE1C-463F-AA5B-FD237DD2F8D1}_is1' +ManifestType: installer +ManifestVersion: 1.12.0 diff --git a/manifests/a/aelassas/Servy/9.0/aelassas.Servy.locale.en-US.yaml b/manifests/a/aelassas/Servy/9.0/aelassas.Servy.locale.en-US.yaml new file mode 100644 index 0000000000000..acd9cc00ddc2e --- /dev/null +++ b/manifests/a/aelassas/Servy/9.0/aelassas.Servy.locale.en-US.yaml @@ -0,0 +1,98 @@ +# Created with WinGet Releaser using komac v2.16.0 +# yaml-language-server: $schema=https://aka.ms/winget-manifest.defaultLocale.1.12.0.schema.json + +PackageIdentifier: aelassas.Servy +PackageVersion: '9.0' +PackageLocale: en-US +Publisher: Akram El Assas +PublisherUrl: https://github.com/aelassas +PublisherSupportUrl: https://github.com/aelassas/servy/issues +Author: Akram El Assas +PackageName: Servy +PackageUrl: https://servy-win.github.io/ +License: MIT +LicenseUrl: https://github.com/aelassas/servy/blob/HEAD/LICENSE.txt +Copyright: Copyright (c) 2026 Akram El Assas +ShortDescription: Servy lets you run any app as a native Windows service with full control over the working directory, startup type, process priority, CPU affinity, logging, health checks, hooks, and parameters. +Description: |- + Servy lets you run any app as a native Windows service with full control over the working directory, startup type, process priority, CPU affinity, logging, health checks, environment variables, dependencies, pre-launch and post-launch hooks, pre-stop and post-stop hooks, and parameters. + + Servy is digitally signed using a trusted code-signing certificate provided by the SignPath Foundation. This ensures that all Servy binaries and installers are verified and secure, prevents SmartScreen warnings, and guarantees that the software has not been tampered with. + + Servy offers a desktop app, a CLI, and a PowerShell module that let you create, configure, and manage Windows services interactively or through scripts and CI/CD pipelines. It also includes a Manager app for easily monitoring and managing all installed services in real time. + + Features: + - Clean, simple UI + - Monitor and manage all installed services with Servy Manager + - Real-time CPU and RAM monitoring with live performance graphs for installed services + - Real-time service stdout and stderr output preview in Servy Console + - Service dependency tree visualization with status indicators + - CLI and PowerShell module for full scripting and automated deployments + - Run any executable as a Windows service + - Set service name, description, startup type, priority, CPU affinity, working directory, environment variables, and dependencies + - Environment variable expansion supported in parameters, process paths, and startup directories + - Run services as Local System, local or domain accounts, Active Directory accounts, or gMSAs + - Redirect stdout/stderr to log files with automatic size-based and date-based rotations + - Run pre-launch hooks before starting the service, with retries, timeout, logging and failure handling + - Run post-launch hooks after the application starts successfully + - Run pre-stop and post-stop hooks before the application stops and after the application stops + - Supports Ctrl+C for command-line apps, close-window for GUI apps, and force kill if unresponsive + - Supports Ctrl+C propagation to descendant processes of the wrapped process + - Prevent orphaned/zombie processes with improved lifecycle management while ensuring resource cleanup + - Health checks and automatic service recovery + - Browse and search logs by level, date, and keyword for faster troubleshooting from Servy Manager + - Export/Import service configurations for easy backups and automation + - Service Event Notification alerts on service failures via Windows notifications and email + - Compatible with Windows 7 SP1 through 11 (x64/ARM64) and Windows Server editions + + Who is it for? + - Developers: Run development servers, scripts, or custom tools as services without extra setup. + - Sysadmins & IT professionals: Ensure critical background processes stay alive, monitored, and properly logged. + - Teams or organizations: Automate background services reliably across multiple machines. +Moniker: servy +Tags: +- admin +- automation +- background-service +- cli +- devops +- dotnet +- nssm +- powershell +- scm +- service-manager +- service-supervisor +- service-wrapper +- watchdog +- windows-service +- windows-tools +- winsw +ReleaseNotes: |- + - fix(core): ServiceValidationRules.cs - the shared validator hardcodes the 12 [ServicePath] fields that the CLI-import and service-startup validators reflect over, so a new path property is silently unvalidated for the Manager and desktop app (#4401) + - fix(core): AppFoldersHelperTests.cs / AppFoldersHelper.cs - EnsureFolders_ValidPaths looks temp-dir scoped but EnsureFolders unconditionally re-ACLs the real C:\ProgramData\Servy vault plus its recovery and logs folders (#4491) + - fix(core): InstallServiceOptions.cs (Core) - HeartbeatUrl and its two companions omit the 'Only used when EnableHealthMonitoring is true' caveat their five siblings carry, and the gate silently drops every ping (#4498) + - fix(core): NativeMethodsHelpers.cs / NativeMethodsHelpersTests.cs - AtomicSecureMove guards with IsNullOrWhiteSpace but its message says 'null or empty' and neither theory has a whitespace row; ValidateCredentials in the same file does all three correctly (#4506) + - fix(core): ServiceDependenciesValidator.cs - Validate emits one error per duplicate occurrence while Parse de-duplicates the same token stream (#4513) + - fix(core): SecurityHelper.cs - the breakInheritance:true non-admin fallback cannot fall back: both downstream catch filters require !breakInheritance (#4556) + - fix(core): EventLogService.cs - a whitespace-only sourceName disables both provider filters and skips the allowlist (IsNullOrWhiteSpace at line 55 vs IsNullOrEmpty at line 130) (#4561) + - fix(core): IServiceManager.cs / ServiceManager.cs - GetDependencies checks cancellation before its argument guard, so the documented ArgumentException becomes an OperationCanceledException; its three sibling reads do the opposite (#4564) + - fix(core): SafeWinProcessHandle.cs - DangerousGetHandle hides the non-virtual base member with 'new', so the documented "IntPtr.Zero when closed" guarantee is bypassed through any base-typed reference (#4640) + - fix(manager): PerformanceViewModel.cs - AddPoint takes both the history queue and the MetricType that already selects it; a mismatched pair compiles and silently renders the wrong graph (#4374) + - fix(manager): MainViewModel.cs (Manager) - five minor items: ServiceCommands setter (null guard / notification / field placement), ServicesView private set, Refresh() naming, cursor reset on early returns, no disposed guard on CreateAndStartTimer (#4369) + - fix(manager): ServiceRowViewModel.cs - ConfigureCommand is the only one of the ten row commands built without the shared CanExecuteServiceCommand predicate (#4594) + - fix(cli): BaseCommand.cs - a failed service operation with a blank OperationResult.ErrorMessage logs nothing at all; the #3387 fix hardened only the user-facing path (residual) (#4701) + - ci(publish.yml): $env:SEVEN_ZIP assignment in the install step is a no-op; only the GITHUB_ENV export on the next line reaches the packaging step (#4664) + - ci(publish.yml): setup/servy.iss and setup/servy-arm64.iss are 575 of 582 lines identical; the 7 differing lines are all expressible with an Inno /DArch define, which both callers already use for /DMyAppVersion (#4688) + - ci(dependabot.yml): schedule.interval is inert while open-pull-requests-limit is 0, so the nuget/github-actions daily-vs-weekly split implies a cadence difference that does not exist (#4662) + - ci(scoop.yml): the Extras branch probe is wrapped in Invoke-Git, which exits on non-zero; 'rev-parse --verify --quiet' always exits 1 on a fresh clone, so run_extras_pr:true can never succeed (#4667) + - ci(changelog.yml): 'git add' runs before the porcelain check, so the following 'git diff --staged' else branch is unreachable; choco.yml and bump-version.yml order the same two guards the other way (#4659) + - ci(wiki.yml): the 'workspace files are present' guard uses 'ls -A .', which always lists .git after actions/checkout, so the empty/inaccessible branch is unreachable (#4678) + - ci(security.yml): the concurrency group falls back to github.sha for push/schedule/dispatch, making it unique per run and inert; all five sibling workflows key on github.ref (residual of #1098) (#4673) + - ci(download-with-retry/action.yml): output_path is run through ExpandString, which evaluates $(...) subexpressions as code; no caller uses the environment-variable expansion it was added for (#4657) + - fix: various robustness, security, inconsistency, and code quality issues (check GitHub Issues for more details) +ReleaseNotesUrl: https://github.com/aelassas/servy/releases/tag/v9.0 +Documentations: +- DocumentLabel: Wiki + DocumentUrl: https://github.com/aelassas/servy/wiki +ManifestType: defaultLocale +ManifestVersion: 1.12.0 diff --git a/manifests/a/aelassas/Servy/9.0/aelassas.Servy.yaml b/manifests/a/aelassas/Servy/9.0/aelassas.Servy.yaml new file mode 100644 index 0000000000000..19274c5f9c84a --- /dev/null +++ b/manifests/a/aelassas/Servy/9.0/aelassas.Servy.yaml @@ -0,0 +1,8 @@ +# Created with WinGet Releaser using komac v2.16.0 +# yaml-language-server: $schema=https://aka.ms/winget-manifest.version.1.12.0.schema.json + +PackageIdentifier: aelassas.Servy +PackageVersion: '9.0' +DefaultLocale: en-US +ManifestType: version +ManifestVersion: 1.12.0 diff --git a/manifests/a/aroum/che/0.1.1/aroum.che.installer.yaml b/manifests/a/aroum/che/0.1.1/aroum.che.installer.yaml new file mode 100644 index 0000000000000..4f370f456c86b --- /dev/null +++ b/manifests/a/aroum/che/0.1.1/aroum.che.installer.yaml @@ -0,0 +1,18 @@ +# Created using wingetcreate 1.12.8.0 +# yaml-language-server: $schema=https://aka.ms/winget-manifest.installer.1.12.0.schema.json + +PackageIdentifier: aroum.che +PackageVersion: 0.1.1 +InstallerType: zip +NestedInstallerType: portable +NestedInstallerFiles: +- RelativeFilePath: che-v0.1.1-x86_64-pc-windows-msvc\ch.exe + PortableCommandAlias: ch +- RelativeFilePath: che-v0.1.1-x86_64-pc-windows-msvc\che.exe + PortableCommandAlias: che +Installers: +- Architecture: x64 + InstallerUrl: https://github.com/aroum/che/releases/download/v0.1.1/che-v0.1.1-x86_64-pc-windows-msvc.zip + InstallerSha256: C82F26A6B56ED635A0E1BFDF6E96906FE34183173AD7DCAA43B0F79107BFED31 +ManifestType: installer +ManifestVersion: 1.12.0 diff --git a/manifests/a/aroum/che/0.1.1/aroum.che.locale.en-US.yaml b/manifests/a/aroum/che/0.1.1/aroum.che.locale.en-US.yaml new file mode 100644 index 0000000000000..b199b19596500 --- /dev/null +++ b/manifests/a/aroum/che/0.1.1/aroum.che.locale.en-US.yaml @@ -0,0 +1,12 @@ +# Created using wingetcreate 1.12.8.0 +# yaml-language-server: $schema=https://aka.ms/winget-manifest.defaultLocale.1.12.0.schema.json + +PackageIdentifier: aroum.che +PackageVersion: 0.1.1 +PackageLocale: en-US +Publisher: aroum +PackageName: che +License: MIT License +ShortDescription: Blazing fast terminal file manager written in Rust, based on async I/O with true dual panel mode +ManifestType: defaultLocale +ManifestVersion: 1.12.0 diff --git a/manifests/a/aroum/che/0.1.1/aroum.che.yaml b/manifests/a/aroum/che/0.1.1/aroum.che.yaml new file mode 100644 index 0000000000000..d20c261b66492 --- /dev/null +++ b/manifests/a/aroum/che/0.1.1/aroum.che.yaml @@ -0,0 +1,8 @@ +# Created using wingetcreate 1.12.8.0 +# yaml-language-server: $schema=https://aka.ms/winget-manifest.version.1.12.0.schema.json + +PackageIdentifier: aroum.che +PackageVersion: 0.1.1 +DefaultLocale: en-US +ManifestType: version +ManifestVersion: 1.12.0 diff --git a/manifests/a/astral-sh/uv/0.12.0/astral-sh.uv.installer.yaml b/manifests/a/astral-sh/uv/0.12.0/astral-sh.uv.installer.yaml new file mode 100644 index 0000000000000..d6e3f7fe05128 --- /dev/null +++ b/manifests/a/astral-sh/uv/0.12.0/astral-sh.uv.installer.yaml @@ -0,0 +1,40 @@ +# Created with YamlCreate.ps1 Dumplings Mod +# yaml-language-server: $schema=https://aka.ms/winget-manifest.installer.1.12.0.schema.json + +PackageIdentifier: astral-sh.uv +PackageVersion: 0.12.0 +InstallerType: zip +NestedInstallerType: portable +NestedInstallerFiles: +- RelativeFilePath: uvx.exe + PortableCommandAlias: uvx +- RelativeFilePath: uv.exe + PortableCommandAlias: uv +- RelativeFilePath: uvw.exe + PortableCommandAlias: uvw +Commands: +- uv +- uvw +- uvx +ReleaseDate: 2026-07-28 +Installers: +- Architecture: x86 + InstallerUrl: https://github.com/astral-sh/uv/releases/download/0.12.0/uv-i686-pc-windows-msvc.zip + InstallerSha256: 4B7F9319EEB79A8E6204952742AC5EF6A56A096DC9438F416BFA60A374D6E94D + Dependencies: + PackageDependencies: + - PackageIdentifier: Microsoft.VCRedist.2015+.x86 +- Architecture: x64 + InstallerUrl: https://github.com/astral-sh/uv/releases/download/0.12.0/uv-x86_64-pc-windows-msvc.zip + InstallerSha256: 68200E25DE594DF92387186BBFB9D9DF606EC1D87EFAA0AE0C7F690970E53DB6 + Dependencies: + PackageDependencies: + - PackageIdentifier: Microsoft.VCRedist.2015+.x64 +- Architecture: arm64 + InstallerUrl: https://github.com/astral-sh/uv/releases/download/0.12.0/uv-aarch64-pc-windows-msvc.zip + InstallerSha256: 60C12DC34A8FF0269D7744A3A94506FA8F140618A82194B7BF7834FA789A765B + Dependencies: + PackageDependencies: + - PackageIdentifier: Microsoft.VCRedist.2015+.arm64 +ManifestType: installer +ManifestVersion: 1.12.0 diff --git a/manifests/a/astral-sh/uv/0.12.0/astral-sh.uv.locale.en-US.yaml b/manifests/a/astral-sh/uv/0.12.0/astral-sh.uv.locale.en-US.yaml new file mode 100644 index 0000000000000..f230ca4ea1baa --- /dev/null +++ b/manifests/a/astral-sh/uv/0.12.0/astral-sh.uv.locale.en-US.yaml @@ -0,0 +1,26 @@ +# Created with YamlCreate.ps1 Dumplings Mod +# yaml-language-server: $schema=https://aka.ms/winget-manifest.defaultLocale.1.12.0.schema.json + +PackageIdentifier: astral-sh.uv +PackageVersion: 0.12.0 +PackageLocale: en-US +Publisher: Astral Software Inc. +PublisherUrl: https://astral.sh/ +PublisherSupportUrl: https://github.com/astral-sh/uv/issues +Author: Astral Software Inc. +PackageName: uv +PackageUrl: https://github.com/astral-sh/uv +License: Apache-2.0 or MIT +LicenseUrl: https://github.com/astral-sh/uv/blob/HEAD/README.md#license +Copyright: Copyright (c) 2026 Astral Software Inc. +ShortDescription: An extremely fast Python package and project manager, written in Rust. +Description: An extremely fast Python package and project manager, written in Rust. Designed as a single tool to replace pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv workflows, and more. +Moniker: uv +Tags: +- python +ReleaseNotesUrl: https://github.com/astral-sh/uv/releases/tag/0.12.0 +Documentations: +- DocumentLabel: Docs + DocumentUrl: https://docs.astral.sh/uv/ +ManifestType: defaultLocale +ManifestVersion: 1.12.0 diff --git a/manifests/a/astral-sh/uv/0.12.0/astral-sh.uv.locale.zh-CN.yaml b/manifests/a/astral-sh/uv/0.12.0/astral-sh.uv.locale.zh-CN.yaml new file mode 100644 index 0000000000000..1b63ccbf0c941 --- /dev/null +++ b/manifests/a/astral-sh/uv/0.12.0/astral-sh.uv.locale.zh-CN.yaml @@ -0,0 +1,15 @@ +# Created with YamlCreate.ps1 Dumplings Mod +# yaml-language-server: $schema=https://aka.ms/winget-manifest.locale.1.12.0.schema.json + +PackageIdentifier: astral-sh.uv +PackageVersion: 0.12.0 +PackageLocale: zh-CN +License: Apache-2.0 或 MIT +ShortDescription: 用 Rust 编写的极速 Python 软件包和项目管理器 +Description: 用 Rust 编写的极速 Python 软件包和项目管理器。可作为单一工具替代 pip、pip-tools、pipx、poles、pyenv、twine、virtualenv 工作流等。 +ReleaseNotesUrl: https://github.com/astral-sh/uv/releases/tag/0.12.0 +Documentations: +- DocumentLabel: 文档 + DocumentUrl: https://docs.astral.sh/uv/ +ManifestType: locale +ManifestVersion: 1.12.0 diff --git a/manifests/a/astral-sh/uv/0.12.0/astral-sh.uv.yaml b/manifests/a/astral-sh/uv/0.12.0/astral-sh.uv.yaml new file mode 100644 index 0000000000000..0fb1c46b4fcfd --- /dev/null +++ b/manifests/a/astral-sh/uv/0.12.0/astral-sh.uv.yaml @@ -0,0 +1,8 @@ +# Created with YamlCreate.ps1 Dumplings Mod +# yaml-language-server: $schema=https://aka.ms/winget-manifest.version.1.12.0.schema.json + +PackageIdentifier: astral-sh.uv +PackageVersion: 0.12.0 +DefaultLocale: en-US +ManifestType: version +ManifestVersion: 1.12.0 diff --git a/manifests/b/Baidu/Comate/3.4.0/Baidu.Comate.installer.yaml b/manifests/b/Baidu/Comate/3.4.0/Baidu.Comate.installer.yaml new file mode 100644 index 0000000000000..dd130fb8b1c31 --- /dev/null +++ b/manifests/b/Baidu/Comate/3.4.0/Baidu.Comate.installer.yaml @@ -0,0 +1,154 @@ +# Created with YamlCreate.ps1 Dumplings Mod +# yaml-language-server: $schema=https://aka.ms/winget-manifest.installer.1.12.0.schema.json + +PackageIdentifier: Baidu.Comate +PackageVersion: 3.4.0 +InstallerType: inno +Scope: user +InstallerSwitches: + Custom: /mergetasks=!runcode +UpgradeBehavior: install +Protocols: +- comate +FileExtensions: +- ascx +- asp +- aspx +- bash +- bash_login +- bash_logout +- bash_profile +- bashrc +- bib +- bowerrc +- c +- c++ +- cc +- cfg +- cjs +- clj +- cljs +- cljx +- clojure +- cls +- cmake +- code-workspace +- coffee +- config +- containerfile +- cpp +- cs +- cshtml +- csproj +- css +- csv +- csx +- ctp +- cxx +- dart +- diff +- dockerfile +- dot +- dtd +- editorconfig +- edn +- erb +- eyaml +- eyml +- fs +- fsi +- fsscript +- fsx +- gemspec +- gitattributes +- gitconfig +- gitignore +- go +- gradle +- groovy +- h +- h++ +- handlebars +- hbs +- hh +- hpp +- hxx +- ipynb +- jade +- jav +- java +- js +- jscsrc +- jshintrc +- jshtm +- json +- jsp +- jsx +- less +- lua +- m +- makefile +- markdown +- md +- mdoc +- mdown +- mdtext +- mdtxt +- mdwn +- mjs +- mk +- mkd +- mkdn +- ml +- mli +- npmignore +- php +- phtml +- pl +- pl6 +- plist +- pm +- pm6 +- pod +- pp +- profile +- properties +- psgi +- py +- pyi +- r +- rb +- rhistory +- rprofile +- rs +- rst +- rt +- sass +- scss +- sh +- shtml +- sql +- t +- tex +- toml +- ts +- tsx +- vb +- vue +- wxi +- wxl +- wxs +- xaml +- xhtml +- xml +- yaml +- yml +- zsh +ProductCode: '{E1BCCBB0-0C31-40C1-AB8D-2AE2E6C3C2F2}}_is1' +ReleaseDate: 2026-08-04 +Installers: +- Architecture: x64 + InstallerUrl: https://comate-ide.cdn.bcebos.com/download/stable/94f196d264af20c1d0155cf280d438f75744401c-264408334/Comate-win32-x64-user-setup.exe + InstallerSha256: 3B451C8EE4E22B45689244E1B9D8FBB3FE63C2A2143877A083A618B38A51F281 +ManifestType: installer +ManifestVersion: 1.12.0 diff --git a/manifests/b/Baidu/Comate/3.4.0/Baidu.Comate.locale.en-US.yaml b/manifests/b/Baidu/Comate/3.4.0/Baidu.Comate.locale.en-US.yaml new file mode 100644 index 0000000000000..0b45520914707 --- /dev/null +++ b/manifests/b/Baidu/Comate/3.4.0/Baidu.Comate.locale.en-US.yaml @@ -0,0 +1,19 @@ +# Created with YamlCreate.ps1 Dumplings Mod +# yaml-language-server: $schema=https://aka.ms/winget-manifest.locale.1.12.0.schema.json + +PackageIdentifier: Baidu.Comate +PackageVersion: 3.4.0 +PackageLocale: en-US +PublisherUrl: https://comate.baidu.com/en +License: Proprietary +ShortDescription: Intelligent coding capabilities throughout the entire development process along with enhanced multimodal abilities. Install now to start a seamless and natural intelligent development experience. +PurchaseUrl: https://comate.baidu.com/en/pricing +Documentations: +- DocumentLabel: Manual + DocumentUrl: https://cloud.baidu.com/doc/COMATE/s/9lnvs245z +- DocumentLabel: Tutorials + DocumentUrl: https://comate.baidu.com/zh/curriculums/1 +- DocumentLabel: FAQ + DocumentUrl: https://cloud.baidu.com/doc/COMATE/s/Dlnvqzquu +ManifestType: locale +ManifestVersion: 1.12.0 diff --git a/manifests/b/Baidu/Comate/3.4.0/Baidu.Comate.locale.zh-CN.yaml b/manifests/b/Baidu/Comate/3.4.0/Baidu.Comate.locale.zh-CN.yaml new file mode 100644 index 0000000000000..8764ab24cd1c9 --- /dev/null +++ b/manifests/b/Baidu/Comate/3.4.0/Baidu.Comate.locale.zh-CN.yaml @@ -0,0 +1,34 @@ +# Created with YamlCreate.ps1 Dumplings Mod +# yaml-language-server: $schema=https://aka.ms/winget-manifest.defaultLocale.1.12.0.schema.json + +PackageIdentifier: Baidu.Comate +PackageVersion: 3.4.0 +PackageLocale: zh-CN +Publisher: Microsoft Corporation +PublisherUrl: https://comate.baidu.com/ +PublisherSupportUrl: https://developer.baidu.com/singleTagPage.html?tagId=326 +PrivacyUrl: https://cloud.baidu.com/doc/COMATE/s/2lxiygl2z +Author: 北京百度网讯科技有限公司 +PackageName: Comate +PackageUrl: https://comate.baidu.com/download +License: 专有软件 +LicenseUrl: https://cloud.baidu.com/doc/COMATE/s/glxiygwdx +Copyright: © 2026 Baidu +CopyrightUrl: https://cloud.baidu.com/doc/COMATE/s/glxiygwdx +ShortDescription: 智能编码能力深度融入开发全流程,多模态能力全面增强,一键安装、畅享自然流畅的智能开发体验。 +Tags: +- 代码 +- 开发 +- 编程 +- 编辑 +- 编辑器 +PurchaseUrl: https://comate.baidu.com/pricing +Documentations: +- DocumentLabel: 使用手册 + DocumentUrl: https://cloud.baidu.com/doc/COMATE/s/9lnvs245z +- DocumentLabel: 教学课程 + DocumentUrl: https://comate.baidu.com/zh/curriculums/1 +- DocumentLabel: 常见问题 + DocumentUrl: https://cloud.baidu.com/doc/COMATE/s/Dlnvqzquu +ManifestType: defaultLocale +ManifestVersion: 1.12.0 diff --git a/manifests/b/Baidu/Comate/3.4.0/Baidu.Comate.yaml b/manifests/b/Baidu/Comate/3.4.0/Baidu.Comate.yaml new file mode 100644 index 0000000000000..a1d618ff2abf7 --- /dev/null +++ b/manifests/b/Baidu/Comate/3.4.0/Baidu.Comate.yaml @@ -0,0 +1,8 @@ +# Created with YamlCreate.ps1 Dumplings Mod +# yaml-language-server: $schema=https://aka.ms/winget-manifest.version.1.12.0.schema.json + +PackageIdentifier: Baidu.Comate +PackageVersion: 3.4.0 +DefaultLocale: zh-CN +ManifestType: version +ManifestVersion: 1.12.0 diff --git a/manifests/b/BenHolmes/Hubble/md/0.1.21/BenHolmes.Hubble.md.installer.yaml b/manifests/b/BenHolmes/Hubble/md/0.1.21/BenHolmes.Hubble.md.installer.yaml new file mode 100644 index 0000000000000..725c1af6136a6 --- /dev/null +++ b/manifests/b/BenHolmes/Hubble/md/0.1.21/BenHolmes.Hubble.md.installer.yaml @@ -0,0 +1,16 @@ +# Created using wingetcreate 1.12.8.0 +# yaml-language-server: $schema=https://aka.ms/winget-manifest.installer.1.12.0.schema.json + +PackageIdentifier: BenHolmes.Hubble.md +PackageVersion: 0.1.21 +InstallerType: nullsoft +Installers: +- Architecture: x64 + InstallerUrl: https://github.com/bholmesdev/hubble.md/releases/download/desktop-v0.1.21/hubble_0.1.21_x64.exe + InstallerSha256: 2DAF5B3450B47295A1AAF6C0072DCDBE5BF481D6C47FE0B211563CF7C986050D +- Architecture: arm64 + InstallerUrl: https://github.com/bholmesdev/hubble.md/releases/download/desktop-v0.1.21/hubble_0.1.21_arm64.exe + InstallerSha256: 028536F6CFFABABE198F0EBE51A9C3C4BE58F6401780402130092B080B1DA2EB +ManifestType: installer +ManifestVersion: 1.12.0 +ReleaseDate: 2026-07-19 diff --git a/manifests/b/BenHolmes/Hubble/md/0.1.21/BenHolmes.Hubble.md.locale.en-US.yaml b/manifests/b/BenHolmes/Hubble/md/0.1.21/BenHolmes.Hubble.md.locale.en-US.yaml new file mode 100644 index 0000000000000..e30127a79eb73 --- /dev/null +++ b/manifests/b/BenHolmes/Hubble/md/0.1.21/BenHolmes.Hubble.md.locale.en-US.yaml @@ -0,0 +1,20 @@ +# Created using wingetcreate 1.12.8.0 +# yaml-language-server: $schema=https://aka.ms/winget-manifest.defaultLocale.1.12.0.schema.json + +PackageIdentifier: BenHolmes.Hubble.md +PackageVersion: 0.1.21 +PackageLocale: en-US +Publisher: Ben Holmes +PublisherUrl: https://github.com/bholmesdev +PublisherSupportUrl: https://github.com/bholmesdev/hubble.md/issues +PackageName: Hubble.md +PackageUrl: https://github.com/bholmesdev/hubble.md +License: MIT +Copyright: Copyright © 2026 Ben Holmes +ShortDescription: Desktop app for Hubble.md +Tags: +- markdown +- note-taking +ReleaseNotesUrl: https://github.com/bholmesdev/hubble.md/releases/tag/desktop-v0.1.21 +ManifestType: defaultLocale +ManifestVersion: 1.12.0 diff --git a/manifests/b/BenHolmes/Hubble/md/0.1.21/BenHolmes.Hubble.md.yaml b/manifests/b/BenHolmes/Hubble/md/0.1.21/BenHolmes.Hubble.md.yaml new file mode 100644 index 0000000000000..937817fc3bb67 --- /dev/null +++ b/manifests/b/BenHolmes/Hubble/md/0.1.21/BenHolmes.Hubble.md.yaml @@ -0,0 +1,8 @@ +# Created using wingetcreate 1.12.8.0 +# yaml-language-server: $schema=https://aka.ms/winget-manifest.version.1.12.0.schema.json + +PackageIdentifier: BenHolmes.Hubble.md +PackageVersion: 0.1.21 +DefaultLocale: en-US +ManifestType: version +ManifestVersion: 1.12.0 diff --git a/manifests/b/BiomeJS/Biome/2.5.7/BiomeJS.Biome.installer.yaml b/manifests/b/BiomeJS/Biome/2.5.7/BiomeJS.Biome.installer.yaml new file mode 100644 index 0000000000000..7764bfa4512c3 --- /dev/null +++ b/manifests/b/BiomeJS/Biome/2.5.7/BiomeJS.Biome.installer.yaml @@ -0,0 +1,25 @@ +# Created by Anthelion using komac v2.16.0 +# yaml-language-server: $schema=https://aka.ms/winget-manifest.installer.1.12.0.schema.json + +PackageIdentifier: BiomeJS.Biome +PackageVersion: 2.5.7 +InstallerType: portable +UpgradeBehavior: install +Commands: +- biome +ReleaseDate: 2026-08-04 +Installers: +- Architecture: x64 + InstallerUrl: https://github.com/biomejs/biome/releases/download/@biomejs/biome@2.5.7/biome-win32-x64.exe + InstallerSha256: 62ADEA0EA523F04CC5C074B2BB00E748B97252023AEDE03196E1BF4AACF80A9C + Dependencies: + PackageDependencies: + - PackageIdentifier: Microsoft.VCRedist.2015+.x64 +- Architecture: arm64 + InstallerUrl: https://github.com/biomejs/biome/releases/download/@biomejs/biome@2.5.7/biome-win32-arm64.exe + InstallerSha256: 655CC1F2ECF3719F79C9DEF7F2D824BB2A451FCD1D738D43468B12DD66620FD5 + Dependencies: + PackageDependencies: + - PackageIdentifier: Microsoft.VCRedist.2015+.arm64 +ManifestType: installer +ManifestVersion: 1.12.0 diff --git a/manifests/b/BiomeJS/Biome/2.5.7/BiomeJS.Biome.locale.en-US.yaml b/manifests/b/BiomeJS/Biome/2.5.7/BiomeJS.Biome.locale.en-US.yaml new file mode 100644 index 0000000000000..275903f9b09f0 --- /dev/null +++ b/manifests/b/BiomeJS/Biome/2.5.7/BiomeJS.Biome.locale.en-US.yaml @@ -0,0 +1,164 @@ +# Created by Anthelion using komac v2.16.0 +# yaml-language-server: $schema=https://aka.ms/winget-manifest.defaultLocale.1.12.0.schema.json + +PackageIdentifier: BiomeJS.Biome +PackageVersion: 2.5.7 +PackageLocale: en-US +Publisher: BiomeJS +PublisherUrl: https://biomejs.dev/ +PublisherSupportUrl: https://github.com/biomejs/biome/issues +Author: Biome Developers and Contributors +PackageName: Biome +PackageUrl: https://biomejs.dev/ +License: Apache-2.0 +Copyright: Copyright (c) 2023-present Biome Developers and Contributors +ShortDescription: Biome is a toolchain for web projects, aimed at providing functionalities to maintain them. It offers a formatter and linter, usable via CLI and LSP. +Moniker: biome +Tags: +- css +- formatter +- javascript +- json +- jsx +- linter +- static-code-analysis +- typescript +- web +ReleaseNotes: |- + 2.5.7 + + Patch Changes + - #10822 c171b3b Thanks @pkallos! - Added the option ignoreIfStatements to useNullishCoalescing. Biome now flags if statements that only assign to a nullish variable (such as if (!a) { a = b }) and can rewrite them to ??=. When enabled, Biome ignores those if statements. + - #11136 e63354c Thanks @AkashNaickar! - Added a new nursery rule noExtendNative, which reports extending the prototype of a built-in object. + - #10094 e007143 Thanks @THEjacob1000! - Added the nursery rule noTailwindArbitraryValue. Biome now reports Tailwind CSS arbitrary values such as w-[400px], including in HTML/JSX class attributes, configured utility functions, and tagged templates. + - #11184 135f476 Thanks @subotac! - Fixed #11176: noUnknownPseudoClass now recognizes Vue's :deep() pseudo-class inside .vue style blocks. + - #8239 a519f9d Thanks @cormacrelf! - Fixed #8233, where Biome CLI in + stdin mode didn't work correctly when handling files in projects with nested + configurations. For example, with the following structure, + --stdin-file-path=subdirectory/... would not use the nested configuration in + subdirectory/biome.json: + ├── biome.json + └── subdirectory + ├── biome.json + └── lib.js + biome format --write --stdin-file-path=subdirectory/lib.js < subdirectory/lib.js + Now, the nested configuration is correctly picked up and applied. + In addition, Biome now shows a warning if --stdin-file-path is provided but + that path is ignored and therefore not formatted or fixed. + - #11138 8c2c6bd Thanks @ematipico! - Fixed noUnnecessaryConditions: Biome now chooses the same function overload as TypeScript when an argument is a callback, so conditions that were previously missed are reported. + The following code is now invalid, because a parameter typed () => void accepts an async callback and schedule therefore returns string: + declare function schedule(handler: () => void): string; + declare function schedule(handler: () => Promise): string | undefined; + schedule(async () => {}) ?? "fallback"; + The following code is also now invalid, because map(() => 42) returns 42: + type Mapper = () => T; + declare function map(mapper: Mapper): T; + map(() => 42) || flag; + - #11138 8c2c6bd Thanks @ematipico! - Fixed #11087: noUnnecessaryConditions no longer reports optional chains and nullish coalescing whose receiver can be nullish. + For example, the optional chain and fallback in the following code are no longer reported: + declare const usage: { range: { startDate: string } } | null; + const startDate = usage?.range.startDate ?? "N/A"; + - #11118 9c16840 Thanks @subotac! - Fixed #11098: The HTML formatter now preserves the configured trailing newline when a file ends with a comment. + - + \ No newline at end of file + + + - #11201 0e80610 Thanks @Bishwas-py! - Fixed #11182: suppression comments for noPositiveTabindex now suppress the rule in HTML files when the attributes of the element span multiple lines. + - #11079 607afd2 Thanks @dyc3! - The HTML formatter now lays out the srcset attribute of and as the list of candidates it is. Runs of whitespace between candidates collapse, and once the list no longer fits on one line each candidate goes on its own line with the descriptors aligned: + - + + + - #11156 fed72c7 Thanks @saberoueslati! - Fixed #11129: noUnusedVariables no longer reports Vue bindings as unused when they are assigned through automatically unwrapped template refs. + - #11124 d890b39 Thanks @denbezrukov! - Fixed CSS formatting of line comments between a declaration colon and value to preserve their source indentation. + .test { + background: + - /////// foo + - // bar + + /////// foo + + // bar + radial-gradient(circle, #000, transparent); + } + - #11113 3d8ab73 Thanks @denbezrukov! - Fixed CSS formatting of long block comments between comma-separated property values: + .foo { + box-shadow: + - 1000px /* long long long long long long long long long long long long comment */ 1000px /* long long long long long long long long long comment */ 2px color(srgb 0.555555555 0.555555555 0.555555555), + + 1000px + + /* long long long long long long long long long long long long comment */ + + 1000px /* long long long long long long long long long comment */ 2px + + color(srgb 0.555555555 0.555555555 0.555555555), + 1px 1px black; + } + - #11127 da5c1a5 Thanks @dyc3! - The HTML formatter now picks the quote character for an attribute by counting the quotes in the value rather than looking only for a double quote. ' and " count as the characters they stand for, and only the character that ends up as the delimiter stays escaped: + -
+ +
+ Entities that are not quotes, such as & or &[#39](https://github.com/biomejs/biome/issues/39);, are left exactly as written. + - #11193 77035bb Thanks @dyc3! - Fixed the HTML formatter collapsing the blank line between an element and the text that follows it. A blank line before text is now kept, the way one before another element already was: +
foo
+ - + text + - #11106 ad80f57 Thanks @dyc3! - The HTML formatter now writes the HTML5 doctype in lowercase, matching Prettier: + - + + + This only applies to a plain .html file whose doctype stands alone. A doctype that names a DTD keeps the case it was written with, since the rest of the declaration is not lowercased either: + + A .vue, .svelte, or .astro file keeps whatever the author wrote. + - #11188 60679db Thanks @dyc3! - Fixed the HTML formatter printing a comment twice when it ended the line of the last element in a document: + - text + + text + - #11077 4dcd0d9 Thanks @dyc3! - Fixed a bug where the HTML formatter collapsed the whitespace inside + + + Biome now prints the content of these elements exactly as it appears in the source, matching the existing behavior for
.
+  - #11194 abfbb11 Thanks @dyc3! - Fixed the HTML formatter refusing to format a Svelte file containing an array pattern that skips a position:
+    {#each animals as [, value]}
+            

{value}

+ {/each} + - #10094 e007143 Thanks @THEjacob1000! - Fixed useSortedClasses to correctly detect unsorted classes in static member expression tagged templates (e.g. tw.div\...``). Previously, these were silently skipped due to surrounding whitespace trivia not being stripped from the tag name. + - #11078 10da30e Thanks @dyc3! - Fixed Vue single-file components failing to parse when they contain a custom block such as or , or a