Benutzerdefinierte WiX-Aktion zum Bereitstellen der WebView2-Runtime

In diesem Beispiel, WV2DeploymentWiXCustomActionSample, wird veranschaulicht, wie Eine benutzerdefinierte WiX-Aktion zum Bereitstellen der WebView2-Runtime verwendet wird.

• Beispielname: WV2DeploymentWiXCustomActionSample
• Repositoryverzeichnis: WV2DeploymentWiXCustomActionSample
• Projektdatei: WV2DeploymentWiXCustomActionSample.wixproj

Damit Sie verstehen können, wie Sie die Evergreen WebView2 Runtime mit Ihrer App bereitstellen, erstellt dieses Beispiel ein WiX-Installationsprogramm für WebView2APISample und verwendet eine benutzerdefinierte WiX-Aktion , um die Evergreen WebView2 Runtime zu verketten.

In diesem Beispiel werden verschiedene Bereitstellungsansätze veranschaulicht:

• Herunterladen des Evergreen WebView2 Runtime Bootstrappers über einen Link.
• Packen des Evergreen WebView2 Runtime Bootstrappers mit Ihrer App
• Packen des eigenständigen Installers für Evergreen WebView2 Runtime mit Ihrer App

Schritt 1: Installieren von Visual Studio 2019 mit C++-Unterstützung

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

1. Visual Studio : Wenn Die Installation von Visual Studio 2019 (erforderliche Mindestversion) mit C++-Unterstützung noch nicht installiert ist, 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 2019 mit 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 .

Schritt 4: Klonen des WebView2Samples-Repositorys

1. Falls noch nicht geschehen, klonen Sie das WebView2Samples Repository auf Ihr lokales Laufwerk. In einem separaten Fenster oder einer separaten Registerkarte finden Sie weitere Informationen unter Klonen 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: Öffnen der Projektmappe in Visual Studio

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

Schritt 6: Bearbeiten von "Product.wxs" zum Konfigurieren der Verteilung der WebView2-Runtime

1. Öffnen Sie Product.wxs unter dem WV2DeploymentWiXCustomActionSample Projekt.

2. Bearbeiten Sie Product.wxs abhängig von dem ansatz, den Sie verwenden möchten:

Ansatz 1: Herunterladen des Evergreen WebView2 Runtime Bootstrappers über einen Link

Wenn Die App den Evergreen WebView2 Runtime Bootstrapper (MicrosoftEdgeWebview2Setup.exe) über einen Link herunterladen soll:

1. Heben Sie unter <!-- Step 4: Config Custom Action to download/install Bootstrapper -->die Auskommentierung des <CustomAction Id='DownloadAndInvokeBootstrapper' ...> Elements unter auf <!-- [Download Bootstrapper] ... -->.

2. Kommentieren Sie andere <Binary> - und <CustomAction> -Elemente unter Step 4aus.

3. Heben Sie unter <!-- Step 5: Config execute sequence of custom action -->die Auskommentierung des <Custom Action='DownloadAndInvokeBootstrapper' ...> Elements unter auf <!-- [Download Bootstrapper] ...-->.

4. Kommentieren Sie andere <Custom> Elemente unter Step 5aus.

Ansatz 2: Packen des Evergreen WebView2 Runtime Bootstrappers mit der App

Wenn Sie den Evergreen WebView2 Runtime Bootstrapper (MicrosoftEdgeWebview2Setup.exe) mit der App packen möchten:

1. Heben Sie unter <!-- Step 4: Config Custom Action to download/install Bootstrapper -->die Auskommentierung der <Binary Id="MicrosoftEdgeWebview2Setup.exe" ...> Elemente und <CustomAction Id='InvokeBootstrapper' ...> unter <!-- [Package Bootstrapper] ... -->auf.

2. Kommentieren Sie andere <Binary> - und <CustomAction> -Elemente unter Step 4aus.

3. Heben Sie unter <!-- Step 5: Config execute sequence of custom action -->die Auskommentierung des <Custom Action='InvokeBootstrapper' ...> Elements unter auf <!-- [Package Bootstrapper] ...-->.

4. Kommentieren Sie andere <Custom> Elemente unter Step 5aus.

Ansatz 3: Packen des eigenständigen Installers für Evergreen WebView2 Runtime mit Ihrer App

Wenn Sie den eigenständigen Installer für evergreen WebView2 Runtime mit der App packen möchten:

1. Heben Sie unter <!-- Step 4: Config Custom Action to download/install Bootstrapper -->die Auskommentierung der <Binary Id="MicrosoftEdgeWebView2RuntimeInstallerX64.exe" ...> Elemente und <CustomAction Id='InvokeStandalone' ...> unter <!-- [Package Standalone Installer] ... -->auf.

2. Kommentieren Sie andere <Binary> - und <CustomAction> -Elemente unter Step 4aus.

3. Wenn Sie Nicht-X64-Geräte als Ziel verwenden, können Sie auch den MicrosoftEdgeWebView2RuntimeInstallerX64 Dateinamen bearbeiten, um die richtige Architektur widerzuspiegeln.

4. Heben Sie unter <!-- Step 5: Config execute sequence of custom action -->die Auskommentierung des <Custom Action='InvokeStandalone' ...> Elements unter auf <!-- [Package Standalone Installer] ...-->.

5. Kommentieren Sie andere <Custom> Elemente unter Step 5aus.

Schritt 7: Legen Sie bootstrapper oder installer in den Ordner

Wenn Sie planen, entweder den Bootstrapper (Ansatz 2) oder den eigenständigen Installer (Ansatz 3) mit der App zu packen:

1. Laden Sie den Bootstrapper oder den eigenständigen Installer herunter. Klicken Sie in Microsoft Edge WebView2 auf Jetzt herunterladen, um zum Abschnitt Herunterladen der WebView2-Runtime zu scrollen.

2. Platzieren Sie den heruntergeladenen Bootstrapper oder den eigenständigen Installer unter dem einschließenden SampleApps Ordner.

Schritt 8: Erstellen des Installationsprojekts

1. Erstellen Sie das WV2DeploymentVSInstallerSample Projekt.

Siehe auch

• Win32-Beispiel-App
• Bereitstellen der Evergreen WebView2-Runtime in Verteilen Ihrer App und der WebView2-Runtime.
• Infodatei für WV2DeploymentWiXCustomActionSample.
• WiX-Toolset
• Hinzufügen einer benutzerdefinierten Aktion in WiX >