Пакеты SDK для предварительного выпуска и выпуска для WebView2

SDK WebView2 предоставляется в виде предварительной или предварительной версии пакета NuGet Microsoft.Web.WebView2 . Используйте пакет SDK для предварительной версии с каналом предварительной версии Microsoft Edge или пакет SDK для выпуска вместе со средой выполнения WebView2.

Предварительный выпуск Пакеты SDK предназначены для использования во время разработки, если вы хотите протестировать новейшие API WebView2, включая экспериментальные API, перед добавлением поддержки этих API в среду выполнения. Рекомендуется использовать канал Canary, так как он содержит реализации последних API. Если вы хотите протестировать и использовать экспериментальные API WebView2, используйте следующее сочетание:

  • Предварительная версия пакета SDK WebView2.
  • Канал с предварительной версией Microsoft Edge в клиенте разработки.

Релиз Пакеты SDK содержат только стабильные API, но не экспериментальные API. При работе над рабочим выпуском приложения WebView2 используйте следующее сочетание:

  • Версия выпуска пакета SDK WebView2.
  • Среда выполнения WebView2 в клиенте разработки.

Более подробная информация о пакетах Prerelease и Release SDK представлена ниже.

Этапы внедрения API

Новые API внедряются поэтапно:

Состояние API Описание
Поэкспериментируйте в предварительной версии пакета SDK 1. Сначала API является экспериментальным в предварительном выпуске пакета SDK. (Иногда API пропускают экспериментальную фазу и добавляются непосредственно в стабильный выпуск в пакете SDK.) Вы можете протестировать эти API и предоставить отзыв. API еще не входит в Release SDK.
Stable в предварительной версии пакета SDK 2. Затем API повышается до уровня "Стабильный" в предварительной версии SDK. API еще не входит в Release SDK.
Stable в пакете SDK для выпуска 3. Затем стабильный API продвигается для включения в Release SDK. (Иногда API одновременно повышаются до уровня "Стабильный" в предварительной версии пакета SDK и до стабильного в версии пакета SDK.) Обычно это происходит через 1 месяц после того, как API переводится в статус "Стабильный" в предварительной версии пакета SDK. API также остается в предварительном выпуске SDK.

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

См. также:

Выбор типа пакета SDK

Чтобы выбрать, какую версию пакета NuGet WebView2 SDK использует проект Visual Studio, в Visual Studio щелкните проект правой кнопкой мыши, выберите " Управление пакетами NuGet", установите или снимите флажок "Включить предварительный выпуск ", выберите пакет Microsoft.Web.WebView2 , а затем в раскрывающемся списке "Версия " выберите версию пакета NuGet Microsoft.Web.WebView2 .

Подробные сведения см. в разделе "Установка или обновление пакета SDK WebView2 " в статье "Настройка среды разработчика для WebView2". Вы также можете просмотреть список пакетов SDK Microsoft.Web.WebView2 на сайте NuGet.

Используйте предварительную версию пакета SDK вместе с каналом предварительных версий Microsoft Edge

При разработке актуального приложения WebView2 регулярно тестируйте его в последней версии канала предварительных версий Microsoft Edge, а также в среде выполнения WebView2. Поскольку веб-платформа постоянно развивается, регулярное тестирование — лучший способ убедиться, что ваше приложение будет продолжать работать должным образом.

При использовании пакета предварительной версии SDK WebView2 используйте канал предварительных версий Microsoft Edge в клиенте разработки. Каналы с предварительными версиями также называются каналами предварительной оценки . Рекомендуется использовать канал предварительных версий Canary, а не бета-канал или канал для разработчиков, так как канал Canary является самым последним и содержит реализации последних экспериментальных API.

Пакет SDK для предварительного выпуска является расширенным набором пакета пакета SDK для выпуска. Предварительная версия пакета SDK содержит подписи методов для:

  • Экспериментальные API.
  • Стабильные API, которые больше не являются экспериментальными, но еще не включены в пакет SDK для выпуска.
  • Стабильные API, добавленные в пакеты SDK для выпуска.

Предварительные каналы Microsoft Edge предоставляют реализации экспериментальных API WebView2 и стабильных API. Экспериментальные API могут быть изменены на основе отзывов. Не используйте пакеты предварительных версий SDK для создания рабочих приложений.

Сведения о том, как временно направить приложение на канал предварительной версии вместо среды выполнения WebView2 по умолчанию, см. в статье "Переключение на канал предварительной версии для тестирования ожидаемых API и функций".

См. также:

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

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

Пакет Release SDK содержит все стабильные API, находящиеся в производственной версии, и не включает подписи методов для экспериментальных API. Все API, находящиеся в пакете Release SDK, полностью поддерживаются в сборке среды выполнения WebView2 с таким же или более высоким номером.

См. также:

Дополнительные сведения об автоматическом обновлении актуальной среды выполнения см. в разделе:

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

См. следующие статьи:

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

Чтобы клиент мог создать экземпляр WebView2 и использовать набор API из выпуска общей доступности WebView2 (сборка SDK 616), у клиента должна быть установлена среда выполнения WebView2 версии 86.0.616.0 или более поздней. Среда выполнения 86.0.616.0 — специальный выпуск, так как он является общедоступным.

На компьютере разработки клиент должен иметь канал предварительной версии Microsoft Edge версии 86.0.616.0 или более поздней либо среду выполнения WebView2 версии 86.0.616.0 или более поздней.

Прямая совместимость API

Пакет SDK для выпуска WebView2 поддерживает прямую совместимость с версии 1 (пакет SDK выпуска 1.0.622.22 для среды выполнения 86 (19 октября 2020 г.) в архивных заметках о выпуске для SDK WebView2). Вы можете обновить приложение WebView2, чтобы использовать последние API-интерфейсы из последней версии выпуска пакета SDK. Ваше приложение продолжит работать в клиентах, так как клиенты автоматически имеют последнюю версию актуальной среды выполнения WebView2.

API WebView2 в пакете Release SDK стабильны и совместимы с будущими обновлениями. API WebView2 работает при использовании среды выполнения WebView2 с номером сборки SDK, в которой этот API был представлен или более высоким. Номер сборки является третьей частью состоящего из четырех частей номера версии для SDK Webview2 и номера версии из четырех частей для Microsoft Edge и среды выполнения WebView2.

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

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

Например, если API представлен в SDK 1.0. 900.0, этот API будет работать со средой выполнения 94.0. 900+.0, но не со временем выполнения 90.0. 700.0.

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

Экспериментальные API

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

Разработка с помощью экспериментальных API и предоставление отзывов

Поддержка экспериментальных API в пакете предварительной версии SDK WebView2 не гарантируется, и они могут быть удалены в будущих обновлениях среды выполнения.

Для полной поддержки экспериментальных API используйте канал предварительной версии Microsoft Edge, а не актуальную среду выполнения WebView2. Когда предварительная версия пакета SDK WebView2 изначально доступна, этот пакет SDK работает только с Microsoft Edge Canary. Вскоре после этого предварительная версия пакета SDK также работает с бета-каналом и каналом разработчика.

Используйте предварительную версию пакета SDK, чтобы заранее опробовать новые экспериментальные API и предоставить отзывы до того, как экспериментальные API будут преобразованы в стабильные, совместимые с будущим API.

  • Совместимость экспериментальных API (в предварительном выпуске SDK) не гарантируется.
  • Стабильные API, входящие в состав пакета SDK для предварительного выпуска, совместимы с будущими версиями, даже если они еще не включены в пакет SDK.
  • Стабильные API, находящиеся в пакете SDK для выпуска, совместимы с будущими обновлениями.

Дополнительные сведения см. в разделе "Прямая совместимость API" выше.

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

Чтобы оценить экспериментальные API и поделиться своим мнением, используйте репозиторий WebView2Feedback .

См. также:

Переход от экспериментальных API к стабильным API

После перевода API из экспериментального состояния в стабильный необходимо переместить код приложения в стабильный API. Использование экспериментальных API или предварительной версии пакета SDK не рекомендуется для рабочих приложений. Следуйте этим рекомендациям при переходе приложения от использования экспериментальных API к использованию стабильных API:

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

  • Обновите код приложения для использования стабильных API-интерфейсов вместо экспериментальных API-интерфейсов (для COM). Стабильный API будет поддерживаться в исправлениях ошибок, но экспериментальный API будет устаревшим и недоступным в более новых (предварительных или выпускных) пакетах SDK. После повышения статуса API до версии "Стабильная" экспериментальная версия этого API поддерживается для двух выпусков пакета SDK предварительного выпуска в устаревшем состоянии. В последующих версиях пакета SDK для предварительного выпуска экспериментальные API могут быть изменены, удалены или добавлены.

  • Всегда используйте функцию обнаружения компонентов, чтобы гарантировать, что стабильный API реализован в пользовательской версии среды выполнения WebView2. Чтобы проверить, поддерживает ли установленная среда выполнения недавно добавленные API, см. раздел "Обнаружение компонентов" ниже.

  • Примечание только для .NET. В предварительной версии пакета SDK WebView2 стабильные API .NET будут возвращаться к соответствующим экспериментальным API, если среда выполнения WebView2 пользователя имеет только реализацию экспериментального API и не имеет реализации стабильного API.

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

При использовании подхода к распространению Evergreen среда выполнения WebView2 клиента автоматически обновляется до последней доступной версии. Однако пользователь или ИТ-администратор может запретить автоматическое обновление среды выполнения WebView2. Устаревшая среда выполнения на клиенте может вызвать проблемы совместимости с обновленным приложением WebView2, использующим новые API из недавнего пакета SDK.

Если обновление среды выполнения WebView2 запрещено на клиенте, убедитесь, что известен минимальный номер сборки среды выполнения WebView2, необходимый вашему приложению. Чтобы просмотреть или получить последние версии среды выполнения WebView2, см. статью "Скачать среду выполнения WebView2 " на странице Microsoft Edge WebView2 по адресу developer.microsoft.com. Минимальная требуемая версия среды выполнения для поддержки общедоступного выпуска пакета SDK (сборка 616) ниже, чем для последней версии среды выполнения. Последняя версия среды выполнения поддерживает все API, которые есть в последнем пакете SDK выпуска.

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

Обнаружение компонентов для проверки поддержки установленной средой выполнения недавно добавленных API

Если ваше приложение использует актуальную среду выполнения, а не фиксированную версию, все вызовы относительно новых API WebView2 следует обернуть с помощью QueryInterface или try-catch. Существуют крайние случаи, когда актуальная среда выполнения клиента не является последней и поэтому отстает от номера сборки SDK, так как администратор мог временно подавить обновление среды выполнения WebView2 или клиент может быть автономным.

При разработке приложения WebView2 с использованием последней версии пакета SDK WebView2, если вы используете недавно добавленный API, необходимо проверить или "определить", присутствует ли этот API в установленной среде выполнения WebView2 клиента. Способ программного тестирования приложения для поддержки API зависит от платформы написания кода:

.NET, WinUI и WinRT

Использование try/catch и проверка No such interface supported на наличие исключения при использовании методов, свойств и событий, которые были добавлены в более поздние версии пакета SDK WebView2. Это исключение, вероятно, указывает на то, что клиентская среда выполнения WebView2 является более старой версией, которая не поддерживает этот API.

Win32 C/C++

При запросе экспорта CreateCoreWebView2Environment DLL и при выполнении QueryInterface на любом CoreWebView2 объекте проверьте наличие возвращаемого значения E_NOINTERFACE. Это возвращаемое значение, вероятно, указывает на то, что клиентская среда выполнения WebView2 является более старой версией, которая не поддерживает этот интерфейс.

Пример проверки наличия определенных API WebView2 в среде выполнения см try_query . в AppWindow.cpp. Этот файл является оболочкой вызовов API WebView2 в CHECK_FAILURE функцию макроса, определенную в CheckFailure.h.

Обеспечение корректного резерва

Если ваш код определяет, что API недоступен в установленной клиентской среде выполнения WebView2, вы должны обеспечить корректный откат для связанной функции или сообщить пользователю, что ему необходимо обновить среду выполнения WebView2 для использования этой функции.

См. также

Документация по Microsoft Edge Enterprise:

Скачивание:

GitHub:

  • Last updated on