Lire en anglais

Partager via

Guide pratique pour créer une expérience d’installation d’application personnalisée

  • Article

L’application Programme d’installation d’application est utilisée pour toutes les installations MSIX offrant une expérience cohérente pour tous les utilisateurs qui installent une application MSIX. Bien que cette cohérence soit bonne, nous voulons également fournir aux développeurs la possibilité de personnaliser l’expérience d’installation qu’ils fournissent à leurs utilisateurs. Cette fonctionnalité est disponible à partir de Windows 10 1709 et versions ultérieures.

Créer votre fichier MSIXAppInstallerData.xml personnalisé

La première chose que vous allez devoir personnaliser lors de votre expérience sur App Installer est le fichier xml de personnalisation. Vous pouvez personnaliser plusieurs fonctionnalités de l’expérience utilisateur de votre programme d’installation d’application pour rendre votre propre expérience d’installation unique. Veillez à enregistrer le nom du fichier en tant que MSIXAppInstallerData.xml

Voici la liste des paramètres disponibles pour la personnalisation :

Paramètre de l’expérience utilisateur sur App Installer Description
UX ::AccentColor Code hexadécimal pour modifier la couleur d’accentuation d’App Installer
UX ::FontFamily Famille de polices
UX ::AllowUserInteraction Boolean. Si la valeur est « true », l’utilisateur peut voir la case « lancer quand c’est prêt » (cochée par défaut) et a la possibilité d’annuler l’installation
UX :: BackgroundColor Code hexadécimal pour modifier la couleur d’arrière-plan du programme d’installation d’application
UX ::AppNameInTitle Boolean. Si la valeur est « true », le nom de l’application apparaît dans le titre de la fenêtre du programme d’installation.
HyperLinkFontSize Taille de police Hyper link.
icône ::HorizontalAlignment Alignement des icônes dans la fenêtre. Gauche, centre, droite
Icône  ::Logo Lien vers l’emplacement de l’icône
Icône ::TopMarging Marge du haut de l’icône en haut de la fenêtre d’application.
Buttons ::HorizontalAlignment Alignement des boutons dans la fenêtre. Gauche, centre, droite
Bouton ::Texte Texte supplémentaire à ajouter aux boutons Installer
Buttons ::IsSecondaryButtonAccent Boolean.
LaunchWhenReady ::HorizontalAlignment Alignement de la case à cocher « Lancer quand c’est prêt ». Centre, gauche.
AppInformation ::Mode Les informations supplémentaires indiquent le type. Normal, menu volant
Lien hypertexte ::TopMargin Spécifie la marge entre les liens hypertexte et les boutons.
Lien hypertexte ::Texte Texte à afficher en tant que lien hypertexte
Lien hypertexte ::Url Lien
Hyperlink:: HorizontalAlignment Alignement du lien hypertexte dans la fenêtre. Gauche, centre, droite

Exemple xml :

XML 

<?xml version="1.0" encoding="utf-8"?> 

<AppInstallerUX xmlns="http://schemas.microsoft.com/msix/appinstallerux"  

xmlns:ux="http://schemas.microsoft.com/msix/appinstallerux" 

xmlns:ux2="http://schemas.microsoft.com/msix/appinstallerux/2" 

IgnorableNamespaces="ux ux2" Version="1.0.0"> 

  <UX AccentColor="#DE781F" FontFamily="Segoe UI" AllowUserInteraction="false" BackgroundColor="#F3F3F3"  

  AppNameInTitle="true"  

  HyperLinkFontSize="12"> 

    <Icon HorizontalAlignment="center" Logo="Images\Contoso96x96.png" TopMargin="70"/> 

    <Buttons HorizontalAlignment="center" Text="Contoso" IsSecondaryButtonAccent="false"/> 

    <LaunchWhenReady HorizontalAlignment="center"/> 

    <AppInformation Mode="flyout" /> 

    <HyperLinks TopMargin="30"> 

      <HyperLink  Text="Terms &amp; conditions" Url="https://support.microsoft.com/" HorizontalAlignment="center"/> 

    </HyperLinks> 

  </UX> 

</AppInstallerUX>

Enregistrez votre fichier en tant que « MsixAppInstallerData.xml »

Ajouter le fichier xml à votre application MSIX

Utilisation de l’outil d’empaquetage MSIX - Éditeur de packages

  1. Ouvrez votre application MSIX avec l’éditeur de package dans l’outil d’empaquetage MSIX

  2. Accédez à vos fichiers de package et ajoutez un nouveau dossier sous la racine de votre package appelé « Msix.AppInstaller.Data »

  3. Ajoutez votre fichier MSIXAppInstallerData.xml à votre dossier nouvellement créé.

  4. Enregistrer votre package MSIX : veillez à incrémenter la version et à signer le package

Dépannage

  • Le fichier doit être nommé MSIXAppInstallerData.xml
  • Le fichier doit se trouver dans le dossier nommé MSIXAppInstallerData
  • Le dossier doit se trouver sous la racine des fichiers du package
  • Vérifier la version de votre système d’exploitation et la version de votre programme d’installation d’application
  • Vérifiez la validité de votre fichier xml

Faites part de vos commentaires si vous rencontrez d’autres problèmes ou contactez l’équipe MSIX sur notre communauté technique.