So erstellen Sie eine benutzerdefinierte App-Installer-Erfahrung
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 & 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.