desktop6:InstallAction

Artikel
08/17/2024

Gibt eine Installer-Datei (.exe oder .msi) an, die vor dem ersten Start der Desktopanwendung ausgeführt wird.

Anmerkung

Dieses Element soll derzeit nur von Desktop-PC-Spielen verwendet werden, die in einem MSIXVC-Container verpackt sind. Es erfordert die customInstallActionseingeschränkte Funktion.

Elementhierarchie

<-Paket->

<desktop6:Extension>

<desktop6:CustomInstall>

<desktop6:InstallActions>

<desktop6:InstallAction>

Syntax

<desktop6:InstallAction
  File = 'A string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  Name = 'A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  Arguments = 'A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.' />

Attribute und Elemente

Attribute

Attribut	Beschreibung	Datentyp	Erforderlich
Datei-	Der Name der auszuführenden Datei (.exe oder .msi). Diese Datei muss in Ihrem Paket vorhanden sein. Sie können einen Pfad angeben, der relativ zum attribut Folder des desktop6 ist. CustomInstall-Element. Sie können keinen absoluten Pfad angeben, und der relative Pfad darf nicht mit einem `\` Zeichen beginnen.	Eine Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen, die diese Zeichen nicht enthalten können: `<`, `>`, `:`, `"`, `\|`, `?`oder `*`.	Ja
Name	Der Name für die Installationsaktion. Dieser Name wird verwendet, um die Installationsaktion zu identifizieren, und das Betriebssystem verwendet diesen Namen, um nachzuverfolgen, welche Aktionen erfolgreich ausgeführt wurden. Stellen Sie sicher, dass dieser Wert dem `Name`-Attribut für die entsprechenden desktop6:RepairAction und desktop6:UninstallAction Elemente entspricht, die Sie als Teil derselben Sequenz ausführen möchten. Dieser Name muss im übergeordneten desktop6:InstallActions Element eindeutig sein, kann aber von anderen Aktionen unter dem desktop6:RepairActions und desktop6:UninstallActions-Elemente freigegeben werden.	Eine Zeichenfolge mit einem Wert zwischen 1 und 32767 Zeichen länge mit einem Nicht-Leerzeichen am Anfang und Ende.	Ja
Argumente	Optionale Argumente, die an die Installationsdatei übergeben werden sollen.	Eine Zeichenfolge mit einem Wert zwischen 1 und 32767 Zeichen länge mit einem Nicht-Leerzeichen am Anfang und Ende.	Nein

Untergeordnete Elemente

Nichts

Übergeordnete Elemente

Übergeordnetes Element	Beschreibung
desktop6:InstallActions	Gibt Installationsdateien (.exe oder .msi) an, die vor dem ersten Start der Desktopanwendung ausgeführt werden.

Bemerkungen

Dieses Element erfordert die customInstallActionseingeschränkte Funktion.

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