So erstellen Sie eine benutzerdefinierte App-Installer-Erfahrung

Artikel
10/31/2023

Hinweis

Dieses Feature von App-Installer wurde vorübergehend zurückgesetzt und funktioniert derzeit nicht. Bitte schauen Sie später noch einmal für weitere Updates vorbei, denn wir planen die Wiedereinführung dieser Funktion.

Die App-Installer App wird für alle MSIX-Installationen verwendet und bietet allen Benutzern, die eine MSIX-Anwendung installieren, eine einheitliche Erfahrung. Obwohl diese Konsistenz gut ist, möchten wir Entwicklern auch die Möglichkeit bieten, die Installationserfahrung anzupassen, die sie ihren Benutzern zur Verfügung stellen. Diese Option ist ab Windows 10 1709 verfügbar.

Erstellen Ihrer benutzerdefinierten MSIXAppInstallerData.xml-Datei

Das erste, was Sie benötigen, um Ihre App-Installer-Erfahrung anzupassen, ist die Anpassungs-XML-Datei. Sie können verschiedene Funktionen Ihrer App-Installer-UX anpassen, um Ihre eigene einzigartige Installer-Erfahrung zu schaffen. Achten Sie darauf, den Dateinamen als MSIXAppInstallerData.xml zu speichern

Nachfolgend finden Sie eine Liste der Parameter, die für die Anpassung verfügbar sind:

App-Installer-UX-Einstellung	Beschreibung
UX::AccentColor	Ein Hexcode zum Ändern der Akzentfarbe von App-Installer
UX::FontFamily	Schriftfamilie
UX::AllowUserInteraction	Boolesch. Wenn true angezeigt wird, kann der Benutzer das Kontrollkästchen „Launch when ready“ sehen (standardmäßig aktiviert) und hat die Möglichkeit, die Installation abzubrechen
UX::BackgroundColor	Ein Hexcode zum Ändern der Hintergrundfarbe von App-Installer
UX::AppNameInTitle	Boolesch. Wenn true, wird der App-Name im Titel des Installationsfensters angezeigt.
HyperLinkFontSize	Schriftgrad für Hyperlinks.
Icon::HorizontalAlignment	Symbolausrichtung innerhalb des Fensters. Links, Zentriert, Rechts
Icon::Logo	Link zum Symbolspeicherort
Symbol::TopMarging	Rand vom oberen Rand des Symbols bis zum oberen Rand des Anwendungsfensters.
Buttons::HorizontalAlignment	Schaltflächenausrichtung innerhalb des Fensters. Links, Zentriert, Rechts
Buttons::Text	Zusätzlicher Text, der der Schaltfläche „Installieren“ hinzugefügt werden soll
Buttons::IsSecondaryButtonAccent	Boolesch.
LaunchWhenReady::HorizontalAlignment	Ausrichtung des Kontrollkästchens für „Launch when ready“. Mitte, links.
AppInformation::Mode	Zusätzlicher Informationsanzeigetyp. Normal, Flyout
Hyperlinks::TopMargin	Gibt den Rand zwischen Hyperlink und Schaltflächen an.
Hyperlink::Text	Als Link anzuzeigender Text
Hyperlink::Url	Verknüpfung
Hyperlink:: HorizontalAlignment	Ausrichtung des Links innerhalb des Fensters. Links, Zentriert, Rechts

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

Speichern Sie Ihre Datei als „MsixAppInstallerData.xml“

Hinzufügen der XML-Datei zu Ihrer MSIX-Anwendung

Verwendung des MSIX-Verpackungs-Tools - Paket-Editor

Öffnen Sie Ihre MSIX-Anwendung mit dem Paket-Editor im MSIX Packaging Tool
Gehen Sie zu Ihren Paketdateien und fügen Sie unter Ihrem Paketstamm einen neuen Ordner mit dem Namen „Msix.AppInstaller.Data“ hinzu
Fügen Sie Ihre MSIXAppInstallerData.xml-Datei zu Ihrem neu erstellten Ordner hinzu.
Speichern Sie Ihr MSIX-Paket – erhöhen Sie unbedingt die Version und signieren Sie das Paket

Problembehandlung

Die Datei muss den Namen MSIXAppInstallerData.xml haben
Die Datei muss sich im Ordner MSIXAppInstallerData befinden
Der Ordner muss sich unter dem Paketstamm der Paketdateien befinden
Überprüfen Sie Ihre Betriebssystemversion und Ihre App-Installer-Version
Vergewissern Sie sich über die Gültigkeit Ihrer XML-Datei

Teilen Sie uns Ihr Feedback mit, wenn Sie auf andere Probleme stoßen, oder wenden Sie sich an das MSIX-Team in unserer Tech Community.

Freigeben über