WiX Burn Bundle zum Bereitstellen der WebView2-Runtime

In diesem Beispiel, WV2DeploymentWiXBurnBundleSample, wird veranschaulicht, wie Sie ein WiX Burn Bundle zum Bereitstellen der WebView2-Runtime verwenden. Führen Sie die Schritte in diesem Artikel aus, um ein WiX-Installationsprogramm zu erstellen, das die Evergreen WebView2 Runtime über Burn Bundle verkettet.

• Beispielname: WV2DeploymentWiXBurnBundleSample
• Repositoryverzeichnis: WV2DeploymentWiXBurnBundleSample
• Projektdatei: WV2DeploymentWiXBurnBundleSample.wixproj

In diesem Beispiel wird ein WiX-Installationsprogramm für die Win32-Beispiel-App erstellt. In diesem Beispiel wird WiX Burn Bundle verwendet, um die Evergreen WebView2 Runtime zu verketten.

In diesem Beispiel werden diese beiden verschiedenen Verteilungsansätze zum Verteilen der WebView2-Runtime für Ihre App veranschaulicht:

• Herunterladen des Evergreen WebView2 Runtime Bootstrappers über einen in Ihrer App gespeicherten Link.
• Packen des Evergreen WebView2 Runtime Bootstrappers mit Ihrer App

Der andere Ansatz, der in diesem Beispiel nicht veranschaulicht wird, besteht darin, den eigenständigen Installer für Evergreen WebView2 Runtime mit Ihrer App zu packen. Dieser Ansatz ähnelt dem Packen des Evergreen WebView2 Runtime Bootstrappers mit Ihrer App.

Eine Übersicht über die Ansätze finden Sie unter Deploying the Evergreen WebView2 Runtime in Distribute your app and the WebView2 Runtime.

Schritt 1: Installieren von Visual Studio

Microsoft Visual Studio ist erforderlich. Microsoft Visual Studio Code wird für dieses Beispiel nicht unterstützt.

Wenn Visual Studio (erforderliche Mindestversion) noch nicht installiert ist, mit C++-Unterstützung:

1. In einem separaten Fenster oder einer separaten Registerkarte finden Sie weitere Informationen unter Installieren von Visual Studio unter Einrichten Ihrer Entwicklungsumgebung für WebView2. Führen Sie die Schritte in diesem Abschnitt aus, um Visual Studio einschließlich C++-Unterstützung zu installieren.

Kehren Sie dann zu dieser Seite zurück, und fahren Sie mit den folgenden Schritten fort.

Schritt 2: Installieren von WiX Toolset-Buildtools

Wenn dies noch nicht geschehen ist, installieren Sie das WiX-Toolset:

1. Wechseln Sie in einem neuen Fenster oder einer neuen Registerkarte zu WiX-Toolset , und laden Sie dann die WiX-Toolset-Buildtools herunter.

2. Klicken Sie auf die wixnnn.exe Datei und dann auf Datei öffnen.

   Möglicherweise wird ein Dialogfeld geöffnet, .NET Framework 3.5.1 muss aktiviert sein:

   

   Wenn .NET Framework 3.5.1 bereits auf Ihrem Computer aktiviert ist, fahren Sie mit der Installation dieser WiX-Komponente fort.

3. Klicken Sie auf die Schaltfläche OK . Das Fenster des WiX-Installationsprogramms wird geschlossen.

4. Drücken Sie die Windows-Logo-Taste, geben Sie Windows-Features ein, und drücken Sie dann die EINGABETASTE. Das Dialogfeld Windows-Features aktivieren oder deaktivieren wird angezeigt.

5. Aktivieren Sie das Kontrollkästchen .NET Framework 3.5 (enthält .NET 2.0 und 3.0):

   

   Sie müssen die untergeordneten Elemente nicht auswählen.

6. Klicken Sie auf OK. Möglicherweise werden Sie aufgefordert, Windows Update Dateien herunterladen zu lassen.

   Weitere Informationen finden Sie unter Installieren des .NET Framework 3.5 auf Windows 11, Windows 10, Windows 8.1 und Windows 8.

7. Nachdem .NET Framework 3.5.1 aktiviert wurde, führen Sie die wixnnn.exe Datei erneut aus. Klicken Sie beispielsweise in Microsoft Edge auf Einstellungen und mehr, klicken Sie auf Downloads, und klicken Sie dann unter wix311.exeauf Datei öffnen.

8. Klicken Sie im WiX-Installationsprogramm auf den Bereich Installieren .

9. Klicken Sie unter Benutzerkontensteuerung auf die Schaltfläche Ja . Oben im WiX-Installationsprogramm wird "Erfolgreich installiert" angezeigt.

Installieren Sie auch die WiX Visual Studio-Komponente gemäß dem nächsten Abschnitt.

Schritt 3: Installieren der WiX-Toolset-Visual Studio-Erweiterung

Wenn dies noch nicht geschehen ist, installieren Sie die WiX-Toolset-Visual Studio 2019-Erweiterung:

1. Wechseln Sie in einem neuen Fenster oder einer neuen Registerkarte zum WiX-Toolset , und laden Sie die Erweiterung herunter, und installieren Sie sie:

   • WiX-Toolset Visual Studio 2019-Erweiterung – heruntergeladene Installationsdatei: Votive2019.vsix

2. Klicken Sie unter Benutzerkontensteuerung auf die Schaltfläche Ja . VsIX-Installer für WiX Visual Studio-Erweiterung wird geöffnet:

   

3. Klicken Sie auf die Schaltfläche Installieren .

4. Wenn ein VSIX-Dialogfeld geöffnet wird, das auf das Herunterfahren von Prozessen wartet , schließen Sie Visual Studio. Der VSIX-Installer wird fortgesetzt.

   Der VSIX-Installer liest Installation abgeschlossen:

   

5. Klicken Sie im VSIX-Installer auf die Schaltfläche Schließen .

6. Klicken Sie im WiX-Installationsprogramm auf den Bereich Beenden .

7. Schließen Sie Visual Studio, wenn es geöffnet ist.

Schritt 4: Klonen oder Herunterladen des WebView2Samples-Repositorys

1. Falls noch nicht geschehen, klonen Sie das Repository, oder laden Sie es WebView2Samples auf Ihr lokales Laufwerk herunter. In einem separaten Fenster oder einer separaten Registerkarte finden Sie weitere Informationen unter Herunterladen des WebView2Samples-Repositorys unter Einrichten Ihrer Entwicklungsumgebung für WebView2. Führen Sie die Schritte in diesem Abschnitt aus, kehren Sie dann zu dieser Seite zurück, und fahren Sie weiter unten fort.

Schritt 5: Erstellen des Bereitstellungsprojekts

1. Öffnen <repo-location>\WebView2Samples\SampleApps\WebView2Samples.sln Sie in Ihrer lokalen Kopie des WebView2Samples-Repositorys mit Visual Studio (nicht Visual Studio Code).

   Wenn der nicht unterstützte ... . Das Dialogfeld wixproj wird angezeigt. Installieren Sie oben das WiX-Toolset und die WiX-Toolset-Erweiterung:

   

2. Dieses Beispiel ist eine Erweiterung des WV2DeploymentWiXCustomActionSample-Beispiels . Erweitern Sie Projektmappen-Explorer WV2DeploymentWiXCustomActionSample, und doppelklicken Sie dann auf Product.wxs.

3. Kommentieren Product.wxsSie in alle <Binary>Elemente , <CustomAction>und <Custom> unter <!-- Step 4: Config Custom Action to download/install Bootstrapper --> und <!-- Step 5: Config execute sequence of custom action --> aus, sodass keine benutzerdefinierte Aktion verwendet wird.

4. Öffnen Sie Bundle.wxs unter dem WV2DeploymentWiXBurnBundleSample Projekt. Bearbeiten Sie Bundle.wxs je nach workflow, den Sie verwenden möchten:

   So packen Sie den Evergreen WebView2 Runtime Bootstrapper mit Ihrer App

   • Heben Sie die Auskommentierung des <ExePackage Id="InvokeBootstrapper" ...> Elements unter <!-- [Package Bootstrapper] ... -->auf, und kommentieren Sie andere <ExePackage> Elemente aus.

   So laden Sie den Evergreen WebView2 Runtime Bootstrapper über einen Link in Ihrer App herunter:

   • Heben Sie die Auskommentierung des <ExePackage Id="DownloadAndInvokeBootstrapper" ...> Elements unter <!-- [Download Bootstrapper] ... -->auf, und kommentieren Sie andere <ExePackage> Elemente aus.

5. Wenn Sie den Evergreen WebView2 Runtime Bootstrapper mit Ihrer App packen, laden Sie den Bootstrapper herunter, und platzieren Sie ihn im einschließenden SampleApps Ordner.

6. Erstellen Sie das WV2DeploymentWiXBurnBundleSample Projekt.

Siehe auch

• Bereitstellen der Evergreen WebView2-Runtime in Verteilen Ihrer App und der WebView2-Runtime.