Teilen über

Veröffentlichen einer UWP-WebView2-App im Microsoft Store

  • Artikel

Eine UWP-WebView2-App ist eine Universelle Windows-Plattform-App (UWP), die das WebView2-Steuerelement hostet. Um eine UWP-WebView2-App allgemein verfügbar zu machen, können Sie sie im Microsoft Store veröffentlichen, indem Sie die folgenden Schritte ausführen.

Allgemeine Hintergrundinformationen zum Veröffentlichen im Windows Store finden Sie unter Veröffentlichen von Windows-Apps und -Spielen in der Dokumentation > zur Windows-App-Entwicklung UWP. Die folgenden Schritte enthalten die spezifischen Details zum Veröffentlichen einer UWP-WebView2-App.

Schritt 1: Konfigurieren eines Microsoft Store-Kontos in Visual Studio

  • Stellen Sie sicher, dass Sie ein Microsoft Store-Konto in Microsoft Visual Studio konfiguriert haben.

    Informationen zu Entwicklerkonten für den Microsoft Store finden Sie unter Registrieren bei Bedarf. Fahren Sie dann mit den folgenden Schritten fort.

Schritt 2: Testen der nicht gepackten Host-App

Testen Sie diese allgemeinen grundlegenden Probleme, bevor Sie Ihre App an den Microsoft Store übermitteln. Dadurch können Sie Store-Zertifizierungsfehler verhindern, die die Verfügbarkeit Ihrer App verzögern würden.

  1. Stellen Sie sicher, dass die App beim Start ordnungsgemäß ausgeführt wird.

  2. Stellen Sie sicher, dass die App während des Standbymodus ordnungsgemäß funktioniert.

Schritt 3: Packen der Host-App

Der Microsoft Store erfordert das Übermitteln einer gepackten App. Packen Sie Ihre App wie folgt:

  1. Aktualisieren Sie den package.appxmanifest mit allen erforderlichen Inhalten, z. B. Visual Assets, Paketname und Anwendungsinformationen. Wenn Sie dies nicht tun, schlägt der Microsoft Store-Überprüfungsschritt fehl. Fahren Sie dann mit den folgenden Schritten fort.

  2. Wählen Sie im Partner CenterProjekt>veröffentlichen aus, und reservieren Sie dann einen Anwendungsnamen.

  3. Ordnen Sie die Anwendung dem reservierten Namen zu, indem Sie Projekt>veröffentlichen>App dem Store zuordnen auswählen.

  4. Erstellen Sie das App-Paket, indem Sie Projekt>veröffentlichen>App-Pakete erstellen auswählen. Wählen Sie die Zielkonfigurationen aus:

    Auswählen von Zielkonfigurationen

    32-Bit- und 64-Bit-Versionen der WebView2-Runtime funktionieren in UWP auf Nicht-ARM-Plattformen. 32-Bit wird für ARM aufgrund von Abhängigkeiten von Microsoft Edge nicht unterstützt. 64-Bit wird auf ARM unterstützt.

  5. Nachdem das App-Paket für Ihre Konfigurationen erstellt wurde, wird im Fenster App-Pakete erstellen das Dialogfeld Paketerstellung abgeschlossen angezeigt:

    Zertifizierungskit für Windows-App

  6. Notieren Sie sich im Dialogfeld, wo das Paketpaket platziert wurde. Diese Informationen werden auch im Buildfenster angezeigt.

  7. Klicken Sie auf die Schaltfläche Schließen .

Schritt 4: Testen des Pakets

Um sicherzustellen, dass alle erforderlichen Inhaltsdateien im Paket vorhanden sind, und um sicherzustellen, dass die Dateien über die richtigen Berechtigungen verfügen, testen Sie Ihre gepackte App wie folgt:

  1. Verwenden Sie das generierte App-Paket, um die App auf Ihrem Computer zu installieren. Suchen Sie nach Kuriositäten in Bezug auf erforderliche Pakete und Funktionen.

  2. Installieren Sie Ihre App nach Möglichkeit auch auf anderen Computern. Suchen Sie nach Kuriositäten in Bezug auf erforderliche Pakete und Funktionen.

Schritt 5: Ausführen des Zertifizierungskits für Windows-Apps (WACK)

Das Windows App Certification Kit (WACK) ist eine App, die ein Zertifizierungstool ist. Dieses Tool wertet Ihre Host-App anhand der Anforderungen des Microsoft Store aus.

Wenn Sie zufrieden sind, dass Ihre gepackte App funktioniert, führen Sie das Zertifizierungskit für Windows-Apps (WACK) aus:

  1. Generieren Sie das App-Paket wie oben beschrieben erneut. Dies ist die einfachste Möglichkeit, um zum WACK-Prozess (Windows App Certification Kit) zu gelangen.

  2. Nachdem die Paketerstellung abgeschlossen ist, wählen Sie Launch Windows App Certification Kit (Zertifizierungskit für Windows-Apps starten) aus.

  3. Sie müssen das Dialogfeld User Access Control (UAC) genehmigen, damit das Zertifizierungskit für Windows-Apps (WACK) ordnungsgemäß ausgeführt wird.

  4. Wählen Sie alle für die Testsuite aus, und klicken Sie dann auf Weiter.

  5. Nach einigen Minuten zeigt das Zertifizierungskit für Windows-Apps (WACK) eine Ergebnisseite an. Wenn bei der App ein Fehler aufgetreten ist, klicken Sie auf den Link, um die Ergebnisse zu überprüfen.

Auflösen von Tests

Auf der Ergebnisseite der WACK-App (Windows App Certification Kit) werden alle Tests angezeigt, die gelöst werden müssen.

Eingeschränkter Namensraum

Wenn Ihre App bei der Überprüfung eingeschränkter Name-Leerzeichen nicht erfolgreich war, bearbeiten Sie die package.appxmanifest Datei, und entfernen Sie die restrictedcapabilities Zeile und alle Funktionen, die verwenden rescap.

WebView2 sollte für den Betrieb keine eingeschränkten Funktionen erfordern. Wenn Ihre App eingeschränkte Funktionen benötigt, müssen Sie entweder über Partner Center eine Store-Ausnahme anfordern oder die App nur über Nicht-Store-Möglichkeiten verteilen.

Branding

Wenn Ihre App bei den Brandingprüfungen nicht erfolgreich war, aktualisieren Sie alle visuellen Objekte im Manifest wie oben beschrieben.

App-Funktionen

Wenn Ihre App die Tests der App-Funktionen nicht bestanden hat, deaktivieren Sie alle nicht benötigten Funktionen. Wenn Sie eine spezielle Verwendungsfunktion benötigen, müssen Sie die Microsoft Store-Genehmigung einholen oder Nicht-Store-Verteilungsmethoden verwenden.

Allgemeine Metadatenkorrektheit

Wenn Ihre App bei den Allgemeinen Metadaten-Korrektheitstests mit einem Fehler in IPopup4fehlgeschlagen ist, aktualisieren Sie microsoft. UI.xaml NuGet-Paket für version Microsoft.UI.Xaml.2.8.0-prerelease.220118001 oder höher. Vor dieser Version gab es einen Fehler in den Manifesten.

Unterstützte API

In diesem Test überprüft WACK die Windows-APIs, die Ihre Host-App aufruft, um sicherzustellen, dass sie unterstützt werden.

Wenn Ihre App den Unterstützten API-Test nicht bestanden hat, aktualisieren Sie das Windows SDK auf Version 22000 oder höher, um die neueste Version der Liste allowed-APIs zu erhalten. Es sollten keine blockierenden APIs für WebView2 im aktuellen Windows SDK vorhanden sein.

Schritt 6: Hochladen des App-Pakets

  • Nachdem alle WACK-Tests (Windows App Certification Kit) bestanden wurden, laden Sie Ihr App-Paket in den Windows Store hoch, indem Sie einen der folgenden Ansätze verwenden:

    • Ansatz 1: Wählen Sie im Zertifizierungskit für Windows-Apps (WACK) die Option Projekt>veröffentlichen>App-Pakete hochladen aus.

    • Ansatz 2: Wechseln Sie zu Partner Center, und laden Sie Ihr App-Paket über Partner Center in den Windows Store hoch.

Siehe auch