App Installer file (.appinstaller) schema reference

This reference provides details for each element, attribute, and data type that defines the schema for an .appinstaller file that defines the packages that are part of a related set.

The following table lists all of the elements in this schema.

Element Description
AppInstaller The root element of the appinstaller document.
Bundle Element that includes information about the app bundle. The child elements of this element requires an exact match of the name, publisher and version from the identity element in the app package bundle manifest.
Dependencies These are dependencies that will be installed if required.
MainBundle Element that includes information about the main bundle that will installed. The child elements of this element requires an exact match of the name, publisher and version from the identity element in the app package bundle manifest.
MainPackage Element that includes information about the main package that will installed. The child elements of this element requires an exact match of the name, publisher and version from the identity element in the app package manifest. ProcessorArchitecture is an optional element.
OptionalPackages Specifies the optional packages.
Package Element that includes information about the package. This elements requires an exact match of the name, publisher and version from the identity element in the app package manifest. ProcessorArchitecture is an optional element.
RelatedPackages Specifies the related packages. These packages won't be installed.
UpdateSettings Use the UpdateSettings element to toggle auto update of installed packages and set an interval for update checks.
OnLaunch Signifies that the deployment service will check for an update to the appinstaller file on the app launch.
s4:AutomaticBackgroundTask Checks for updates in the background. A check is made every 8 hours independently of whether the user launched the app. This type of update cannot show UI.
s4:ForceUpdateFromAnyVersion A boolean that allows the app's version to be incremented or decremented. Without this element, the app can only move to a higher version.
s4:MainPackageType Checks for updates in the background. A check is made every 8 hours independently of whether the user launched the app. This type of update cannot show UI.
s4:RepairUris A boolean that allows the app's version to be incremented or decremented. Without this element, the app can only move to a higher version.
s4:RepairUri A boolean that allows the app's version to be incremented or decremented. Without this element, the app can only move to a higher version.
s4:UpdateUris A boolean that allows the app's version to be incremented or decremented. Without this element, the app can only move to a higher version.
s4:UpdateUri A boolean that allows the app's version to be incremented or decremented. Without this element, the app can only move to a higher version.

Requirements

Requirement Value
xmlns=http://schemas.microsoft.com/appx/appinstaller/2017/2 This namespace is required for features introduced in Windows 10, version 1803.
xmlns:s4=http://schemas.microsoft.com/appx/appinstaller/2021 This namespace is required for features introduced in Windows version 21H2 build 22000
Minimum OS version Windows 10 version 1803 build 17134