Заметки о выпуске для SDK WebView2

Заметки о выпуске для последних пакетов SDK:

Заметки о более ранних выпусках см. в разделе «Архив» в оглавлении.

Список пакетов SDK Microsoft.Web.WebView2 можно просмотреть на сайте NuGet.

Как правило, заметки о выпуске применяются на поддерживаемых платформах, перечисленных в справочнике по API WebView2. Обзор API, которые находятся в пакетах Release SDK, см. в разделе Обзор API WebView2.

Записи заметок о выпуске соответствуют историческим выпускам WebView2 и не обновляются с течением времени. Ссылки на "новые функции" и "экспериментальные API" могут устаревать по мере выпуска новых версий WebView2.

Частота выпусков

Пакеты SDK WebView2 и предварительная версия SDK WebView2 выпускаются при наличии исправлений ошибок, исправлений безопасности, новых API-интерфейсов или функций либо других изменений пакета SDK, которые требуют выпуска.

При публикации пакета SDK WebView2 он согласуется с соответствующей версией среды выполнения WebView2.

Этапы добавления API

Новые API добавляются в три этапа, а именно:

  1. Изначально API представлены как экспериментальные API в пакете предварительной версии пакета SDK. В Win32 имя типа включает слово "Экспериментальный".

    • Иногда API пропускают экспериментальную фазу и добавляются непосредственно в стабильный выпуск SDK.
  2. Затем API становятся стабильными API в пакете предварительной версии SDK. В Win32 в названии типа опущено слово "Экспериментальный".

  3. Вскоре после этого API становятся стабильными API в пакете Release SDK.

    • Иногда API одновременно повышаются до уровня "Стабильный" в предварительной версии SDK и до стабильного в версии SDK.

Схема этапов внедрения новых API

Сокращенные названия этапов:

  1. Экспериментальные возможности в предварительной версии
  2. Stable в предварительной версии
  3. Стабильный в выпуске

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

  • Следующие API находятся в фазе 1: Экспериментальные в предварительной версии и были добавлены в этот предварительный выпуск SDK.

  • Следующие API были переведены с фазы 1: экспериментальная в предварительной версии до фазы 2: стабильная в предварительной версии, и включены в этот предварительный пакет SDK.

  • Перечисленные ниже интерфейсы API были переведены из фазы 2 (стабильная в предварительной версии) в фазу 3: стабильная в выпуске и теперь включены в этот пакет SDK.

См. также:

Обязательно перекомпилируйте приложение WebView2 после обновления пакета NuGet SDK WebView2. Команда WebView2 рекомендует следующее:

  • Используйте канал предварительной версии Canary в Microsoft Edge при разработке с использованием предварительной версии пакета SDK WebView2. Canary является рекомендуемым каналом для предварительного просмотра, так как он поставляется быстрее всего и имеет новейшие API.

  • Используйте актуальную среду выполнения WebView2 при использовании версии выпуска пакета SDK WebView2.

Дополнительные сведения см. в разделе Сопоставление версии среды выполнения с версией пакета SDK в статьях Предварительная версия и пакеты SDK для выпуска WebView2.

Обновление пакета SDK

Изменения WebView2 могут потребовать обновления среды выполнения, пакета SDK или и того, и другого. Для большинства новых API требуются обновления как среды выполнения, так и пакета SDK.

Инструкции по установке или обновлению пакета SDK для WebView2 см. в статье "Установка или обновление пакета SDK WebView2 " в статье "Настройка среды разработчика для WebView2".

См. также:

Минимальная версия браузера или среды выполнения для загрузки WebView2

Для загрузки WebView2 минимальная версия Microsoft Edge или среда выполнения WebView2 — 86.0.616.0; см. раздел Runtime 86.0.705.50 (25 января 2021 г.). Минимальная версия для загрузки WebView2 изменяется только тогда, когда на веб-платформе происходит критическое изменение.

Сведения об использовании предварительной версии пакета SDK вместе с каналом предварительной версии Microsoft Edge см. в статье Переключение на канал предварительных версий для тестирования будущих API и функций.

См. также