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

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

  • Статья

В этом примере WV2DeploymentWiXBurnBundleSample показано, как использовать пакет записи WiX для развертывания среды выполнения WebView2. Выполните действия, описанные в этой статье, чтобы создать установщик WiX, который устанавливает в цепочке среду выполнения Evergreen WebView2 с помощью burn Bundle.

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

В этом примере создается установщик WiX для примера приложения Win32. В этом примере используется WiX Burn Bundle для установки в цепочке среды выполнения Evergreen WebView2.

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

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

Другой подход, не показанный в этом примере, заключается в упаковке автономного установщика среды выполнения Evergreen WebView2 с приложением. Такой подход очень похож на упаковку начального загрузчика среды выполнения Evergreen WebView2 с приложением.

Общие сведения о подходах см. в статье Развертывание среды выполнения Evergreen WebView2 в разделе Распространение приложения и среды выполнения WebView2.

Шаг 1. Установка Visual Studio

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

Если Visual Studio (минимальная требуемая версия) еще не установлена, с поддержкой C++:

  1. В отдельном окне или на вкладке см . статью Установка Visual Studioстатьи Настройка среды разработки для WebView2. Выполните действия, описанные в этом разделе, чтобы установить Visual Studio, включая поддержку 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 щелкните панель Выход .

  7. Закройте Visual Studio, если она открыта.

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

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

Шаг 5. Создание проекта развертывания

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

    Если неподдерживаемый ... . Откроется диалоговое окно wixproj, установите набор инструментов WiX и расширение набора инструментов WiX выше:

    Сообщение о неподдерживаемых wix-проектах

  2. Этот пример является расширением для примера WV2DeploymentWiXCustomActionSample . В Обозреватель решений разверните узел WV2DeploymentWiXCustomActionSample и дважды щелкните .Product.wxs

  3. В Product.wxsзакомментируйте все <Binary>элементы , <CustomAction>и <Custom> в <!-- Step 4: Config Custom Action to download/install Bootstrapper --> разделе и <!-- Step 5: Config execute sequence of custom action --> , чтобы пользовательское действие не использовалось.

  4. Откройте Bundle.wxs под проектом WV2DeploymentWiXBurnBundleSample . Измените Bundle.wxs в зависимости от того, какой рабочий процесс вы хотите использовать:

    Чтобы упаковать загрузчик среды выполнения Evergreen WebView2 с приложением, выполните следующие действия:

    • Раскомментируйте <ExePackage Id="InvokeBootstrapper" ...> элемент ниже <!-- [Package Bootstrapper] ... -->и закомментируйте другие <ExePackage> элементы.

    Чтобы скачать загрузчик среды выполнения Evergreen WebView2 по ссылке в приложении, выполните следующие действия:

    • Раскомментируйте <ExePackage Id="DownloadAndInvokeBootstrapper" ...> элемент ниже <!-- [Download Bootstrapper] ... -->и закомментируйте другие <ExePackage> элементы.

  5. Если вы упаковали загрузчик evergreen WebView2 Runtime с приложением, скачайте загрузчик и поместите его в включающую SampleApps папку.

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

См. также