Edit

AppInstaller

  • Article

This element defines the root element of an appinstaller file. The appinstaller file describes the structure and defines the packages that will be installed as part of the deployment operation.

Element hierarchy

<AppInstaller>

Syntax


<?xml version="1.0" encoding="UTF-8"?>

<AppInstaller 
    xmlns="http://schemas.microsoft.com/appx/appinstaller/2017/2"
    Version= A version string in quad notation, "Major.Minor.Build.Revision".
    Uri= Web Uri to the redirected appinstaller file >

  <!-- Child elements -->
  ( MainPackage
  & MainBundle?
  & Dependencies?
  & OptionalPackages?
  & RelatedPackages?
  & UpdateSettings?
  & s4:UpdateUris?
  & s4:RepairUris?
  )

</AppInstaller>

Key

?   optional (zero or one) &   interleave connector (may occur in any order)

Attributes and Elements

Attributes

Attribute Description Data type Required
xmlns The namespace definition of the appinstaller schema. For a list of the namespaces, see the Requirements section in this article. URI as a string between 1 and 2084 characters in length. Yes
Version The version of appinstaller file A version string in quad notation, "Major.Minor.Build.Revision". Yes
Uri Web URI to the redirected appinstaller file. When the Uri specified in the field differs from the current file, the deployment operation will redirect to the Uri instead of the current file. The appinstaller file can only be redirected a max of three times. Query strings with multiple key/value pairs are currently not supported. Web URI as a string between 1 and 2084 characters in length. Yes

Child Elements

Child elements must appear in the specified order

Child Elements Description
MainPackage Specifies the main package that will be installed.
MainBundle Specifies the main bundle that will be installed.
OptionalPackages Specifies the optional packages.
RelatedPackages Specifies the related packages. These packages won't be installed.
Dependencies These are dependencies that will be installed if required.
UpdateSettings Use the updatesettings element to toggle auto update of installed packages.
s4:UpdateUris Specifies a list of Uris pointing to App Installer files for updating an installation.
s4:RepairUris Specifies a list of Uris pointing to App Installer files for repairing an installation.

Parent Elements

This outermost element may not be contained by any other elements.

Remarks

<AppInstaller> can have either a <MainPackage> or <MainBundle> element. The deployment operation will fail if more than one of either are included. Only encoding="UTF-8" with no escape characters, and no non-ascii characters is accepted.

Requirements

Requirement Description
xmlns=http://schemas.microsoft.com/appx/appinstaller/2017 This namespace is required for features introduced in Windows 10, version 1709.
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 1709