Veröffentlichen einer PWA im Microsoft Store

Die Veröffentlichung Ihrer progressiven Web-App (PWA) im Microsoft Store bietet die folgenden Vorteile:

Um Ihre PWA im Microsoft Store zu veröffentlichen, sind keine Codeänderungen erforderlich. Stattdessen erstellen Sie eine App-Reservierung im Microsoft Partner Center, verpacken Ihre PWA mit PWA Builder und übermitteln Ihr Paket dann an den Microsoft Store. In den folgenden Abschnitten werden diese Schritte erläutert.

Siehe auch:

• Erste Schritte: Veröffentlichen Ihrer ersten App im Microsoft Store

Erstellen einer App-Reservierung

Zum Übermitteln Ihrer App an den Microsoft Store verwenden Sie das Microsoft Partner Center.

So erstellen Sie eine App-Reservierung:

1. Bevor Sie eine App-Reservierung erstellen können, müssen Sie über ein persönliches Microsoft-Konto (kein geschäftliches Microsoft-Konto oder ein Microsoft-Schulkonto) verfügen, das beim Windows Developer Program registriert ist.

   1. Wenn Sie noch keines haben, erstellen Sie unter account.microsoft.com ein persönliches Microsoft-Konto.
   2. Registrieren Sie sich für das Windows-Entwicklerprogramm, indem Sie die Schritte unter Eröffnen eines Entwicklerkontos im Partner Center ausführen.

2. Nachdem Ihr Konto beim App Developer-Programm registriert ist, führen Sie die folgenden Schritte aus, um eine App-Reservierung zu erstellen:

   1. Wechseln Sie zum Partner Center-Dashboard. Melden Sie sich mit dem Konto an, das Sie registriert haben.
   2. Wählen Sie unter Arbeitsbereichedie Option Apps und Spiele aus. Die Apps und Spiele | Übersichtsseite erscheint.
   3. Wählen Sie "Neue Produkt>-, MSIX- oder PWA-App" aus.
   4. Wenn Sie dazu aufgefordert werden, geben Sie einen Namen für Ihre Reservierung ein, und wählen Sie dann Produktnamen reservieren aus.

   

3. Um Ihre Herausgeberdetails zur Verwendung im Abschnitt "PWA paketieren " anzuzeigen, wählen Sie Produktverwaltung>Produktidentität aus.

   

4. Kopieren und speichern Sie die folgenden Werte.

   • Paket-ID
   • Herausgeber-ID
   • Anzeigename des Herausgebers

Verpacken Ihrer PWA für den Store

Nachdem Sie die Veröffentlichungsinformationen zu Ihrer App gesammelt haben, generieren Sie mithilfe von PWA Builder ein Windows-App-Paket für Ihre PWA.

So generieren Sie ein App-Paket:

1. Wechseln Sie zu PWA Builder.

2. Geben Sie unter PWA an App-Stores liefern die URL Ihrer PWA in das Textfeld ein, und klicken Sie dann auf die Schaltfläche Start .

   Ihre PWA wird ausgewertet, um sicherzustellen, dass sie für den Store bereit ist.

3. Wenn die Auswertung auf der Seite des PWABuilder-Berichts Karte zeigt, dass Ihre PWA verpackt werden kann, fahren Sie mit dem nächsten Schritt fort. Wenn die Auswertung ergibt, dass Ihre PWA nicht bereit zum Verpacken ist, überprüfen Sie den Abschnitt "Aktionselemente ", um zu erfahren, wie Sie Ihre PWA verbessern können:

   

4. Sobald Ihre PWA zum Verpacken bereit ist, klicken Sie in der oberen rechten Ecke des PWABuilder-Berichts Karte Seite auf die Schaltfläche "Für Speicher verpacken". Ein Dialogfeld mit der Meldung Großartig! Ihre PWA ist bereit für den Laden!.

5. Klicken Sie unter Windows auf die Schaltfläche Paket generieren . Das Dialogfeld "Windows-Paketoptionen" wird geöffnet.

6. Fügen Sie die folgenden Werte ein, die Sie oben im Abschnitt "Erstellen einer App-Reservierung" gespeichert haben:

   • Paket-ID
   • Anzeigename des Herausgebers
   • Herausgeber-ID

   

7. Klicken Sie auf die Schaltfläche "Paket herunterladen ", um Ihr Windows-Paket herunterzuladen.

Ihr Download ist ein .zip Archiv, das eine Datei und eine .classic.appxbundle.msixbundle Datei enthält. Mit den beiden App-Paketen kann Ihre PWA auf einer Vielzahl von Windows-Versionen ausgeführt werden.

Siehe auch:

• Was ist ein klassisches Paket?
• Bündeln von MSIX-Paketen.

Übermitteln Ihres App-Pakets an den Microsoft Store

So übermitteln Sie Ihre App an den Microsoft Store:

1. Wechseln Sie zu Microsoft Partner Center.

2. Wählen Sie Ihre App aus.

3. Klicken Sie auf die Schaltfläche "Übermittlung starten ".

   

4. Wenn Sie dazu aufgefordert werden, geben Sie Informationen zu Ihrer App an, z. B. Preise und Altersfreigabe.

5. Wählen Sie in der Eingabeaufforderung Pakete die und die Dateien aus, die .msixbundle.classic.appxbundle Sie im Abschnitt PWA paketieren generiert haben.

Nachdem Sie die App übermittelt haben, wird sie überprüft, in der Regel innerhalb von 24 bis 48 Stunden. Nachdem die App genehmigt wurde, ist Ihre PWA im Microsoft Store verfügbar.

Messen Sie die Nutzung Ihrer PWA, die aus dem Microsoft Store installiert wurde

Wenn Ihre PWA zum ersten Mal gestartet wird und die PWA aus dem Microsoft Store installiert wurde, fügt Microsoft Edge den folgenden Referer Header mit der Anforderung der ersten Navigation Ihrer Web-App hinzu.

Referer: app-info://platform/microsoft-store

Verwenden Sie dieses Feature, um den Datenverkehr von Ihrer PWA zu messen, die aus dem Microsoft Store installiert wurde. Basierend auf dem Datenverkehr können Sie den Inhalt Ihrer App anpassen, um die Benutzererfahrung zu verbessern. Auf dieses Feature kann sowohl Client- als auch Servercode zugegriffen werden. Um auf diese Informationen auf der Clientseite zuzugreifen, können Sie Ihr JavaScript abfragen document.referrer .

Umleiten an gebietsschemaspezifische Domänen ohne zusätzliche Benutzeroberfläche

Standardmäßig zeigt eine PWA, die aus dem Microsoft Store installiert wird, eine zusätzliche Benutzeroberfläche an, wenn die App an eine gebietsschemaspezifische Domäne umgeleitet wird. Die hinzugefügte Benutzeroberfläche zeigt die URL und den Seitentitel an. Diese Benutzeroberfläche wurde hinzugefügt, da die Navigation zu der gebietsschemaspezifischen Domäne als außerhalb des Gültigkeitsbereichs betrachtet wird.

Wenn ein Benutzer den Bereich einer PWA verlässt, wird die folgende Benutzeroberfläche eingeführt:

Domänenumleitung mit PWAs, die über den Browser installiert werden

Ein Web-App-Manifest ist an eine einzelne Domäne gebunden. Einige PWAs verwenden jedoch gebietsschemaspezifische Domänen für ihre Kunden in bestimmten Regionen der Welt. Beim Besuch der PWA in einem Webbrowser werden Kunden nahtlos von der Hauptdomäne (z. B contoso.com. ) zu einer gebietsschemaspezifischen Domäne (z. B. ) übergeleitet, contoso.co.keda die Umleitung während des ersten Ladens dieser Website erfolgt.

Kunden, die die PWA über Microsoft Edge installieren, installieren die PWA daher aus der gebietsschemaspezifischen Domäne. Bei nachfolgenden Starten der PWA wird direkt diese gebietsschemaspezifische Domäne gesendet, anstatt zuerst zur Hauptdomäne zu wechseln.

Domänenumleitung mit PWAs, die aus dem Microsoft Store installiert wurden

PWAs, die aus dem Microsoft Store installiert werden, verfügen über eine hartcodierte Start-URL, die auf die Prinzipaldomäne verweist. Wenn die PWA gestartet wird, navigiert die PWA zunächst zur Prinzipaldomäne, und dann kann ein Kunde (bei Bedarf) zu seiner gebietsschemaspezifischen Domäne umgeleitet werden. Wenn diese Umleitung erfolgt, wird die Navigation als "außerhalb des Gültigkeitsbereichs" betrachtet. Dadurch zeigt die App die URL und den Seitentitel oben auf der Seite an.

Die Anzeige der URL und des Seitentitels ist ein Sicherheitsfeature, um sicherzustellen, dass Benutzer wissen, dass sie den Kontext der PWA verlassen haben. Diese zusätzliche Benutzeroberfläche ist sinnvoll, wenn ein Benutzer eine Seite von einer anderen Website im Kontext der PWA lädt. Diese zusätzliche Benutzeroberfläche kann jedoch unangemessen sein, wenn ein Benutzer zwischen Domänen wechselt, die alle Teil derselben Website sind.

Verhindern Sie, dass die gebietsschemaspezifische URL und der Titel angezeigt werden

Derzeit ist es für Apps, die aus dem Microsoft Store installiert wurden, unmöglich, die Anzeige der zusätzlichen URL- und Titel-Benutzeroberfläche beim Umleiten zu einer gebietsschemaspezifischen Domäne zu verhindern.

In Zukunft wird es einer PWA durch Bereichserweiterungen ermöglichen, die Navigation zu Pfaden, Unterdomänen oder sogar Websites außerhalb ihres eigenen Bereichs zu erfassen. Das Feature "Bereichserweiterung" befindet sich in der aktiven Entwicklung und kann noch nicht verwendet werden. Weitere Informationen zum Entwicklungsstand dieses Features in Chromium finden Sie im Feature "Web App Scope Extensions" unter Chrome Platform Status.

Sobald das Feature in Microsoft Edge verwendet werden kann, dokumentieren wir es hier. Weitere Informationen zur Funktionsweise von Bereichserweiterungen finden Sie in der Zwischenzeit im Erklärdokument im WICG-Repository.

Vornehmen von Updates für Ihre App

Wenn Sie Ihren PWA-Code aktualisieren, müssen Sie im Allgemeinen kein neues App-Paket erstellen und es erneut an den Microsoft Store übermitteln. Angenommen, Sie nehmen Änderungen am HTML-, CSS- oder JavaScript-Code des Front-Ends Ihrer App oder an Ihrem Service Worker vor. Wenn der Benutzer die App das nächste Mal startet, werden die Änderungen von dem Browser heruntergeladen, der die App von Ihrem Webserver ausführt.

Wenn Sie jedoch Änderungen an der Web-App-Manifestdatei vornehmen, müssen Sie ein neues App-Paket erstellen und erneut an den Microsoft Store übermitteln. Im Manifest können Sie beispielsweise das App-Symbol oder den App-Namen ändern oder Manifestmitglieder wie file_handlers, protocol_handlers, oder share_targethinzufügen. Das Erstellen und Übermitteln eines neuen App-Pakets ist erforderlich, wenn das Manifest geändert wird, da die Informationen in der Web-App-Manifestdatei in das Windows-App-Paket kopiert werden, um die Integration in Windows zu verbessern.

Siehe auch

• Microsoft Store
• PWA Builder

Dokumente im PWA Builder-Repository:

• Nächste Schritte, um Ihre PWA in den Microsoft Store zu bringen – Testen und übermitteln Sie Ihr PWA-App-Paket.
• Veröffentlichen einer neuen App im Store
• Aktualisieren einer vorhandenen App im Store – Aktualisieren Sie eine vorhandene Store-App auf eine PWA.
• Imageempfehlungen für Windows PWA-Pakete – Bildempfehlungen für PWAs im Store.
• Was ist ein klassisches Paket? - Erklärung zur App-Verpackung.