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

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

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

1.0.3485.44

Дата выпуска: 8 сентября 2025 г.

Пакет NuGet для пакета SDK Для WebView2 1.0.3485.44

Для полной совместимости API этой версии пакета SDK для WebView2 требуется среда выполнения WebView2 версии 140.0.3485.44 или более поздней.

Общие изменения

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

  • Инфраструктура тестирования была укреплена.
  • Улучшена проверка API, чтобы обеспечить надежную работу API в разных сценариях.

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

Рекламные акции

В этом пакете SDK для выпуска не были повышены дополнительные API с этапа 2: стабильный в предварительной версии до этапа 3: стабильный в выпуске.

Исправления ошибок

В этом пакете SDK для выпуска нет исправлений ошибок.

1.0.3530-prerelease

Дата выпуска: 8 сентября 2025 г.

Пакет NuGet для пакета SDK Для WebView2 1.0.3530-prerelease

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

Общие изменения

Этот предварительный пакет SDK ориентирован на улучшение работы WebView2 за счет закулисных улучшений.

  • Инфраструктура тестирования была укреплена.
  • Улучшена проверка API, чтобы обеспечить надежную работу API в разных сценариях.

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

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

Экспериментальные API не добавлены в этот пакет SDK для предварительной версии.

Рекламные акции

В этом пакете SDK для предварительной версии не было повышено ни один API-интерфейс с этапа 1: экспериментальный в предварительной версии до этапа 2: стабильный в предварительной выпуске.

Исправления ошибок

Этот пакет SDK для предварительной версии включает следующие исправления ошибок.

Только пакет SDK
  • Исправлена утечка памяти в контроллере композиции WPF.

1.0.3405.78

Дата выпуска: 11 августа 2025 г.

Пакет NuGet для пакета SDK Для WebView2 1.0.3405.78

Для полной совместимости API для этой версии пакета SDK для WebView2 требуется среда выполнения WebView2 версии 139.0.3405.78 или более поздней.

Рекламные акции

Следующие API были повышены с этапа 2: Стабильный в предварительной версии до этапа 3: стабильный в выпуске и теперь включены в этот пакет SDK для выпуска.

Настройка поведения поиска (API поиска)

API поиска позволяет программно управлять операциями поиска и добавлять в приложение следующие функции:

  • Настройка параметров поиска, включая определение термина, конфиденциальность регистра, Word сопоставление, выделение совпадений и подавление пользовательского интерфейса по умолчанию.
  • Найдите текстовые строки и перейдите между ними в элементе управления WebView2.
  • Программная инициализация операций поиска и навигация по результатам поиска .
  • Подавление пользовательского интерфейса поиска по умолчанию.
  • Отслеживайте состояние операций поиска .

Существуют известные проблемы с API поиска документов PDF. При просмотре PDF-документа в элементе управления WebView2 функция Найти в настоящее время предоставляет только первый индекс и количество найденных совпадений. Например, если строка встречается три раза в PDF-файле, пользовательский интерфейс будет говорить 1/3 и не будет поддерживать программный вызов Next или Previous.

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

Исправления ошибок

Только для среды выполнения
  • Исправлен сбой в средствах разработки на Windows Server и Windows 10.

1.0.3477-prerelease

Дата выпуска: 11 августа 2025 г.

Пакет NuGet для пакета SDK Для WebView2 1.0.3477-prerelease

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

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

Экспериментальные API не добавлены в этот пакет SDK для предварительной версии.

Рекламные акции

В этом пакете SDK для предварительной версии не было повышено ни один API-интерфейс с этапа 1: экспериментальный в предварительной версии до этапа 2: стабильный в предварительной выпуске.

Исправления ошибок

Только для среды выполнения
  • Исправлено put_UserAgent , что не работает для служебных рабочих ролей.
  • Исправлен сбой в средствах разработки на Windows Server и Windows 10.
  • Удалено отслеживание процессов браузера после вызова remove_BrowserProcessExited.
  • Исправлена проблема с утечкой памяти в вызовах асинхронных hostObject функций.
  • Исправлена ошибка сенсорного ввода в визуальном размещении после длительного касания.

1.0.3351.48

Дата выпуска: 1 июля 2025 г.

Пакет NuGet для пакета SDK Для WebView2 1.0.3351.48

Для полной совместимости API для этой версии пакета SDK для WebView2 требуется среда выполнения WebView2 версии 138.0.3351.48 или более поздней.

Рекламные акции

Следующие API были повышены с этапа 2: Стабильный в предварительной версии до этапа 3: стабильный в выпуске и теперь включены в этот пакет SDK для выпуска.

Разрешить передачу входных сообщений о событиях через окно браузера

Класс CoreWebView2ControllerOptions теперь имеет AllowHostInputProcessing свойство, которое позволяет пользователю ввести сообщения о событиях (клавиатура, мышь, сенсорный ввод или перо) через окно браузера, которые будут получены окном процесса приложения.

Исправления ошибок

Только для среды выполнения
  • Исправлена проблема с черным ящиком для диалоговых окон в визуальном размещении.

1.0.3415-prerelease

Дата выпуска: 14 июля 2025 г.

Пакет NuGet для пакета SDK Для WebView2 1.0.3415-prerelease

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

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

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

Включение фоновой обработки и автономной поддержки (РАБОЧИЕ API WebView2)

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

Эти API обеспечивают следующее:

  • События жизненного цикла: Мониторинг создания и уничтожения рабочих ролей.
  • Интерфейсы обмена сообщениями: Обмен данными с рабочими ролей с помощью PostMessage и WebMessageReceived.
  • Управление рабочей ролью. Запрос и получение регистраций и экземпляров рабочих ролей.
Отрисовка настраиваемых строк заголовков (API наложения элементов управления окном)

API наложения элементов управления окном позволяет разработчикам создавать настраиваемые заголовки, отрисовывая подпись кнопки (свернуть, развернуть, восстановить, закрыть) непосредственно в окне WebView2. Наложение оконных элементов управления отображается в верхнем углу WebView и легко интегрируется с пользовательским интерфейсом приложения.

Используйте этот API, если:

  • Вы хотите заменить строку заголовка ОС по умолчанию полностью настроенной строкой заголовка в приложении.
  • Вы работаете с функциями не клиентских регионов, такими как app-region: drag и IsNonClientRegionSupportEnabled.

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

Рекламные акции

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

Настройка поведения поиска (API поиска)

API поиска позволяет программно управлять операциями поиска и добавлять в приложение следующие функции:

  • Настройка параметров поиска, включая определение термина, конфиденциальность регистра, Word сопоставление, выделение совпадений и подавление пользовательского интерфейса по умолчанию.
  • Найдите текстовые строки и перейдите между ними в элементе управления WebView2.
  • Программная инициализация операций поиска и навигация по результатам поиска .
  • Подавление пользовательского интерфейса поиска по умолчанию.
  • Отслеживайте состояние операций поиска .

Существуют известные проблемы с API поиска документов PDF. При просмотре PDF-документа в элементе управления WebView2 функция Найти в настоящее время предоставляет только первый индекс и количество найденных совпадений. Например, если строка встречается три раза в PDF-файле, пользовательский интерфейс будет говорить 1/3 и не будет поддерживать программный вызов Next или Previous.

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

Исправления ошибок

Только для среды выполнения
  • Исправлена проблема с черным ящиком для диалоговых окон в визуальном размещении.
  • Исправлено put_UserAgent , что не работает для служебных рабочих ролей.
  • Исправлен сбой в средствах разработки на Windows Server и Windows 10.

1.0.3296.44

Дата выпуска: 3 июня 2025 г.

Пакет NuGet для пакета SDK Для WebView2 1.0.3296.44

Для полной совместимости API для этой версии пакета SDK для WebView2 требуется среда выполнения WebView2 версии 137.0.3296.44 или более поздней.

Рекламные акции

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

Установка цвета фона по умолчанию при инициализации WebView2 (API DefaultBackgroundColor)

API DefaultBackgroundColor позволяет пользователям задавать DefaultBackgroundColor свойство при инициализации. Это предотвращает прерывание белой вспышки во время загрузки WebView2.

Исправления ошибок

Только для среды выполнения
  • Исправлены поля в печатном PDF-файле.

1.0.3344-prerelease

Дата выпуска: 3 июня 2025 г.

Пакет NuGet для пакета SDK Для WebView2 1.0.3344-prerelease

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

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

Экспериментальные API не добавлены в этот пакет SDK для предварительной версии.

Рекламные акции

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

Разрешить передачу входных сообщений о событиях через окно браузера

Класс CoreWebView2ControllerOptions теперь имеет AllowHostInputProcessing свойство, которое позволяет пользователю ввести сообщения о событиях (клавиатура, мышь, сенсорный ввод или перо) через окно браузера, которые будут получены окном процесса приложения.

Исправления ошибок

Только для среды выполнения
  • Исправлена ошибка, из-за которой событие мыши не срабалось после события касания.
  • Отключена запись веб-страниц в элементе управления WebView2.
  • Исправлено диалоговое окно загрузки .
  • Исправлена проблема с загрузкой в рамке браузера по умолчанию. (Выпуск No 5196)
  • Исправлены поля в печатном PDF-файле.

1.0.3240.44

Дата выпуска: 5 мая 2025 г.

Пакет NuGet для пакета SDK Для WebView2 1.0.3240.44

Для полной совместимости API для этой версии пакета SDK для WebView2 требуется среда выполнения WebView2 версии 136.0.3240.44 или более поздней.

Рекламные акции

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

Отслеживание журнала навигации для вложенных iframes (API FrameCreatedEvent)

API FrameCreatedEvent поддерживает вложенные iframe-кадры, например запись журнала навигации для iframe второго уровня. Без этого API WebView2 отслеживает только iframe первого уровня, которые являются прямыми дочерними iframe для основного кадра. С помощью этого API приложение может подписаться на событие создания вложенных iframe, предоставляя приложению доступ ко всем свойствам, методам и событиям для вложенного CoreWebView2Frame iframe.

Используйте этот API для управления отслеживанием iframe на странице, содержащей несколько уровней iframe. Вы можете отслеживать любое из следующих действий:

  • Только главная страница и iframe первого уровня (поведение по умолчанию).
  • Частичное дерево кадров WebView2 с определенными интересующими iframe.
  • Полное дерево кадров WebView2.

Исправления ошибок

Только для среды выполнения
  • Исправлена проблема, из-за которой скачивание из рамки браузера по умолчанию не выполнялось. (Выпуск No 5196)
  • Исправлена проблема, из-за которой имя канала возвращалось неправильно, что привело к сбою в некоторых приложениях UWP.

1.0.3296-prerelease

Дата выпуска: 12 мая 2025 г.

Пакет NuGet для пакета SDK Для WebView2 1.0.3296-prerelease

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

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

Экспериментальные API не добавлены в этот пакет SDK для предварительной версии.

Рекламные акции

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

Установка цвета фона по умолчанию при инициализации WebView2 (API DefaultBackgroundColor)

API DefaultBackgroundColor позволяет пользователям задавать DefaultBackgroundColor свойство при инициализации. Это предотвращает прерывание белой вспышки во время загрузки WebView2.

Исправления ошибок

Только для среды выполнения
  • Исправлена панель поиска , больше не отображающаяся после сдвига окна.
  • Исправлена ошибка, из-за которой приложению не удавалось отменить навигацию по страницам NavigationStarting входа через событие.
  • Исправлена проблема, из-за которой скачивание из рамки браузера по умолчанию не выполнялось. (Выпуск No 5196)
  • Исправлена проблема, из-за которой имя канала возвращалось неправильно, что привело к сбою в некоторых приложениях UWP.

1.0.3179.45

Дата выпуска: 7 апреля 2025 г.

Пакет NuGet для пакета SDK Для WebView2 1.0.3179.45

Для полной совместимости API этой версии пакета SDK для WebView2 требуется среда выполнения WebView2 версии 135.0.3179.45 или более поздней.

Рекламные акции

Дополнительные API не были повышены до стабильных и не добавлены в этот пакет SDK для выпуска.

Исправления ошибок

Только для среды выполнения
  • Исправлен элемент HTML Select (<select>), чтобы сделать его доступным для выбора в приложениях WPF.
  • Исправлена навигация edge://crashes в элементе управления WebView2.
  • Исправлены потенциальные сбои и проблемы с пользовательским интерфейсом при вызове пользовательского интерфейса учетных данных Windows из экземпляра WebView2.
  • Исправлена ошибка, из-за которой пользователям не удавалось ввести входное поле с данными автозаполнения. (Проблема No 5144)

1.0.3230-prerelease

Дата выпуска: 7 апреля 2025 г.

Пакет NuGet для пакета SDK Для WebView2 1.0.3230-prerelease

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

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

Экспериментальные API не добавлены в этот пакет SDK для предварительной версии.

Рекламные акции

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

Отслеживание журнала навигации для вложенных iframes (API FrameCreatedEvent)

API FrameCreatedEvent поддерживает вложенные iframe-кадры, например запись журнала навигации для iframe второго уровня. Без этого API WebView2 отслеживает только iframe первого уровня, которые являются прямыми дочерними iframe для основного кадра. С помощью этого API приложение может подписаться на событие создания вложенных iframe, предоставляя приложению доступ ко всем свойствам, методам и событиям для вложенного CoreWebView2Frame iframe.

Используйте этот API для управления отслеживанием iframe на странице, содержащей несколько уровней iframe. Вы можете отслеживать любое из следующих действий:

  • Только главная страница и iframe первого уровня (поведение по умолчанию).
  • Частичное дерево кадров WebView2 с определенными интересующими iframe.
  • Полное дерево кадров WebView2.

Исправления ошибок

Только для среды выполнения
  • Исправлена проблема в WPF, из-за которой <раскрывающийся список> данных закрывался при перемещении мыши за пределы элемента управления WebView2.
  • Исправлена навигация edge://crashes в элементе управления WebView2.
  • Исправлен элемент HTML Select (<select>), чтобы сделать его доступным для выбора в приложениях WPF.
  • Исправлены потенциальные сбои и проблемы с пользовательским интерфейсом при вызове пользовательского интерфейса учетных данных Windows из экземпляра WebView2.
  • Исправлена ошибка, из-за которой пользователи не смогли ввести поле ввода с данными автозаполнения. (Проблема No 5144)
  • Исправлена регрессия в API строки состояния .
Только пакет SDK
  • Исправлены клавиши TAB, SHIFT+TAB и СТРЕЛКА в режиме размещения "Окно в визуальный".

См. также

Справочник по API: