Поделиться через

Пользовательское действие WiX для развертывания среды выполнения WebView2

  • Статья

В этом примере WV2DeploymentWiXCustomActionSample показано, как использовать настраиваемое действие WiX для развертывания среды выполнения WebView2.

  • Имя примера: WV2DeploymentWiXCustomActionSample
  • Каталог репозитория: WV2DeploymentWiXCustomActionSample
  • Файл проекта: WV2DeploymentWiXCustomActionSample.wixproj

Чтобы помочь вам понять, как развернуть среду выполнения Evergreen WebView2 с приложением, в этом примере создается установщик WiX для WebView2APISample и используется пользовательское действие WiX для цепочки установки evergreen WebView2 Runtime.

В этом примере демонстрируется несколько различных подходов к развертыванию:

  • Скачивание начального загрузчика среды выполнения Evergreen WebView2 по ссылке.
  • Упаковка загрузчика среды выполнения Evergreen WebView2 с приложением.
  • Упаковка автономного установщика среды выполнения Evergreen WebView2 с приложением.

Шаг 1. Установка Visual Studio 2019 с поддержкой C++

Требуется Microsoft Visual Studio. Microsoft Visual Studio Code не поддерживается в этом примере.

  1. Visual Studio . Если установка Visual Studio 2019 (минимальная требуемая версия) с поддержкой C++ еще не установлена, в отдельном окне или на вкладке см. статью Установка Visual Studioстатьи Настройка среды разработки для WebView2. Выполните действия, описанные в этом разделе, чтобы установить Visual Studio 2019 с поддержкой C++, а затем вернитесь на эту страницу и выполните следующие действия.

Шаг 2. Установка средств сборки набора инструментов WiX

Если это еще не сделано, установите набор инструментов WiX:

  1. В новом окне или вкладке перейдите в раздел Набор инструментов WiX , а затем скачайте средства сборки набора инструментов WiX.

  2. wixnnn.exe Щелкните файл и нажмите кнопку Открыть файл.

    Может открыться диалоговое окно " Требуется включить платформа .NET Framework 3.5.1:

    Диалоговое окно

    Если платформа .NET Framework 3.5.1 уже включен на вашем компьютере, перейдите к продолжению установки этого компонента WiX.

  3. Нажмите кнопку ОК . Окно установщика WiX закрывается.

  4. Нажмите клавишу с логотипом WindowsКлавиша с логотипом Windows, введитекомпоненты Windows, а затем нажмите клавишу ВВОД. Откроется диалоговое окно Включение и отключение компонентов Windows .

  5. Выберите проверка платформа .NET Framework 3.5 (включая .NET 2.0 и 3.0):

    Включение и отключение > функций Windows платформа .NET Framework 3.5

    Вам не нужно выбирать дочерние элементы.

  6. Нажмите кнопку OK. Вам может быть предложено разрешить клиентский компонент Центра обновления Windows скачивать файлы.

    Дополнительные сведения см. в статье Установка платформа .NET Framework 3.5 на Windows 11, Windows 10, Windows 8.1 и Windows 8.

  7. После включения платформа .NET Framework 3.5.1 снова запустите wixnnn.exe файл. Например, в Microsoft Edge щелкните Параметры и многое другое, нажмите кнопку Загрузки, а затем — Открыть файл под .wix311.exe

  8. Щелкните панель Установка установщика WiX.

  9. В разделе Контроль учетных записей пользователей нажмите кнопку Да . В верхней части установщика WiX сказано сообщение "Успешно установлен".

Также установите компонент WiX Visual Studio в следующем разделе.

Шаг 3. Установка расширения Visual Studio Для набора инструментов WiX

Если это еще не сделано, установите расширение WiX Toolset Visual Studio 2019:

  1. В новом окне или вкладке перейдите к набору инструментов WiX , а затем скачайте и установите расширение:

    • Расширение набора инструментов WiX Visual Studio 2019 — скачанный файл установщика: Votive2019.vsix

  2. В разделе Контроль учетных записей пользователей нажмите кнопку Да . Откроется расширение VSIX Installer для WiX Visual Studio:

    Расширение VSIX Installer для WiX Visual Studio 2019

  3. Нажмите кнопку Установить .

  4. Если откроется диалоговое окно VSIX, ожидая завершения работы процессов , закройте Visual Studio. Установщик VSIX продолжит работу.

    В установщике VSIX сказано, как установить завершено:

    Установщик VSIX — установка завершена — расширение Набора инструментов WiX Visual Studio 2019

  5. В установщике VSIX нажмите кнопку Закрыть .

  6. В установщике WiX щелкните панель Выход .

Шаг 4. Клонирование репозитория WebView2Samples

  1. Если это еще не сделано, клонируйте репозиторий на WebView2Samples локальный диск. В отдельном окне или вкладке см. статью Клонирование репозитория WebView2Samplesстатьи Настройка среды разработки для WebView2. Выполните действия, описанные в этом разделе, а затем вернитесь на эту страницу и продолжите работу ниже.

Шаг 5. Открытие решения в Visual Studio

  1. В локальной копии репозитория WebView2Samples откройте <repo-location>\WebView2Samples\SampleApps\WebView2Samples.sln в Visual Studio (не Visual Studio Code).

Шаг 6. Изменение Product.wxs для настройки распространения среды выполнения WebView2

  1. Откройте Product.wxs под проектом WV2DeploymentWiXCustomActionSample .

  2. Измените Product.wxs в зависимости от того, какой подход вы хотите использовать:

Если вы хотите, чтобы приложение скачать загрузчик среды выполнения Evergreen WebView2 (MicrosoftEdgeWebview2Setup.exe) по ссылке:

  1. В <!-- Step 4: Config Custom Action to download/install Bootstrapper -->разделе раскомментируйте <CustomAction Id='DownloadAndInvokeBootstrapper' ...> элемент под <!-- [Download Bootstrapper] ... -->.

  2. Закомментируйте другие <Binary> элементы и <CustomAction> в разделе Step 4.

  3. В <!-- Step 5: Config execute sequence of custom action -->разделе раскомментируйте <Custom Action='DownloadAndInvokeBootstrapper' ...> элемент под <!-- [Download Bootstrapper] ...-->.

  4. Закомментируйте другие <Custom> элементы в разделе Step 5.

Подход 2. Упаковка загрузчика среды выполнения Evergreen WebView2 с приложением

Если вы хотите упаковать загрузчик среды выполнения Evergreen WebView2 (MicrosoftEdgeWebview2Setup.exe) с приложением:

  1. В разделе <!-- Step 4: Config Custom Action to download/install Bootstrapper -->раскомментируйте <Binary Id="MicrosoftEdgeWebview2Setup.exe" ...> элементы и <CustomAction Id='InvokeBootstrapper' ...> под <!-- [Package Bootstrapper] ... -->.

  2. Закомментируйте другие <Binary> элементы и <CustomAction> в разделе Step 4.

  3. В <!-- Step 5: Config execute sequence of custom action -->разделе раскомментируйте <Custom Action='InvokeBootstrapper' ...> элемент под <!-- [Package Bootstrapper] ...-->.

  4. Закомментируйте другие <Custom> элементы в разделе Step 5.

Подход 3. Упаковка автономного установщика среды выполнения Evergreen WebView2 с приложением

Если вы хотите упаковать автономный установщик среды выполнения Evergreen WebView2 с приложением:

  1. В разделе <!-- Step 4: Config Custom Action to download/install Bootstrapper -->раскомментируйте <Binary Id="MicrosoftEdgeWebView2RuntimeInstallerX64.exe" ...> элементы и <CustomAction Id='InvokeStandalone' ...> под <!-- [Package Standalone Installer] ... -->.

  2. Закомментируйте другие <Binary> элементы и <CustomAction> в разделе Step 4.

  3. Если вы используете устройства, отличные от X64, вам также может потребоваться изменить MicrosoftEdgeWebView2RuntimeInstallerX64 имя файла в соответствии с правильной архитектурой.

  4. В <!-- Step 5: Config execute sequence of custom action -->разделе раскомментируйте <Custom Action='InvokeStandalone' ...> элемент под <!-- [Package Standalone Installer] ...-->.

  5. Закомментируйте другие <Custom> элементы в разделе Step 5.

Шаг 7. Размещение начального загрузчика или установщика в папке

Если вы планируете упаковать загрузчик (подход 2) или автономный установщик (подход 3) с приложением:

  1. Скачайте загрузчик или автономный установщик. В Microsoft Edge WebView2 нажмите кнопку Скачать сейчас, чтобы прокрутить вниз до раздела Скачать среду выполнения WebView2 .

  2. Поместите скачанный загрузчик или автономный установщик в включающую SampleApps папку.

Шаг 8. Создание проекта установщика

  1. Выполните сборку WV2DeploymentVSInstallerSample проекта.

См. также