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

Тестирование будущих API и функций

  • Статья

В этой статье объясняется, как переключиться на канал предварительной версии Microsoft Edge для тестирования экспериментальных API- интерфейсов, которые находятся в пакете пакета SDK предварительной версии WebView2.

Чтобы протестировать новые или предстоящие API и функции, переключитесь на канал предварительной версии Microsoft Edge, а не на стабильную среду выполнения WebView2. Среда выполнения Evergreen WebView2 часто обновляется для добавления новых API и функций. Эти обновления могут включать API, которые были повышены из Experimental предварительной версии пакета SDK Для WebView2 до Stable в пакете SDK выпуска WebView2. Некоторые обновления в среде выполнения Evergreen WebView2 могут привести к прерыванию работы приложения WebView2.

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

См. также:

Использование канала предварительной версии WebView2 для тестирования приложения с помощью последних экспериментальных API WebView2

Среда выполнения Evergreen WebView2 не включает экспериментальные API WebView2. Вместо этого, чтобы использовать эти экспериментальные функции в коде WebView2, приложение использует версию WebView2, которая находится в канале предварительной версии Microsoft Edge (Бета-версия Для Edge, Разработка для Edge или Edge Canary).

Рекомендуется использовать канал Canary, так как он предлагает последние экспериментальные API.

Взаимодействие между предварительной версией пакета SDK для WebView2 и каналами предварительной версии Microsoft Edge

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

  • Каналы предварительной версии Microsoft Edge: Эти каналы (Бета-версия Edge, Разработка для Edge или Edge Canary) содержат необходимые двоичные файлы Microsoft Edge. Эти каналы позволяют приложению запускать и отрисовывать с помощью экспериментальных API.

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

Тестирование переадресации совместимости с помощью канала предварительной версии

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

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

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

Каналы предварительной версии Microsoft Edge включают предварительную версию среды выполнения WebView2. Каналы предварительной версии также называются каналами предварительной оценки. После установки каналы предварительной версии остаются в актуальном состоянии; последняя версия каждого канала предварительной версии устанавливается автоматически. Например, это означает, что канал Canary будет обновляться почти ежедневно. Чтобы скачать канал предварительной версии Microsoft Edge (Canary, Dev или Beta), перейдите на страницу Стать участником программы предварительной оценки Microsoft Edge.

Сведения о развертывании канала предварительной версии на нескольких компьютерах см. в разделе Развертывание каналов предварительной версии ниже.

Подходы к тому, чтобы приложение использовало определенный канал браузера

При инициализации WebView2 будет пытаться найти допустимую среду выполнения на компьютере для использования. Это может быть среда выполнения WebView2, канал предварительной версии Microsoft Edge или указанное расположение, содержащее двоичные файлы фиксированной версии. Дополнительные сведения о поддерживаемых средах выполнения см. в статье Распространение приложения и среды выполнения WebView2.

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

Эти подходы описаны ниже.

Этот раздел относится к использованию API, переопределения реестра, переменной среды или групповой политики.

Если определенная исполняемая папка браузера не указана, WebView2 попытается загрузить среду выполнения из одного из известных расположений по умолчанию. По умолчанию загрузчик WebView2 выполняет поиск сред выполнения от наиболее стабильных до наименее стабильных (Canary) с помощью первой найденной среды выполнения.

WebView2 Runtime (Stable) ->  Edge Beta -> Edge Dev -> Edge Canary

Вы можете отменить порядок поиска по умолчанию, задав ChannelSearchKind ДЛЯ API значение LeastStableили задав ChannelSearchKind политику, раздел реестра или переменную среды .1 При возврате порядка поиска загрузчик WebView2 выполняется с наименее стабильной (Canary) на наиболее стабильную:

Edge Canary -> Edge Dev -> Edge Beta -> WebView2 Runtime (Stable)

Это необходимо сделать до инициализации элемента управления WebView2.

Если вам нужен более конкретный порядок, см. статью Использование ChannelSearchKind определенного канала.

По умолчанию CoreWebView2EnvironmentOptions.ChannelSearchKind свойство имеет значение CoreWebView2ChannelSearchKind.MostStable (значение перечисления). Вместо этого измените порядок поиска, задав свойству CoreWebView2EnvironmentOptions.ChannelSearchKind значение CoreWebView2ChannelSearchKind.LeastStable.

.СЕТЬ:

WinRT:

Win32:

ChannelSearchKind Использование, чтобы убедиться, что используется определенный канал

При использовании ChannelSearchKindниже показано, как убедиться, что определенный канал браузера предварительной версии используется при наличии нескольких каналов предварительной версии браузера.

В дополнение к отмене порядка поиска каналов можно изменить набор каналов выпуска для включения в поиск, чтобы обеспечить дополнительный контроль над выбором каналов. Загрузчик будет искать каналы на устройстве в порядке, указанном типом поиска каналов, но он будет учитывать только каналы, которые находятся в указанном наборе каналов выпуска.

Этот параметр удобен, если вы хотите ориентироваться на конкретный канал, а не просто выбирать наиболее или наименее стабильный канал. По умолчанию каналы выпуска включают все каналы: Стабильный (0), Бета-версия (1), Dev (2) и Canary (3).

Пример:

Channel Search Kind: 1 (Least Stable)
Release Channels: 0 (Stable), 1 (Beta)

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

Каналы выпуска также можно задать с помощью API, раздела реестра, переменной среды или групповой политики.

По умолчанию загрузчик учитывает все каналы выпуска. Задайте ReleaseChannels маску каналов, которые вы хотите, чтобы загрузчик искал.

.СЕТЬ:

WinRT:

Win32:

Настройка исполняемой папки браузера (для локального тестирования)

Альтернативный подход — использовать исполняемую папку браузера. При таком подходе вы указываете папку, содержащую двоичные файлы среды выполнения. Эта папка может находиться в любом из следующих расположений:

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

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

Передайте путь к исполняемой папке браузера во время создания среды с помощью следующих API.

.NET (WPF):

.NET (WinForms):

WinRT:

Win32:

При выборе новой среды выполнения

Если вы используете переменную среды, раздел реестра или групповую политику, они применяются только к новым созданным процессам браузера среды выполнения WebView2. Они не применяются к уже запущенным процессам браузера среды выполнения WebView2. Например, если у вас уже есть WebView2 с определенной папкой данных пользователя (и, следовательно, соответствующим процессом браузера) и перед ChannelSearchKind попыткой создать новый WebView2 с помощью той же папки данных пользователя, он будет использовать существующий процесс браузера среды выполнения WebView2, а не искать другую среду выполнения.

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

  • Перезапустите приложение.
  • Повторно создайте все элементы управления WebView2, которые совместно используют папку данных пользователя.
  • Создайте webView2 с папкой данных пользователя, отличной от любых других работающих в настоящее время элементов управления WebView2.

Настройка переменной среды

Для задания переменных среды можно использовать несколько подходов:

  • Настройка переменных среды с помощью API для определенного приложения.
  • Глобальное задание переменных среды для всех приложений.

Эти подходы описаны ниже.

Настройка переменных среды с помощью API для определенного приложения

Переменные среды можно задать с помощью SetEnvironmentVariable. Вызов этой функции из ведущего приложения ограничивает область переменной среды только ведущим приложением и создаваемыми элементами управления WebView2 и не влияет на другие приложения в системе.

Глобальное задание переменных среды для всех приложений

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

  1. В строке поиска Windows введите "среда", а затем выберите Изменить системные переменные среды:

    Использование панели поиска Windows для поиска места изменения переменных среды

    Откроется диалоговое окно Свойства системы .

  2. Перейдите на вкладку Дополнительно и нажмите кнопку Переменные среды :

    Кнопка

    Откроется диалоговое окно Переменные среды .

  3. В разделе Переменные пользователя в верхней части страницы нажмите кнопку Создать . Откроется диалоговое окно Новая переменная пользователя .

  4. В текстовом поле Имя переменной введите имя переменной среды: WEBVIEW2_CHANNEL_SEARCH_KIND или WEBVIEW2_BROWSER_EXECUTABLE_FOLDER.

  5. В текстовом поле Значение переменной выполните одно из следующих действий.

    • Если задано ChannelSearchKindзначение , введите 1 , чтобы отменить порядок поиска по умолчанию, чтобы сначала использовать каналы предварительного просмотра (Canary, Beta, затем Dev), а затем Среду выполнения WebView2. Любое значение, отличное от 1 того, что вызывает использование порядка поиска по умолчанию (Среда выполнения WebView2, Edge Dev, Бета-версия Edge, а затем Edge Canary).

    • Если задано BrowserExecutableFolderзначение , введите путь к предпочтительному каналу браузера или двоичным файлам фиксированной версии.

  6. Нажмите кнопки ОК , чтобы закрыть диалоговые окна.

Развертывание каналов предварительной версии

Чтобы развернуть каналы предварительной версии Microsoft Edge на нескольких компьютерах, выполните одно из следующих действий:

  • Вариант 1. Установка каналов предварительной версии на компьютерах вручную.

  • Вариант 2. Программное развертывание каналов предварительной версии через конечные точки API.

Эти параметры описаны ниже.

Вариант 1. Установка каналов предварительной версии вручную на компьютерах

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

Канал Ссылка
Предохранитель Скачивание
Разработка Скачивание
Бета-версии Скачивание

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

Вариант 2. Программное развертывание каналов предварительной версии через конечные точки API

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

  1. Вызовите следующую конечную точку API, которая соответствует каналу предварительной версии, который требуется развернуть:

    Канал Ссылка
    Предохранитель https://edgeupdates.microsoft.com/api/products/canary
    MSI Link
    Разработка https://edgeupdates.microsoft.com/api/products/dev
    Бета-версии https://edgeupdates.microsoft.com/api/products/beta

    Канал Canary имеет отдельную ссылку MSI. Каналы разработки и бета-версии содержат ссылки MSI.

  2. Получение последнего пакета на устройство.

  3. Установите пакет.

См. также