Компоненты платформы WebView2

Чтобы добавить WebView2 в приложение, используйте пакет SDK WebView2 на компьютере разработки и распространите среду выполнения WebView2 на пользовательские компьютеры.

Подробное содержание:

Компоненты на компьютере разработчика и пользовательских компьютерах

Чтобы добавить WebView2 в приложение, используйте пакет SDK WebView2 на компьютере разработки и распространите среду выполнения WebView2 на пользовательские компьютеры.

Компоненты WebView2 верхнего уровня

Сокращенный срок Описание
Приложение Любое приложение для любой инфраструктуры или платформы, включающее экземпляр элемента управления WebView2. В приложении могут быть области, использующие экземпляр элемента управления WebView2, и другие области, не использующие элемент управления.
SDK Пакет SDK для WebView2. Если часть вашего приложения использует WebView2, этот код может вызывать эти API в сочетании с экземплярами управления WebView2. Пакет SDK выпуска поставляется пользователям и содержит только стабильные API. Предварительная версия пакета SDK используется только разработчиками и содержит некоторые экспериментальные API.
Control Экземпляр элемента управления WebView2. В приложении обычно отображается прямоугольная область, содержащая веб-содержимое.
Время выполнения Среда выполнения WebView2, представляющая собой движок браузера. Устанавливается на компьютерах пользователей, а также на компьютерах для разработки и тестирования.
Канал предварительных версий Канал предварительных версий Microsoft Edge: бета-версия (почти стабильный), Dev или Canary (самая последняя сборка; ежедневно). Только для компьютеров разработки и тестирования, но не для пользовательских компьютеров.

Элемент управления WebView2, пакет SDK и среда выполнения

Элемент управления WebView2, SDK WebView2 и среда выполнения WebView2 имеют следующие роли:

Компонент Role
WebView2 SDK Предоставляет API для разработчиков, которые они могут использовать в коде приложения. Используется разработчиком локально во время написания кода приложения. Две версии: предварительная версия пакета SDK для локального тестирования в целях разработки и предварительная версия пакета SDK для разработки доступного кода пользователям.
Элемент управления WebView2 Вы внедряете элемент управления WebView2 в приложение. Хост среды выполнения; служит видимой областью для отображения веб-содержимого.
Среда выполнения WebView2 На тестовом компьютере разработчика и на компьютерах пользователей. Или вместо использования среды выполнения разработчики могут использовать канал предварительных версий Microsoft Edge для локального тестирования при использовании предварительной версии пакета SDK.

Схема компонентов WebView2 высокого уровня

На следующей схеме показаны компоненты WebView2 высокого уровня на компьютере разработки и пользовательских компьютерах:

Приложение на компьютере разработки и компьютере пользователя

Компьютер разработчика

В этом разделе поясняется левый столбец приведенной выше схемы.

Компьютер разработчика для разработки приложения WebView2 состоит из следующих компонентов:

  • Проект Visual Studio — используйте шаблон проекта Visual Studio для создания стандартного приложения платформы, а затем добавьте пакет SDK WebView2 в проект в виде пакета NuGet.

    • Конструктор макетов — компоновка элементов управления в Visual Studio.

      • Экземпляры управления WebView2 — области веб-содержимого вашего приложения. Веб-код приложения выполняется в этом элементе управления.

      • Собственные экземпляры элементов управления — собственные элементы управления и панели вашего приложения.

    • Пакет SDK для WebView2.

      • API WebView2 для конкретных платформ, включая CoreWebView2, CoreWebView2Controllerи CoreWebView2Environment. В основном вызывается нативным кодом.

      • AddHostObjectToScript - Позволяет предоставлять API платформы и API WebView2 коду JavaScript. Взаимодействие машинного и веб-кода

      • API JavaScript (пакет WebView2Script) — вызывается веб-кодом для взаимодействия с ведущим приложением.

    • API платформы — API, не относящиеся к WebView2, предоставляемые веб-платформой; Используется веб-кодом.

  • Среда выполнения WebView2 — компонент браузера Microsoft Edge, содержащий API WebView2 и выполняющий веб-код.

Компьютер пользователя

В этом разделе поясняется правый столбец приведенной выше схемы.

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

  • Ведущее приложение, которое установил и использует пользователь.

    • Собственный код WebView2: ваш собственный код, использующий API WebView2.

    • Веб-код: веб-код, выполняемый в экземпляре элемента управления WebView2.

    • Экземпляры управления WebView2: веб-код приложения WebView2 выполняется в элементе управления WebView2.

    • Машинный код, отличный от WebView2.

    • Веб-код, не относящийся к WebView2.

    • Собственные управляющие экземпляры.

  • Среда выполнения WebView2.

Предварительная версия пакета SDK с предварительной средой выполнения или предварительная версия пакета SDK со стабильной средой выполнения

Вы можете использовать любое из их сочетания:

  • Предварительная версия пакета SDK WebView2 вместе с каналом предварительной версии Microsoft Edge (бета-версия, версия для разработчиков или Canary), который включает среду выполнения предварительной версии WebView2.
  • Пакет SDK для выпуска WebView2 вместе со средой выполнения WebView2.
Тип пакета SDK WebView2 Платформа для рендеринга Сценарий
Предварительная версия пакета SDK Предварительная среда выполнения WebView2, включенная в канал предварительных версий Microsoft Edge (бета-версия, разработка или Canary) Для экспериментов и тестирования приложения на основе предстоящих изменений на компьютерах разработчика.
Release SDK Стабильная среда выполнения WebView2 Для доставки приложения пользователям.

Элемент управления WebView2, среда выполнения и пакет SDK

На этой схеме показан следующий контур:

Предварительная версия SDK WebView2:

  • API .NET/C#, включая экспериментальные API.
  • API WinRT/C#, включая экспериментальные API.
  • API Win32/C++, включая экспериментальные API.
  • Пакет WebView2Script (API JavaScript).

Предварительная версия пакета SDK использует канал предварительной версии Microsoft Edge, который включает:

  • Среда выполнения предварительной версии WebView2.
  • Пакет WebView2Script (API JavaScript).

SDK выпуска WebView2:

  • API .NET/C#.
  • WinRT/C#.
  • Win32/C++.
  • Пакет WebView2Script (API JavaScript).

Пакет SDK для выпуска использует среду выполнения WebView2 (среда выполнения WebView2 Stable).

  • Среда выполнения включает пакет WebView2Script (API JavaScript).

Вы периодически скачиваете последнюю версию пакета SDK из NuGet. Ссылки NuGet находятся в заметках о выпуске SDK WebView2.

SDK включает JavaScript API, который находится в пакете WebView2Script .

См. также:

Использование предварительной версии пакета SDK и экспериментальных API-интерфейсов с каналом предварительных версий Microsoft Edge

Чтобы разработать предварительную версию приложения с использованием экспериментальных API-интерфейсов или протестировать приложение на предстоящие изменения пакета SDK, выполните следующие действия.

  • На компьютере разработчика в проекте Visual Studio установите предварительную версию Microsoft.Web.WebView2 пакета NuGet пакета SDK. Пишите код, использующий экспериментальные API (и стабильные API).
  • На компьютере разработчика установите и используйте канал предварительных версий Microsoft Edge.

Чтобы распространить предварительную версию приложения на тестовый компьютер, выполните следующие действия.

  • На тестовом компьютере установите канал предварительных версий Microsoft Edge.

См. также:

Использование пакета SDK для выпуска и стабильных API со средой выполнения

Разработка бесплатной версии приложения:

  • На компьютере разработчика в проекте Visual Studio установите версиюMicrosoft.Web.WebView2 выпуска пакета NuGet пакета SDK. Пишите код, использующий только стабильные API.
  • На компьютере разработчика используйте среду выполнения WebView2 (часть пакета SDK).

Среда выполнения WebView2 — это как движок браузера, который можно использовать в качестве компонента приложения.

Существует несколько способов распространения приложения и среды выполнения среди пользователей. См . раздел "Способы распространения, установки и обновления среды выполнения на компьютере пользователя " выше.

См. также:

Проектирование архитектуры приложения WebView2

Ведущее приложение содержит перечисленные ниже категории компонентов.

  • Собственные управляющие экземпляры.
  • Экземпляры управления WebView2.

Ведущее приложение также содержит следующие категории кода:

  • Собственный код, вызывающий API собственной платформы.
  • Машинный код, вызывающий API WebView2.
  • Веб-код (JavaScript), вызывающий API WebView2Script, открытые собственные API и API веб-платформы.

Проектирование архитектуры приложения WebView2

Способы распространения, установки и обновления среды выполнения на компьютере пользователя

Существует несколько способов распространения среды выполнения WebView2 вместе с вашим приложением.

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

Название метода распространения Описание Примечания
Ссылка на загрузчик актуальной среды выполнения В установщике приложения создайте ссылку на загрузчик актуальной среды выполнения. Установщик приложения должен использовать эту ссылку, чтобы программно скачать и установить начальный загрузчик актуальной версии на компьютер пользователя. Затем вызовите начальный загрузчик, чтобы установить соответствующую среду выполнения для устройства пользователя. Для пользователей, которые подключены к Интернету. Начальный загрузчик актуальной версии — это небольшой установщик, устанавливающий подходящую среду выполнения для процессора пользователя, используя подключение к Интернету.
Упаковка начального загрузчика актуальной среды выполнения Загрузите начальный загрузчик актуальной версии на компьютер для разработчиков. Упакуйте и распространите начальный загрузчик актуальной версии с помощью установщика приложений. Затем установщик приложения вызывает начальный загрузчик для установки среды выполнения на компьютере пользователя. Для пользователей, у которых нет надежного подключения к сайту CDN начального загрузки.
Упаковка установщика изолированной актуальной среды выполнения Скачайте автономный установщик актуальной версии на свой компьютер для разработчиков и упакуйте его вместе с приложением. Упакуйте установщик изолированной актуальной версии в установщик приложения. Затем установщик приложения вызывает автономный установщик актуальной версии для установки среды выполнения на устройстве пользователя. Для пользователей, не имеющих подключения к сети. Большой автономный установщик актуальной среды выполнения для автономных пользователей, включающий актуальную среду выполнения.
Упаковка неизменяемой версии среды выполнения Загрузите на компьютер разработчика среду выполнения для конкретной версии и ЦП. Упакуйте и распространите неизменяемую версию среды выполнения с помощью установщика приложения. Установщик приложения устанавливает определенную фиксированную версию среды выполнения на компьютере пользователя. Специальный случай, когда вам нужна конкретная версия API; Избегает проверки доступности последних API.

Указанные выше подходы перечислены в той же последовательности, что и в разделе " Скачивание среды выполнения WebView2 " на странице Microsoft Edge WebView2 , от упрощенного до тяжеловесного подходов. Отдавайте предпочтение легким подходам; Используйте тяжеловесный подход, если этого требует специализированный сценарий.

Установщик приложения — это установщик или средство обновления приложения, которое может быть отдельным от приложения или частью приложения.

См. также:

Связь с HTTP-сервером

Элемент управления WebView2 выступает в качестве посредника для обмена данными между ведущим приложением и HTTP-сервером.

Ведущее приложение, элемент управления WebView2 и HTTP-сервер

См. также

developer.microsoft.com:

  • Microsoft Edge WebView2 — начальное знакомство с функциями WebView2 на developer.microsoft.com.

Ресурсы для разработки приложений WebView2:

  • Последнее обновление: