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

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

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

1.0.3650.58

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

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

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

Акции на этап 3 (стабильный выпуск)

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

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

Только для среды выполнения
  • Исправлен доступ к локальной сети, активировав всплывающее окно оповещения о разрешениях.

1.0.3712-prerelease

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

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

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

Акции до этапа 1 (экспериментальные в предварительной версии)

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

Настройка поведения диапазона портов

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

  • Используйте SetAllowedPortRange в экземпляре CoreWebView2EnvironmentOptions (или ICoreWebView2ExperimentalEnvironmentOptions) для настройки ограничений портов во время создания среды.

    • Используйте параметр , scope чтобы указать, применяется ли конфигурация ко всем компонентам (Default) или только к одноранговым подключениям WebRTC (WebRtc). В настоящее время поддерживается только WebRtc .

    • protocol Используйте параметр , чтобы указать транспортный протокол (в настоящее время поддерживает Udp).

    • Укажите minPort значения и maxPort в диапазоне от 1025 до 65535 (включительно) или используйте (0,0), чтобы сбросить или снять ограничения.

  • Используйте GetEffectiveAllowedPortRange в экземпляре CoreWebView2EnvironmentOptions (или ICoreWebView2ExperimentalEnvironmentOptions) для получения конфигурации активного диапазона портов для определенного область и протокола.

    • Возвращает явно заданный диапазон для заданного область или наследует от Default область, если он не задан.

    • Возвращает значение (0,0), если для указанного область не настроено никаких ограничений.

Акции на этап 2 (стабильный в предварительной версии)

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

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

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

  • Используйте DragStarting в , ICoreWebView2CompositionController5 чтобы добавить обработчик событий, который вызывается при запуске операции перетаскивания.
  • Используйте ICoreWebView2DragStartingEventArgs для запуска собственной операции перетаскивания.
    • Используйте метод для GetDeferral выполнения любой асинхронной логики перетаскивания и последующего вызова в WebView.
    • Используйте свойство , Handled чтобы сообщить WebView2, следует ли использовать собственную логику перетаскивания.

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

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

Только для среды выполнения
  • Исправлен доступ к локальной сети, активировав всплывающее окно оповещения о разрешениях.
  • Исправлена регрессия setColorScheme API.
  • Исправлена отложенная инициализация для ICoreWebView2NewWindowRequestedEventArgs параметра enable-new-window-requested-deferred-initializationкомандной строки .

1.0.3595.46

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

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

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

Акции на этап 3 (стабильный выпуск)

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

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

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

Только для среды выполнения
  • Отключено создание процесса "Спекулятивного отрисовщика".

1.0.3650-prerelease

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

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

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

Акции до этапа 1 (экспериментальные в предварительной версии)

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

Акции на этап 2 (стабильный в предварительной версии)

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

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

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

Только для среды выполнения
  • Отключено создание процесса "Спекулятивного отрисовщика".
  • Исправлена проблема с синхронизацией диалогового окна поиска при выполнении поиска программным способом.

1.0.3537.50

Дата выпуска: 6 октября 2025 г.

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

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

Акции на этап 3 (стабильный выпуск)

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

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

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

Только для среды выполнения
  • Исправлен доступ к локальной сети, активировав всплывающее окно оповещения о разрешениях.
Только пакет SDK
  • Исправлена ошибка BinSkim для WebView2Loader.dll.

1.0.3590-prerelease

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

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

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

Акции до этапа 1 (экспериментальные в предварительной версии)

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

Поддержка меток конфиденциальности

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

Основные возможности:

  • Настройка доступности диспетчера ограничений взаимодействия с страницами . Настройте список фильтров URL-адресов для диспетчера ограничений взаимодействия со страницами. После настройки списка диспетчер ограничений взаимодействия с страницами становится доступным на страницах списка разрешенных. Эти страницы могут отправлять метки конфиденциальности на платформу через API.

  • Раскрытие сведений о конфиденциальности - CoreWebView2 Теперь предоставляет SensitivityInfo свойство и SensitivityInfoChanged событие, позволяя приложениям прослушивать обновления сведений меток конфиденциальности.

Поддержка меток конфиденциальности изначально доступна только в Win32. Поддержка .NET и WinRT планируется в будущем выпуске.

Акции на этап 2 (стабильный в предварительной версии)

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

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

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

Только для среды выполнения
  • Исправлен висящий указатель в контексте разрешений доступа к файловой системе.
  • Исправлена зависание пользовательского интерфейса во время перетаскивания в WinUI3.
  • Исправлен доступ к локальной сети, активировав всплывающее окно оповещения о разрешениях.
  • Устранена проблема, из-за которой в дереве специальных возможностей отображался дополнительный регион.
  • Исправлена проблема, из-за которой загрузки в рамке браузера по умолчанию не работали.
Только пакет SDK
  • Исправлена ошибка BinSkim для WebView2Loader.dll.

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.

Акции на этап 3 (стабильный выпуск)

В этом пакете 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.

Акции до этапа 1 (экспериментальные в предварительной версии)

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

Акции на этап 2 (стабильный в предварительной версии)

В этом пакете 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 или более поздней.

Акции на этап 3 (стабильный выпуск)

Следующие 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 или более поздней.

Акции до этапа 1 (экспериментальные в предварительной версии)

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

Акции на этап 2 (стабильный в предварительной версии)

В этом пакете 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 или более поздней.

Акции на этап 3 (стабильный выпуск)

Следующие 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 или более поздней.

Акции до этапа 1 (экспериментальные в предварительной версии)

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

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

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

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

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

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

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

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

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

Акции на этап 2 (стабильный в предварительной версии)

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

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

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

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

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

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

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

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

См. также

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

  • Last updated on