desktop6:CustomInstall

Artikel
08/17/2024

Ermöglicht Ihrer Desktopanwendung, eine oder mehrere zusätzliche Installer-Dateien (.exe oder .msi) anzugeben, die mit Ihrer Desktopanwendung installiert sind. Dies ist beispielsweise nützlich für Apps, die eine weiterverteilbare Komponente eines Drittanbieters bündeln.

Anmerkung

Dieses Element soll derzeit nur von bestimmten Arten von Desktop-PC-Spielen verwendet werden, die von Microsoft und unseren Partnern veröffentlicht werden. Es erfordert die customInstallActionseingeschränkte Funktion.

Elementhierarchie

<-Paket->

<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 eins)

Attribute und Elemente

Attribute

Attribut	Beschreibung	Datentyp	Erforderlich	Standardwert
Ordner-	Der Name des Paketordners, der alle Dateien enthält, erfordert alle benutzerdefinierten Aktionen. Dieser Ordner kann Unterordner enthalten.	Eine Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen, die diese Zeichen nicht enthalten können: `<`, `>`, `:`, `"`, `\|`, `?`oder `*`.	Ja

Untergeordnete Elemente

Untergeordnetes Element	Beschreibung
InstallActions	Gibt Installationsdateien an, die vor dem ersten Start der 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 Erweiterungspunkt für die Desktopanwendung.
desktop8:RunAsUser	Gibt an, ob die Aufgabe als aktueller Benutzer ausgeführt werden soll.

Bemerkungen

Dieses Element erfordert die customInstallActionseingeschränkte Funktion.

Das Betriebssystem verwendet das Name-Attribut der desktop6:InstallAction, desktop6:RepairActionund desktop6:UninstallAction Elemente, um einen zugehörigen Satz von Installations-, Reparatur- und Deinstallationsaktionen zu identifizieren. Um einen verwandten Satz von Aktionen anzugeben, die in Verbindung miteinander ausgeführt werden sollen, stellen Sie sicher, dass sie denselben Wert für das attribut Name 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

Artikel	Wert
Namespace	`http://schemas.microsoft.com/appx/manifest/desktop/windows10/6`
Mindestversion des Betriebssystems	Windows 10, Version 1903 (Build 18362)

Freigeben über