Manifests - Required Files

[ljtill]

Within a given manifest folder, what are the required files for each manifest version?
After looking through several examples, it seems that typically only the package_name.yaml is required but can vary?

However, if we use Visual Studio manifests as an example there are two different approaches (Stable / Preview)...

Visual Studio 2022 Enterprise 17.0.1

• Microsoft.VisualStudio.2022.Enterprise.yaml

Visual Studio 2022 Enterprise Preview 17.0.0 Preview 2.1

• Microsoft.VisualStudio.2022.Enterprise-Preview.installer.yaml
• Microsoft.VisualStudio.2022.Enterprise-Preview.locale.en-US.yaml
• Microsoft.VisualStudio.2022.Enterprise-Preview.installer.yaml

[OfficialEsco]

Visual Studio 2022 Enterprise 17.0.1 is a singleton ManifestType. It can contain 1 installer and 1 Locale.

Visual Studio 2022 Enterprise Preview 17.0.0 Preview 2.1 is a Multi Manifest, This splits the singleton into Version, Installer and defaultLocale manifests.
The Version ManifestType only contains the PackageIdentifier, PackageVersion, DefaultLocale
The Installer ManifestType can a contain bunch of installers, which means multiple languages and user and machine scope switches
The defaultLocale ManifestType contains the default metadata, should usually be in English (en-US)
The locale ManifestType can contains any translation or metadata for another language.

Example: Mozilla Firefox

And yes we prefer Multi Manifests, any new versions/packages are converted to a Multi Manifest, the singletons are from ManifestVersion 0.0.1

[ljtill]

Thanks for the clarification @OfficialEsco