desktop6:CustomInstall

  • Artikel

Ermöglicht Ihrer Desktopanwendung das Angeben einer oder mehrerer zusätzlicher Installationsdateien (.exe oder .msi), die mit Ihrer Desktopanwendung installiert werden. Dies ist beispielsweise für Apps nützlich, die eine verteilbare Komponente eines Drittanbieters bündeln.

Hinweis

Dieses Element ist derzeit nur für bestimmte Arten von Desktop-PC-Spielen vorgesehen, die von Microsoft und unseren Partnern veröffentlicht werden. Hierfür ist die eingeschränkte CustomInstallActions-Funktion erforderlich.

Elementhierarchie

<Paket>

    <Erweiterungen>

         <desktop6:Extension>

              <desktop6:CustomInstall>

Syntax

<desktop6:CustomInstall
  Folder = 'A string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.' 
  desktop8:RunAsUser = 'An optional boolean value.'>

  <!-- Child elements -->
  desktop6:InstallActions
  desktop6:RepairActions
  desktop6:UninstallActions?

</desktop6:CustomInstall>

Schlüssel

? optional (null oder 1)

Attribute und Elemente

Attribute

attribute BESCHREIBUNG Datentyp Erforderlich Standardwert
Ordner Der Name des Paketordners, der alle Dateien enthält, die für alle benutzerdefinierten Aktionen erforderlich sind. Dieser Ordner kann Unterordner enthalten. Eine Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen, die die folgenden Zeichen nicht enthalten darf: <, >, :, ", |?, oder *. Yes

Untergeordnete Elemente

Untergeordnetes Element Beschreibung
InstallActions Gibt Installationsdateien an, die vor dem ersten Start Ihrer Desktopanwendung ausgeführt werden.
RepairActions Gibt Installationsdateien an, die ausgeführt werden, wenn der Benutzer die Reparatur- oder Zurücksetzungsoptionen auf der Seite Einstellungen für Ihre Desktopanwendung auswählt.
UninstallActions Gibt Installationsdateien an, die ausgeführt werden, wenn der Benutzer Ihre Desktopanwendung deinstalliert.

Übergeordnete Elemente

Übergeordnetes Element BESCHREIBUNG
desktop6:Extension Deklariert einen Erweiterbarkeitspunkt für die Desktopanwendung.
desktop8:RunAsUser Gibt an, ob die Aufgabe als aktueller Benutzer ausgeführt werden soll.

Hinweise

Dieses Element erfordert die eingeschränkte CustomInstallActions-Funktion.

Das Betriebssystem verwendet das Name Attribut der Elemente desktop6:InstallAction, desktop6:RepairAction und desktop6:UninstallAction , um einen zugehörigen Satz von Installations-, Reparatur- und Deinstallationsaktionen zu identifizieren. Um einen zugehörigen Satz von Aktionen anzugeben, die in Verbindung miteinander ausgeführt werden sollen, stellen Sie sicher, dass sie den gleichen Wert für das Name Attribut haben. Das Betriebssystem führt nur dann eine Deinstallationsaktion aus, wenn die entsprechende Installations- oder Reparaturaktion ausgeführt wurde.

Beispiele

<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.customInstall">
      <desktop6:CustomInstall Folder="MyInstallers">
        <desktop6:InstallActions>
          <desktop6:InstallAction File="Setup_AntiCheat.exe" Name="AC_1" Arguments="/add /silent" />
        </desktop6:InstallActions>
        <desktop6:RepairActions>
          <desktop6:RepairAction File="Setup_AntiCheat.exe" Name="AC_1" Arguments="/add /silent /force" />
        </desktop6:RepairActions>
        <desktop6:UninstallActions>
          <desktop6:UninstallAction File="Setup_AntiCheat.exe" Name="AC_1" Arguments="/remove /silent" />
        </desktop6:UninstallActions>
      </desktop6:CustomInstall>
    </desktop6:Extension>
  </Extensions>

  <Capabilities>
    <rescap:Capability Name="customInstallActions"/>
  </Capabilities>
</Package>

Anforderungen

Element Wert
Namespace http://schemas.microsoft.com/appx/manifest/desktop/windows10/6
Minimum OS Version Windows 10 Version 1903 (Build 18362)