Come creare un'esperienza personalizzata del programma di installazione app

Nota

Questa funzionalità del programma di installazione app è stata temporaneamente eseguito il rollback e non funzionerà subito. Per ulteriori aggiornamenti, consultare nuovamente 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 che forniscono agli utenti. Questa funzionalità è disponibile in Windows 10 1709 e versioni successive.

Creare il file di MSIXAppInstallerData.xml personalizzato

La prima cosa che dovrai personalizzare l'esperienza del programma di installazione app è il file xml di personalizzazione. È possibile 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

Ecco 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 Proprietà di tipo Boolean. Se true, l'utente può visualizzare la casella di controllo "launch when ready" (selezionata per impostazione predefinita) e ha l'opzione per annullare l'installazione
UX::BackgroundColor Codice esadecimale per modificare il colore di sfondo del programma di installazione app
UX::AppNameInTitle Proprietà di tipo Boolean. Se true, il nome dell'app verrà visualizzato nel titolo della finestra del programma di installazione.
HyperLinkFontSize Dimensioni del carattere di collegamento Hyper.
Icona::HorizontalAlignment Allineamento dell'icona all'interno della finestra. Sinistra, centro, destra
Icona::Logo Collegamento alla posizione dell'icona
Icona::TopMarging Margine dalla parte superiore dell'icona nella parte superiore della finestra dell'applicazione.
Pulsanti::HorizontalAlignment Allineamento dei pulsanti all'interno della finestra. Sinistra, centro, destra
Pulsanti::Testo Testo aggiuntivo da aggiungere ai pulsanti Installa
Pulsanti::IsSecondaryButtonAccent Proprietà di tipo Boolean.
LaunchWhenReady::HorizontalAlignment Allineamento della casella di controllo "Avvia quando è pronto". Centro, sinistra.
AppInformation::Mode Altre informazioni mostrano il tipo. Normale, riquadro a comparsa
Collegamenti ipertestuali::TopMarging 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. Sinistra, centro, 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" TopMarging="70"/> 

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

    <LaunchWhenReady HorizontalAlignment="center"/> 

    <AppInformation Mode="flyout" /> 

    <HyperLinks TopMarging="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 dello strumento di creazione pacchetti MSIX - Editor pacchetti

  1. Aprire l'applicazione MSIX con Editor pacchetti nello strumento di creazione pacchetti MSIX

  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 essere 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 sui file se si verificano altri problemi o contattare il team MSIX nella nostra Community tech.