desktop6 :InstallAction

Article
08/17/2024

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

Note

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

Hiérarchie d’éléments

<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
fichier	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 bureau . Élément CustomInstall. Vous ne pouvez pas spécifier un chemin absolu, et le chemin relatif ne doit pas commencer par un caractère `\`.	Chaîne avec une valeur comprise entre 1 et 256 caractères qui ne peut pas contenir ces caractères : `<`, `>`, `:`, `"`, `\|`, `?`ou `*`.	Oui
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é correctement exécutées. Vérifiez que cette valeur correspond à l’attribut `Name` pour les éléments desktop6 :RepairAction correspondants et desktop6 :UninstallAction éléments que vous souhaitez exécuter dans le cadre de la même séquence. Ce nom doit être unique dans l’élément parent desktop6 :InstallActions, mais il peut être partagé par d’autres actions sous les éléments desktop6 :RepairActions et desktop6 :UninstallActions.	Chaîne avec une valeur comprise entre 1 et 32767 caractères de longueur avec un caractère non blanc à son début et à sa fin.	Oui
arguments	Arguments facultatifs à passer au fichier d’installation.	Chaîne avec une valeur comprise entre 1 et 32767 caractères de longueur avec un caractère non blanc à son début et à sa fin.	Non

Éléments enfants

Aucun

Éléments parents

Élément parent	Description
desktop6 :InstallActions	Spécifie les fichiers 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 customInstallActionsfonctionnalité restreinte.

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>

Exigences

Article	Valeur
Espace de noms	`http://schemas.microsoft.com/appx/manifest/desktop/windows10/6`
version minimale du système d’exploitation	Windows 10 version 1903 (build 18362)

Partager via