desktop6:InstallAction

Article
10/30/2023

Spécifie un fichier du programme d’installation (.exe ou .msi) qui est exécuté avant le premier lancement de votre application de bureau.

Notes

Cet élément est actuellement destiné à être utilisé uniquement par les jeux PC de bureau qui sont empaquetés dans un conteneur MSIXVC. Il nécessite la fonctionnalité restreintecustomInstallActions.

Hiérarchie d’éléments

<desktop6:Extension>

<desktop6:CustomInstall>

<desktop6:InstallActions>

<desktop6:InstallAction>

Syntaxe

<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.' />

Attributs et éléments

Attributs

Attribut	Description	Type de données	Obligatoire
File	Nom du fichier à exécuter (.exe ou .msi). Ce fichier doit exister dans votre package. Vous pouvez spécifier un chemin d’accès relatif à l’attribut Folder du desktop6. Élément CustomInstall . Vous ne pouvez pas spécifier de chemin d’accès absolu, et le chemin relatif ne doit pas commencer par un `\` caractère.	Chaîne dont la valeur est comprise entre 1 et 256 caractères et qui ne peut pas contenir les caractères suivants : `<`, `>`, `:`, `"\|`, `?`, ou `*`.	Yes
Nom	Nom de l’action d’installation. Ce nom est utilisé pour identifier l’action d’installation, et le système d’exploitation utilise ce nom pour suivre les actions qui ont été exécutées avec succès. Assurez-vous que cette valeur correspond à l’attribut `Name` des éléments desktop6 :RepairAction et desktop6 :UninstallAction correspondants que vous souhaitez exécuter dans le cadre de la même séquence. Ce nom doit être unique dans l’élément desktop6 :InstallActions parent, mais il peut être partagé par d’autres actions sous les éléments desktop6 :RepairActions et desktop6 :UninstallActions .	Chaîne dont la valeur est comprise entre 1 et 32767 caractères avec un caractère non-espace blanc au début et à la fin.	Yes
Arguments	Arguments facultatifs à passer au fichier du programme d’installation.	Chaîne dont la valeur est comprise entre 1 et 32767 caractères avec un caractère non-espace blanc au début et à la fin.	No

Éléments enfants

Aucun

Éléments parents

Élément parent	Description
desktop6:InstallActions	Spécifie les fichiers du programme d’installation (.exe ou .msi) qui sont exécutés avant le premier lancement de votre application de bureau.

Remarques

Cet élément nécessite la fonctionnalité restreintecustomInstallActions.

Exemples

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

Configuration requise

Élément	Valeur
Espace de noms	`http://schemas.microsoft.com/appx/manifest/desktop/windows10/6`
Minimum OS Version	Windows 10 version 1903 (build 18362)