desktop6:MutablePackageDirectories

Article
30/10/2023

Enables your desktop application to specify one or more folders where users can modify the installation files for your application (for example, to install mods).

Note

This element is currently intended to be used only by certain types of desktop PC games that are published by Microsoft and our partners. It requires the modifiableApp restricted capability.

Element hierarchy

<desktop6:Extension>

<desktop6:MutablePackageDirectories>

Syntax

XML

<desktop6:MutablePackageDirectories>

  <!-- Child elements -->
  desktop6:MutablePackageDirectory

</desktop6:MutablePackageDirectories>

Attributes and elements

Attributes

None.

Child elements

Child element	Description
MutablePackageDirectory	Specifies a folder under the %ProgramFiles%\ModifiableWindowsApps path where the contents of your desktop application's install folder are projected so that users can modify the installation files (for example, to install mods). For more information, see Package.MutableLocation and Package.EffectiveLocation.

Parent elements

Parent element	Description
desktop6:Extension)	Declares an extensibility point for the desktop application.

Remarks

This element requires the modifiableApp restricted capability.

Examples

XML

<Package
  xmlns:desktop6="http://schemas.microsoft.com/appx/manifest/desktop/windows10/6"
  xmlns:rescap= 
"http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
  IgnorableNamespaces="rescap desktop6">
 
  <!-- ... -->
  <!-- Other entries omitted for brevity. -->
  <!-- ... -->
 
  <Extensions> 
    <desktop6:Extension Category="windows.mutablePackageDirectories">
      <desktop6:MutablePackageDirectories>
        <desktop6:MutablePackageDirectory Target="ContosoGame"/>
      </desktop6:MutablePackageDirectories>
    </desktop6:Extension>
  </Extensions>
 
  <Capabilities>
    <!-- Include the required restricted capability. -->
    <rescap:Capability Name="modifiableApp"/>
  </Capabilities>
</Package>

Requirements

Item	Value
Namespace	`http://schemas.microsoft.com/appx/manifest/desktop/windows10/6`
Minimum OS Version	Windows 10 version 1903 (Build 18362)

Share via