Come creare un'esperienza personalizzata del programma di installazione app

  • Articolo

Nota

Questa funzionalità del programma di installazione app è stata temporaneamente eseguito il rollback e non funzionerà al momento. Controllare di nuovo in un secondo momento per ulteriori aggiornamenti quando si prevede di ripristinare questa funzionalità.

L'app del programma di installazione app viene usata per tutte le installazioni MSIX che offrono un'esperienza coerente per tutti gli utenti che installano un'applicazione MSIX. Anche se questa coerenza è buona, vogliamo anche offrire agli sviluppatori la possibilità di personalizzare l'esperienza di installazione offerta agli utenti. Questa funzionalità è disponibile in Windows 10 1709 e versioni successive.

Creare il file MSIXAppInstallerData.xml personalizzato

La prima cosa che dovrai personalizzare l'esperienza del programma di installazione app è il file XML di personalizzazione. Puoi personalizzare diverse funzionalità dell'esperienza utente del programma di installazione app per creare un'esperienza di installazione unica. Assicurarsi di salvare il nome del file come MSIXAppInstallerData.xml

Di seguito è riportato un elenco di parametri disponibili per la personalizzazione:

Impostazione dell'esperienza utente del programma di installazione app Descrizione
UX::AccentColor Codice esadecimale per modificare il colore principale del programma di installazione app
UX::FontFamily Famiglia di caratteri
UX::AllowUserInteraction Booleano. Se true, l'utente può visualizzare la casella di controllo 'launch when ready' (selezionata per impostazione predefinita) e ha la possibilità di annullare l'installazione
UX::BackgroundColor Codice esadecimale per modificare il colore di sfondo del programma di installazione app
UX::AppNameInTitle Booleano. Se true, il nome dell'app verrà visualizzato nel titolo della finestra del programma di installazione.
HyperLinkFontSize Dimensioni del carattere del collegamento hyper.
Icon::HorizontalAlignment Allineamento dell'icona all'interno della finestra. A sinistra, al centro, a destra
Icona::Logo Collegamento alla posizione dell'icona
Icona::TopMarging Margine dalla parte superiore dell'icona nella parte superiore della finestra dell'applicazione.
Buttons::HorizontalAlignment Allineamento dei pulsanti all'interno della finestra. A sinistra, al centro, a destra
Pulsanti::Testo Testo aggiuntivo da aggiungere al pulsante Installa
Buttons::IsSecondaryButtonAccent Booleano.
LaunchWhenReady::HorizontalAlignment Allineamento della casella di controllo "Avvia quando pronto". Al centro, a sinistra.
AppInformation::Mode Informazioni aggiuntive mostrano il tipo. Normale, riquadro a comparsa
Collegamenti ipertestuali::TopMargin Specifica il margine tra collegamenti ipertestuali e pulsanti.
Collegamento ipertestuale::Testo Testo da visualizzare come collegamento ipertestuale
Collegamento ipertestuale::URL Collegamento
Collegamento ipertestuale:: HorizontalAlignment Allineamento del collegamento ipertestuale all'interno della finestra. A sinistra, al centro, a destra

Xml di esempio:


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

Salvare il file come 'MsixAppInstallerData.xml'

Aggiungere il file xml all'applicazione MSIX

Uso di MSIX Packaging Tool - Editor pacchetti

  1. Aprire l'applicazione MSIX con Editor pacchetti in MSIX Packaging Tool

  2. Passare ai file di pacchetto e aggiungere una nuova cartella nella radice del pacchetto denominata "Msix.AppInstaller.Data"

  3. Aggiungere il file MSIXAppInstallerData.xml alla cartella appena creata.

  4. Salvare il pacchetto MSIX: assicurarsi di incrementare la versione e firmare il pacchetto

Risoluzione dei problemi

  • Il file deve essere denominato MSIXAppInstallerData.xml
  • Il file deve trovarsi nella cartella denominata MSIXAppInstallerData
  • La cartella deve trovarsi sotto la radice del pacchetto dei file del pacchetto
  • Controllare la versione del sistema operativo e la versione del programma di installazione app
  • Verificare la validità del file XML

Inviare commenti e suggerimenti se si verificano altri problemi o contattare il team MSIX nella community tecnica.