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

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

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

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 позволяют ведущим приложениям взаимодействовать с веб-рабочими ролей для разгрузки задач из потока main, повышения скорости реагирования и поддержки фоновых операций. К ним относятся выделенные рабочие роли, общие рабочие роли и служебные рабочие роли.

Эти 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 main кадра. С помощью этого API приложение может подписаться на событие создания вложенных iframe, предоставляя приложению доступ ко всем свойствам, методам и событиям для вложенного CoreWebView2Frame iframe.

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

  • Только страница main и 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 main кадра. С помощью этого API приложение может подписаться на событие создания вложенных iframe, предоставляя приложению доступ ко всем свойствам, методам и событиям для вложенного CoreWebView2Frame iframe.

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

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

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

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

1.0.3124.44

Дата выпуска: 10 марта 2025 г.

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

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

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

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

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

Только для среды выполнения
  • Расширения не будут отключены в WebView2 с помощью AddBrowserExtensionAsync, независимо от того, включен ли режим разработчика. (Проблема No 5113)
  • Отключено фоновое обновление сетевого времени. (Проблема No 5047)
  • Исправлено всплывающее окно загрузки, которое не отображалось при target="_blank". (Проблема No 5063)

1.0.3171-prerelease

Дата выпуска: 10 марта 2025 г.

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

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

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

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

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

Api-интерфейсы не были повышены с экспериментального на стабильный в этом предварительном пакете SDK.

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

Среда выполнения и пакет SDK
  • Исправлена обработка исключений асинхронного метода объекта узла. (Проблема No 3402)
  • Исправлена документация по CoreWebVIew2.Navigate. (Выпуск No 5091)
Только для среды выполнения
  • Исправлена регрессия установки "Добавить в Chrome".
  • Исправлена отправка папок в UWP и WinUI. (Проблема No 3275)
  • Расширения не будут отключены в WebView2 с помощью AddBrowserExtensionAsync, независимо от того, включен ли режим разработчика. (Проблема No 5113)
  • Отключено фоновое обновление сетевого времени. (Проблема No 5047)
  • Исправлено всплывающее окно загрузки, которое не отображалось при target="_blank". (Проблема No 5063)
Только пакет SDK
  • Устраняет сбой, который может произойти, когда сборщик мусора вызывает Finalize поток, отличный от main потока.

См. также

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