desktop6 :CustomInstall

Article
08/17/2024

Permet à votre application de bureau de spécifier un ou plusieurs fichiers d’installation supplémentaires (.exe ou .msi) installés avec votre application de bureau. Par exemple, cela est utile pour les applications qui regroupent un composant redistribuable tiers.

Note

Cet élément est actuellement destiné à être utilisé uniquement par certains types de jeux PC de bureau publiés par Microsoft et nos partenaires. Elle nécessite la customInstallActionsfonctionnalité restreinte.

Hiérarchie d’éléments

<desktop6 :CustomInstall>

Syntaxe

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

Clé

? facultatif (zéro ou un)

Attributs et éléments

Attributs

Attribut	Description	Type de données	Obligatoire	Valeur par défaut
dossier	Nom du dossier de package qui contient tous les fichiers requis pour toutes les actions personnalisées. Ce dossier peut contenir des sous-dossiers.	Chaîne avec une valeur comprise entre 1 et 256 caractères qui ne peut pas contenir ces caractères : `<`, `>`, `:`, `"`, `\|`, `?`ou `*`.	Oui

Éléments enfants

Élément enfant	Description
InstallActions	Spécifie les fichiers d’installation qui sont exécutés avant le premier lancement de votre application de bureau.
RepairActions	Spécifie les fichiers d’installation qui sont exécutés lorsque l’utilisateur sélectionne les options de réparation ou de réinitialisation dans la page Paramètres de votre application de bureau.
UninstallActions	Spécifie les fichiers d’installation qui sont exécutés lorsque l’utilisateur désinstalle votre application de bureau.

Éléments parents

Élément parent	Description
desktop6 :Extension	Déclare un point d’extensibilité pour l’application de bureau.
desktop8 :RunAsUser	Indique si la tâche doit être exécutée en tant qu’utilisateur actuel.

Remarques

Cet élément nécessite la customInstallActionsfonctionnalité restreinte.

Le système d’exploitation utilise l’attribut Name des éléments desktop6 :InstallAction, desktop6 :RepairActionet desktop6 :UninstallAction éléments pour identifier un ensemble associé d’actions d’installation, de réparation et de désinstallation. Pour spécifier un ensemble d’actions connexes qui doivent être exécutées conjointement entre elles, vérifiez qu’elles ont la même valeur pour l’attribut Name. Le système d’exploitation exécute une action de désinstallation uniquement si l’action d’installation ou de réparation correspondante a été exécutée.

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