Freigeben über

Testen anstehender APIs und Features

  • Artikel

In diesem Artikel wird erläutert, wie Sie zu einem Vorschaukanal von Microsoft Edge wechseln, um experimentelle APIs zu testen, die sich in einem WebView2 Prerelease SDK-Paket befinden.

Um neue oder bevorstehende APIs und Features zu testen, wechseln Sie zu einem Microsoft Edge-Vorschaukanal, anstatt die stabile WebView2-Runtime zu verwenden. Die Evergreen WebView2-Runtime wird häufig aktualisiert, um neue APIs und Funktionen hinzuzufügen. Diese Updates können APIs enthalten, die von Experimental in einem Vorabrelease WebView2 SDK auf Stable im WebView2 Release SDK heraufgestuft wurden. Einige der Updates in der Evergreen WebView2 Runtime könnten Ihre WebView2-App möglicherweise beeinträchtigen.

Es wird empfohlen, die experimentellen APIs im Voraus zu testen, bevor sie im WebView2 Release SDK zu Stable heraufgestuft werden, indem Sie zu einem Vorschaukanal von Microsoft Edge (einschließlich WebView2) wechseln, um sicherzustellen, dass Ihre App vorwärtskompatibel ist.

Siehe auch:

Verwenden eines Vorschaukanals von WebView2, um Ihre App mit den neuesten experimentellen WebView2-APIs zu testen

Die Evergreen WebView2 Runtime enthält keine experimentellen WebView2-APIs. Wenn Sie diese experimentellen Features in Ihrem WebView2-Code verwenden möchten, verwenden Sie stattdessen die Version von WebView2, die sich in einem Microsoft Edge-Vorschaukanal (Edge Beta, Edge Dev oder Edge Canary) befindet.

Der Canary-Kanal wird empfohlen, da er die neuesten experimentellen APIs bietet.

Zusammenspiel zwischen dem WebView2 Prerelease SDK und Microsoft Edge Preview-Kanälen

  • Vorabversions-SDK: Diese Version des WebView2 SDK stellt Methodensignaturen für experimentelle APIs bereit, mit denen Sie Code mithilfe der experimentellen WebView2-APIs in Ihrer App schreiben können.

  • Microsoft Edge Preview-Kanäle: Diese Kanäle (Edge Beta, Edge Dev oder Edge Canary) enthalten die erforderlichen Microsoft Edge-Binärdateien. Mit diesen Kanälen kann Ihre App mithilfe der experimentellen APIs ausgeführt und gerendert werden.

Weitere Informationen zur Interaktion von SDK-Versionen mit der WebView2-Runtime und den Microsoft Edge-Vorschaukanälen finden Sie unter Vorabversion und Release-SDKs für WebView2.

Testen der Vorwärtskompatibilität mithilfe des Vorschaukanals

Es wird empfohlen, anstehende Änderungen mithilfe von Vorschaukanälen zu testen, um die Vorwärtskompatibilität Ihrer App sicherzustellen, indem Sie die folgenden bewährten Methoden befolgen:

Herunterladen des Vorabversions-SDK und eines Vorschaukanals

Um experimentelle APIs zu verwenden, laden Sie eine Vorabversion des WebView2 SDK aus dem Microsoft.Web.WebView2-Paket herunter.

Zu den Vorschaukanälen von Microsoft Edge gehört die Vorschauversion der WebView2-Runtime. Vorschaukanäle werden auch als Insider-Kanäle bezeichnet. Nach der Installation bleiben die Vorschaukanäle auf dem neuesten Stand. Die neueste Version jedes Vorschaukanals wird automatisch installiert. Dies bedeutet beispielsweise, dass sich der Canary-Kanal fast täglich aktualisiert. Um einen Microsoft Edge-Vorschaukanal (Canary, Dev oder Beta) herunterzuladen, wechseln Sie zu Microsoft Edge-Insider werden.

Informationen zum Bereitstellen des Vorschaukanals auf mehreren Computern finden Sie weiter unten unter Bereitstellen von Vorschaukanälen.

Ansätze zur Verwendung eines bestimmten Browserkanals für Ihre App

Wenn eine WebView2 initialisiert wird, wird versucht, eine gültige Runtime auf dem zu verwendenden Computer zu finden. Dies kann die WebView2-Runtime, ein Vorschaukanal von Microsoft Edge oder ein angegebener Speicherort sein, der Binärdateien mit festen Versionen enthält. Weitere Informationen zu unterstützten Runtimes finden Sie unter Verteilen Ihrer App und der WebView2-Runtime.

Es gibt zwei Möglichkeiten, ihre WebView2-App dazu zu bringen, einen bestimmten Vorschaukanal von Microsoft Edge zu verwenden:

Diese Ansätze werden unten beschrieben.

Dieser Abschnitt gilt für die Verwendung einer API, einer Registrierungsüberschreibung, einer Umgebungsvariablen oder einer Gruppenrichtlinie.

Wenn kein bestimmter ausführbarer Browserordner angegeben ist, versucht WebView2, eine Runtime von einem der bekannten Standardspeicherorte zu laden. Standardmäßig sucht das WebView2-Ladeprogramm mit der ersten gefundenen Runtime nach Runtimes von stabil bis am wenigsten stabil (Canary).

WebView2 Runtime (Stable) ->  Edge Beta -> Edge Dev -> Edge Canary

Sie können die Standardsuchreihenfolge umkehren, indem Sie die ChannelSearchKind API auf LeastStablefestlegen oder die Richtlinie, den Registrierungsschlüssel oder die ChannelSearchKind Umgebungsvariable auf 1festlegen. Durch umkehren der Suchreihenfolge wird die Suche des WebView2-Ladeprogramms von am wenigsten stabil (Canary) zu stabilsten:

Edge Canary -> Edge Dev -> Edge Beta -> WebView2 Runtime (Stable)

Dies muss vor der Initialisierung des WebView2-Steuerelements erfolgen.

Wenn Sie eine spezifischere Reihenfolge benötigen, lesen Sie Verwenden ChannelSearchKind , um sicherzustellen, dass ein bestimmter Kanal verwendet wird.

Standardmäßig ist CoreWebView2ChannelSearchKind.MostStable die CoreWebView2EnvironmentOptions.ChannelSearchKind -Eigenschaft (ein Enumerationswert). Kehren Sie stattdessen die Suchreihenfolge um, indem Sie die CoreWebView2EnvironmentOptions.ChannelSearchKind -Eigenschaft auf CoreWebView2ChannelSearchKind.LeastStablefestlegen.

.NETTO:

WinRT:

Win32:

Verwenden ChannelSearchKind von , um sicherzustellen, dass ein bestimmter Kanal verwendet wird

Wenn Sie verwenden ChannelSearchKind, können Sie so sicherstellen, dass ein bestimmter Vorschaubrowserkanal verwendet wird, wenn mehrere Vorschaubrowserkanäle installiert sind.

Zusätzlich zum Umkehren der Kanalsuchreihenfolge können Sie den Satz von Releasekanälen so ändern, dass sie in die Suche einbezogen werden, um die Kanalauswahl weiter zu steuern. Das Ladeprogramm sucht auf dem Gerät nach Kanälen in der durch die Kanalsuchart angegebenen Reihenfolge, berücksichtigt jedoch nur Kanäle, die sich im angegebenen Satz von Releasekanälen befinden.

Diese Option ist nützlich, wenn Sie einen bestimmten Kanal als Ziel verwenden möchten, anstatt einfach den stabilsten oder am wenigsten stabilen Kanal auszuwählen. Standardmäßig enthalten die Releasekanäle alle Kanäle: Stable (0), Beta (1), Dev (2) und Canary (3).

Beispiel:

Channel Search Kind: 1 (Least Stable)
Release Channels: 0 (Stable), 1 (Beta)

Diese Beispieleinstellung bewirkt, dass der Ladeprogramm versucht, die App mit Edge Beta auszuführen, wenn Edge Beta auf dem Gerät installiert ist, und andernfalls auf die Verwendung der Stable WebView2 Runtime zurückgegriffen wird.

Die Releasekanäle können auf ähnliche Weise über die API, den Registrierungsschlüssel, die Umgebungsvariable oder die Gruppenrichtlinie festgelegt werden.

Standardmäßig berücksichtigt das Ladeprogramm alle Releasekanäle. Legen Sie ReleaseChannels auf eine Maske der Kanäle fest, nach der das Ladeprogramm suchen soll.

.NETTO:

WinRT:

Win32:

Festlegen des ausführbaren Ordners des Browsers (für lokale Tests)

Ein alternativer Ansatz besteht darin, einen ausführbaren Browserordner zu verwenden. Bei diesem Ansatz geben Sie einen Ordner an, der Laufzeitbinärdateien enthält. Dieser Ordner kann einer der folgenden Speicherorte sein:

  • Der installierte Speicherort der WebView2-Runtime.
  • Ein Vorschaukanal von Microsoft Edge.
  • Ein Ordner mit binärdateien mit fester Version, die Sie selbst auf dem Computer bereitgestellt haben.

Wenn Sie den ausführbaren Browserordner auf einen bestimmten Vorschaukanal von Microsoft Edge festlegen, müssen Sie den Speicherort aktualisieren, wenn dieser Vorschaukanal auf eine neuere Version aktualisiert wird. Dies liegt daran, dass der Speicherort die Versionsnummer als Teil des Pfads enthält. Daher wird empfohlen, diesen Ansatz nur für lokale Tests zu verwenden.

Übergeben Sie den Pfad während der Erstellung der Umgebung mithilfe der folgenden APIs an den ausführbaren Browserordner.

.NET (WPF):

.NET (WinForms):

WinRT:

Win32:

Wenn die neue Runtime abgerufen wird

Wenn Sie eine Umgebungsvariable, einen Registrierungsschlüssel oder eine Gruppenrichtlinie verwenden, werden diese nur auf alle neuen WebView2 Runtime-Browserprozesse angewendet, die erstellt werden. Sie gelten nicht für WebView2 Runtime-Browserprozesse, die bereits ausgeführt werden. Wenn Sie beispielsweise bereits über eine WebView2 mit einem bestimmten Benutzerdatenordner (und damit einem entsprechenden Browserprozess) verfügen und vor dem Versuch, eine neue WebView2 mit demselben Benutzerdatenordner zu erstellen, ändern ChannelSearchKind , wird der vorhandene WebView2 Runtime-Browserprozess verwendet und nicht nach einer anderen Runtime gesucht.

Um sicherzustellen, dass alle Prozesse die Umgebungsvariable, den Registrierungsschlüssel oder die Gruppenrichtlinie verwenden, müssen Sie eine der folgenden Aktionen ausführen:

  • Starten Sie die App neu.
  • Erstellen Sie alle WebView2-Steuerelemente, die einen Benutzerdatenordner gemeinsam nutzen, neu.
  • Erstellen Sie eine neue WebView2, die einen anderen Benutzerdatenordner als alle anderen derzeit ausgeführten WebView2-Steuerelemente enthält.

Festlegen einer Umgebungsvariablen

Sie können mehrere Ansätze verwenden, um Umgebungsvariablen festzulegen:

  • Festlegen von Umgebungsvariablen mithilfe von APIs für eine bestimmte App.
  • Globales Festlegen von Umgebungsvariablen für alle Apps.

Diese Ansätze werden unten beschrieben.

Festlegen von Umgebungsvariablen mithilfe von APIs für eine bestimmte App

Sie können Umgebungsvariablen mithilfe SetEnvironmentVariablevon festlegen. Das Aufrufen dieser Funktion von Ihrer Host-App beschränkt den Bereich der Umgebungsvariablen auf ihre Host-App und die webView2-Steuerelemente, die sie erstellt, und wirkt sich nicht auf andere Apps im System aus.

Globales Festlegen von Umgebungsvariablen für alle Apps

Sie können Umgebungsvariablen über die Windows-Systemoberfläche festlegen. Dieser Ansatz macht den Bereich der Umgebungsvariablen global für den aktuellen Benutzer oder das aktuelle System und wirkt sich auf alle Apps aus, die WebView2-Steuerelemente erstellen.

  1. Geben Sie in der Windows-Suchleiste "Umgebung" ein, und wählen Sie dann Systemumgebungsvariablen bearbeiten aus:

    Verwenden der Windows-Suchleiste, um zu ermitteln, wo Umgebungsvariablen bearbeitet werden sollen

    Das Dialogfeld Systemeigenschaften wird geöffnet.

  2. Wählen Sie die Registerkarte Erweitert aus, und klicken Sie dann auf die Schaltfläche Umgebungsvariablen :

    Schaltfläche

    Das Dialogfeld Umgebungsvariablen wird geöffnet.

  3. Klicken Sie oben im Abschnitt Benutzervariablen auf die Schaltfläche Neu . Das Dialogfeld Neue Benutzervariable wird geöffnet.

  4. Geben Sie im Textfeld Variablenname den Namen der Umgebungsvariablen ein, oder WEBVIEW2_CHANNEL_SEARCH_KINDWEBVIEW2_BROWSER_EXECUTABLE_FOLDER.

  5. Führen Sie im Textfeld Variablenwert eine der folgenden Aktionen aus:

    • Wenn Sie festlegen ChannelSearchKind, geben Sie ein 1 , um die Suchreihenfolge von der Standardeinstellung umzukehren, um zuerst die Vorschaukanäle (Canary, Beta, dann Dev) zu verwenden, gefolgt von der WebView2-Runtime. Ein anderer Wert als 1 bewirkt, dass die Standardsuchreihenfolge verwendet wird (WebView2 Runtime, Edge Dev, Edge Beta und dann Edge Canary).

    • Wenn Sie festlegen, BrowserExecutableFoldergeben Sie den Pfad zu Ihrem bevorzugten Browserkanal oder binärdateien mit fester Version ein.

  6. Klicken Sie auf die Schaltflächen OK , um die Dialogfelder zu schließen.

Bereitstellen von Vorschaukanälen

Führen Sie eine der folgenden Aktionen aus, um die Vorschaukanäle von Microsoft Edge auf mehreren Computern bereitzustellen:

  • Option 1: Manuelles Installieren von Vorschaukanälen auf Computern.

  • Option 2: Programmgesteuertes Bereitstellen von Vorschaukanälen über API-Endpunkte.

Diese Optionen werden unten erläutert.

Option 1: Manuelles Installieren von Vorschaukanälen auf Computern

Vorschaukanäle können manuell (entweder manuell oder über ein bereitgestelltes benutzerdefiniertes Skript) über die folgenden Unternehmenslinks installiert werden:

Kanal Link
Canary Herunterladen
Dev Herunterladen
Beta Herunterladen

Die manuelle Installation muss nur einmal pro Computer erfolgen. Vorabversionskanäle sind evergreen, sodass sie automatisch aktualisiert werden, wenn neuere Versionen verfügbar sind.

Option 2: Programmgesteuertes Bereitstellen von Vorschaukanälen über API-Endpunkte

Schreiben Sie im Code Ihrer App Ihre eigene benutzerdefinierte Logik, um die neueste Version eines Vorschaukanals von Microsoft Edge wie folgt bereitzustellen:

  1. Rufen Sie den folgenden API-Endpunkt auf, der dem Vorschaukanal entspricht, den Sie bereitstellen möchten:

    Kanal Link
    Canary https://edgeupdates.microsoft.com/api/products/canary
    MSI-Link
    Dev https://edgeupdates.microsoft.com/api/products/dev
    Beta https://edgeupdates.microsoft.com/api/products/beta

    Der Canary-Kanal verfügt über einen separaten MSI-Link. Die Dev- und Beta-Kanäle enthalten MSI-Links.

  2. Rufen Sie das neueste Paket auf das Gerät ab.

  3. Installieren Sie das Paket.

Siehe auch