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

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

Предварительный выпуск пакета SDK 1.0.4126-prerelease для среды выполнения 151 (7 июля 2026 г.)

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

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

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

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

Среда выполнения WebView2 меняется на 2-недельную периодичность выпуска

Начиная с версии 152 (24 августа 2026 г.), среда выполнения WebView2 переходит на 2-недельную периодичность выпуска. Это согласовано с Microsoft Edge. Среда выполнения WebView2 версии 151 — это окончательный выпуск, который находится на 4-недельной частоте выпуска.

См. [Объявление] Среда выполнения WebView2 переходит на 2-недельную периодичность выпуска (начиная с версии 152).

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

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

Отчет о сбое в событии ProcessFailed

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

  • Код исключения.
  • Имя и версия неисправного модуля.
  • Смещение сбоя.
  • Идентификатор отчета о сбое.
  • Идентификатор контейнера.
  • Время крушения было сообщено.

ProcessFailedEventArgs.CrashReport — это null , когда при сбое не был получен отчет о сбое, например в следующих сценариях:

  • Нормальный выход.
  • Внешнее завершение процесса.
  • Сбой запуска.
  • Повесить.

ProcessFailedEventArgs.CrashReport также может быть null для некоторых сбоев типа аварийного завершения, когда отчет не был создан. Перед доступом к свойствам ведущее приложение всегда должно проверкаnull.

Настройка параметров проверки репутации для каждого источника (SmartScreen)

Эта ReputationChecking функция позволяет приложению WebView2 пропускать проверки репутации SmartScreen для навигаций и скачиваний из определенных доверенных источников. ReputationChecking является членом перечисления CoreWebView2OriginFeature .

Если для этой функции задано значение CoreWebView2OriginFeatureState.Disabled для источника, проверки репутации фишинга и вредоносных программ для этого источника обходят стороной. Если эта функция не настроена для источника, CoreWebView2Settings.IsReputationCheckingRequired применяется глобальный параметр. Предпочтение на уровне процесса браузера применяется ко всем процессам, использующим его.

Если CoreWebView2Settings.IsReputationCheckingRequired задано значение false, параметр CoreWebView2OriginFeatureState.Enabled для источника не позволяет повторно включить проверку репутации для этого источника; CoreWebView2Settings.IsReputationCheckingRequired имеет приоритет.

Более старые поддерживаемые API:

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

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

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

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

Только для среды выполнения
  • Исправлено повторное вхоление для удаления кадра.
  • Исправлен доступ к оболочке объекта для файла авторизации пользователя (UAF).
  • Пометка авторитарного источника браузера в хост-канале, чтобы предотвратить подделку WebMessageReceivedEventArgs.Source .
  • Ограничил доступ к одноэлементным хост-каналу в устаревшей версии WebView2.
  • Удален origin параметр из методов, обращаюющихся к собственному объекту.
  • Усиленное применение виртуального узла kDeny WebView2 к спуфингу отрисовщика и побегам соединения с файловой системой новой технологии (NTFS).
  • Исправлено дерево модель автоматизации пользовательского интерфейса из окна в визуальный элемент (UIA).
  • Исправлена регрессия в AddScriptToExecuteOnDocumentCreated API.
  • Реализовано OnRendererResponsive для отслеживания результатов зависания.

Выпуск пакета SDK 1.0.4078.44 для среды выполнения 150 (7 июля 2026 г.)

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

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

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

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

Среда выполнения WebView2 меняется на 2-недельную периодичность выпуска

См . статью Среда выполнения WebView2 меняется на 2-недельную периодичность выпуска в разделе Предварительные выпуски выше.

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

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

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

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

Только для среды выполнения
  • Исправлено повторное вхоление для удаления кадра.
  • Исправлен доступ к оболочке объекта для файла авторизации пользователя (UAF).
  • Пометка авторитарного источника браузера в хост-канале, чтобы предотвратить подделку WebMessageReceivedEventArgs.Source .
  • Ограничил доступ к одноэлементным хост-каналу в устаревшей версии WebView2.
  • Удален origin параметр из методов, обращаюющихся к собственному объекту.
  • Усиленное применение виртуального узла kDeny WebView2 к спуфингу отрисовщика и побегам соединения с файловой системой новой технологии (NTFS).
  • Исправлено дерево модель автоматизации пользовательского интерфейса из окна в визуальный элемент (UIA).
  • Исправлена регрессия в AddScriptToExecuteOnDocumentCreated API.

Предварительный выпуск пакета SDK 1.0.4071-prerelease для среды выполнения 150 (11 июня 2026 г.)

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

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

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

Критические изменения

Включение поддержки рукописного ввода оболочки Windows для WebView2 в режиме WindowToVisual

WebView2 представляет поддержку рукописного ввода оболочки Windows (рукописный ввод пера в текст) для редактирования полей в экземплярах WebView2, размещенных в режиме "окно в визуальный" (WindowToVisual) в Windows.

Это изменение затрагивает только WindowToVisual режим размещения. WindowToWindow Режим размещения уже поддерживает рукописный текст оболочки Windows, а VisualToVisual режим размещения не поддерживается этим изменением.

Перед этим изменением: WebView2 в WindowToVisual режиме не регистрирует в ITfHandwritingSink потоке платформы текстовых служб (TSF). Почерк оболочки Windows по-прежнему может работать, но для определения целевого объекта рукописного ввода используется путь на основе модель автоматизации пользовательского интерфейса ОС (UIA).

После этого изменения: если msAbydosForWindowlessWV2 флаг функции отключен, поведение остается таким же, как и до этого изменения, включая путь определения целевого объекта для рукописного ввода на основе UIA.

msAbydosForWindowlessWV2 Если флаг функции включен, WebView2 в WindowToVisual режиме регистрирует экземпляр ITfHandwritingSink в потоке TSF. Это позволяет использовать рукописный текст оболочки Windows для редактирования полей в WebView2 и изменяет маршрутизацию событий рукописного ввода TSF в общем потоке TSF.

Если приложение уже зарегистрировано в ITfHandwritingSink потоке TSF, рукописный ввод пера будет по-прежнему работать для собственных полей редактирования приложения, а рукописный ввод пера также будет работать в полях редактирования WebView2.

Если приложение не регистрирует собственное ITfHandwritingSink, рукописный ввод пера может перестать работать для собственных полей редактирования приложения после включения этого изменения по умолчанию. Это происходит из-за того, что WebView2 возвращает E_NOTIMPL для HWND, которыми он не владеет, ожидая, что TSF будет цепочки в другой зарегистрированный приемник. Если приемник узла не зарегистрирован, TSF не возвращается к целевому разрешению рукописного ввода на основе UIA по умолчанию.

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

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

set WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS=--enable-features=msAbydosForWindowlessWV2

В выпусках 149 и 150 msAbydosForWindowlessWV2 флаг функции по умолчанию отключен, что дает приложениям время на упреждающее тестирование. Начиная с выпуска 151, эту функцию планируется включить по умолчанию.

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

См. также:

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

Устаревание пакета NuGet DevToolsProtocolExtension

Пакет NuGet для DevToolsProtocolExtension 1.0.2901

Пакет Microsoft.Web.WebView2.DevToolsProtocolExtension NuGet не рекомендуется использовать, и дальнейшие версии этого пакета не будут опубликованы. Эта устаревшая версия не связана ни с каким пакетом SDK для выпуска WebView2 или пакетом SDK для предварительной версии.

Пакет DevToolsProtocolExtension предоставляет строго типизированную оболочку .NET по протоколу Chrome DevTools (CDP) для использования в приложениях WebView2. Существующие опубликованные версии (1.0.824, 1.0.2271и 1.0.2901) остаются доступными в коллекции NuGet и не удаляются.

См. также:

Рекомендуемая альтернатива:

Все вызовы CDP можно выполнять непосредственно через API CDP WebView2, не используя пакет расширения. См . статью Использование протокола Chrome DevTools (CDP) в приложениях WebView2 и следующее:

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

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

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

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

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

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

Среда выполнения и пакет SDK
  • Добавлены гистограммы total-count для попыток создания среды WebView2 и контроллера.
Только для среды выполнения
  • Сопоставлено TERMINATION_STATUS_LAUNCH_FAILED_OS_POLICY с kLaunchFailed.
  • Обновлена классификация причин сбоя до OOM, для процесса, который был уничтожен для восстановления памяти.
  • Добавлен snapshot системной памяти во время обнаружения нехватки памяти (OOM) для анализа.
  • Исправлено автоматическое закрытие всплывающего окна, когда узел ожидает, что всплывающее окно останется открытым.
  • Добавлен доверенный источник проверка при доступе к объекту узла.
  • Сокращение избыточных подстановок карты в диспетчере запросов URL-адресов WebView2 для повышения производительности.
  • Устранены ненужные выделения строк на уровне файлов cookie WebView2 для повышения производительности.
Только пакет SDK
  • Исправлены проблемы с безопасностью контейнера в коде кадра и прослушивателя WebView2.
  • Подписка на события WinRT теперь поддерживает оболочку проекции до тех пор, пока обработчик не будет отменен.

Выпуск пакета SDK 1.0.4022.49 для среды выполнения 149 (11 июня 2026 г.)

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

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

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

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

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

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

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

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

  • События жизненного цикла: Мониторинг создания и уничтожения рабочих ролей.
  • Интерфейсы обмена сообщениями: Обмен данными с рабочими ролей с помощью PostMessage и WebMessageReceived; в частности:
    • CoreWebView2ServiceWorker.PostWebMessageAsJson
    • CoreWebView2ServiceWorker.PostWebMessageAsString
    • CoreWebView2DedicatedWorker.PostWebMessageAsJson
    • CoreWebView2DedicatedWorker.PostWebMessageAsString
    • CoreWebView2ServiceWorker.WebMessageReceived
    • CoreWebView2DedicatedWorker.WebMessageReceived
    • chrome.webview.postMessage
    • Не: chrome.webview.postMessageWithAdditionalObjects
  • Управление рабочей ролью. Запрос и получение регистраций и экземпляров рабочих ролей.

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

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

Только для среды выполнения
  • Сопоставлено TERMINATION_STATUS_LAUNCH_FAILED_OS_POLICY с kLaunchFailed.
  • Обновлена классификация причин сбоя до OOM, для процесса, который был уничтожен для восстановления памяти.
  • Добавлен доверенный источник проверка при доступе к объекту узла.
  • Исправлено, что раскрывающийся список диалогового окна "Печать " не выбран в WebView2CompositionControl. (Выпуск No 5195)
Только пакет SDK
  • Исправлены проблемы с безопасностью контейнера в коде кадра и прослушивателя WebView2.

Предварительный выпуск пакета SDK 1.0.4015-prerelease для среды выполнения 149 (11 мая 2026 г.)

Дата выпуска: 11 мая 2026 г.

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

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

Критические изменения

EnhancedSecurityModeLevel Заменены EnhancedSecurityModeState

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

Старое свойство , определяет, CoreWebView2Profile.EnhancedSecurityModeLevelвключен ли режим повышенной безопасности (ESM) для всех экземпляров WebView2, связанных с профилем. Это свойство было переименовано в EnhancedSecurityModeState, чтобы более четко сообщать о состоянии режима повышенной безопасности.

Перед этим изменением: Свойство CoreWebView2Profile.EnhancedSecurityModeLevel использовало перечисление CoreWebView2EnhancedSecurityModeLevel со значениями Off и Strict.

После этого изменения: Свойство CoreWebView2Profile.EnhancedSecurityModeState использует перечисление CoreWebView2EnhancedSecurityModeState со значениями Disabled и Enabled:

  • CoreWebView2EnhancedSecurityModeState.Disabled — Режим повышенной безопасности отключен.

    • CoreWebView2EnhancedSecurityModeLevel.OffЗаменяет .

  • CoreWebView2EnhancedSecurityModeState.Enabled — включен режим повышенной безопасности.

    • Отключает JIT-компиляцию JavaScript.
    • Включает дополнительную защиту операционной системы.
    • CoreWebView2EnhancedSecurityModeLevel.StrictЗаменяет .

См. также:

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

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

Состояние режима повышенной безопасности

Свойство EnhancedSecurityModeState в CoreWebView2Profile определяет, включен или отключен расширенный режим безопасности (ESM) для всех экземпляров WebView2, связанных с профилем.

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

Значение по умолчанию — Disabled. Изменения сразу же применяются к новым навигациям; существующие страницы требуют перезагрузки.

Этот параметр не сохраняется и сбрасывается при уничтожении и повторном создании профиля.

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

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

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

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

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

  • События жизненного цикла: Мониторинг создания и уничтожения рабочих ролей.
  • Интерфейсы обмена сообщениями: Обмен данными с рабочими ролей с помощью PostMessage и WebMessageReceived; в частности:
    • CoreWebView2ServiceWorker.PostWebMessageAsJson
    • CoreWebView2ServiceWorker.PostWebMessageAsString
    • CoreWebView2DedicatedWorker.PostWebMessageAsJson
    • CoreWebView2DedicatedWorker.PostWebMessageAsString
    • CoreWebView2ServiceWorker.WebMessageReceived
    • CoreWebView2DedicatedWorker.WebMessageReceived
    • chrome.webview.postMessage
    • Не: chrome.webview.postMessageWithAdditionalObjects
  • Управление рабочей ролью. Запрос и получение регистраций и экземпляров рабочих ролей.

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

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

Только для среды выполнения
  • Исправлены двойные символы в UWP.
  • Исправлены элементы управления заголовками ДЛЯ НАСТРОЙКИ цвета фона. После этого изменения приложения также должны будут перехватывать вызов close и обрабатывать себя, чтобы закрыть приложение.
  • Исправлена пересылка сетевых событий для iframe, где у iframe был собственный изолированный сеанс CDP.
  • Улучшена обработка ошибок при вызове post message (например CoreWebView2ServiceWorker.PostWebMessageAsJson , или chrome.webview.postMessage) в рабочей роли службы.
  • Сокращено выделение строк в GetDefaultHostAppExeName.
  • Исправлена проблема, из-за которой используемая в данный момент среда выполнения WebView2 удаляется после установки новой версии, что приводило к сбою во время создания нового контроллера в уже работающем приложении.

Выпуск пакета SDK 1.0.3967.48 для среды выполнения 148 (11 мая 2026 г.)

Дата выпуска: 11 мая 2026 г.

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

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

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

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

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

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

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

Предварительный выпуск пакета SDK 1.0.3965-prerelease для среды выполнения 148 (13 апреля 2026 г.)

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

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

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

Критические изменения

Причины сбоя детализированного процесса для ProcessFailed события

Событие ProcessFailed возникает, когда процесс, связанный с WebView2 (например, отрисовщик или процесс GPU), неожиданно завершает работу, что позволяет приложениям реагировать с помощью логики восстановления или диагностика.

Перед этим изменением: CoreWebView2ProcessFailedEventArgs.Reason свойство, возвращаемое Unexpected для трех различных сценариев выхода (обычный выход, аномальный выход и сбой целостности кода), что делает невозможным для приложений различать их.

После этого изменения: если msWebView2GranularProcessFailedReason флаг компонента включен, CoreWebView2ProcessFailedEventArgs.Reason свойство возвращает следующие новые детализированные CoreWebView2ProcessFailedReason значения перечисления Unexpectedвместо :

  • NormalExit — процесс завершился нормально (код выхода 0).

  • AbnormalExit — процесс завершился аномально (код выхода, отличный от нуля), но не завершился сбоем или не был завершен.

  • IntegrityFailure — ОС прекратила процесс из-за сбоя целостности кода, например из-за сбоя проверки целостности кода Windows dll.

Флаг msWebView2GranularProcessFailedReason функции отключен по умолчанию в выпусках 148 и 149, что дает приложениям два выпуска для упреждающего тестирования. Начиная с выпуска 150 функция будет включена по умолчанию, и приложения получат детализированные значения. Чтобы проверить поведение приложения WebView2, включите флаг компонента следующим образом:

set WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS=--enable-features=msWebView2GranularProcessFailedReason

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

См. также:

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

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

API конфигурации источника для WebView2

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

Используйте метод on SetOriginFeaturesCoreWebView2Profile для настройки параметров компонентов для одного или нескольких источников. Источники можно указать в виде точных строк (например https://contoso.com, ) или шаблонов с подстановочными знаками (например https://[*.]contoso.com, ) для сопоставления поддоменов, протоколов или портов.

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

Используется GetEffectiveFeaturesForOrigin для асинхронного получения параметров вычисляемых компонентов для заданного источника.

Этап 2 (стабильный в предварительной версии)

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

Причины сбоя детализированного процесса для ProcessFailed события

Дополнил элемент перечисления CoreWebView2ProcessFailedReason.Unexpected , добавив более детализированные значения для перечисления CoreWebView2ProcessFailedReason , возвращаемого свойством CoreWebView2ProcessFailedEventArgs.Reason .

Это критическое изменение; См . раздел Причины сбоя детализированного процесса для ProcessFailed события выше.

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

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

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

  • Исправлены проблемы с выбором раскрывающегося списка диалогового окна печати в WebView2CompositionControl. (Выпуск No 5195)

  • Отключен компонент "Действия домена" для WebView2.

  • Отключено WebUSBDetector уведомление для WebView2.

  • Исправлено устаревшее ICoreWebView2Profile3::get_PreferredTrackingPreventionLevel.

  • Исправлена проблема, когда клиентам WDP не удается подключиться к удаленному серверу отладки.

  • Исправлена проблема с примером приложения WPF, из-за которой закрытие окна оставляло затяжной процесс WPF.

Только пакет SDK
  • Включено ведение журнала гистограмм для сбоев процесса браузера в WebView2.

Выпуск пакета SDK 1.0.3912.50 для среды выполнения 147 (13 апреля 2026 г.)

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

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

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

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

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

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

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

Только для среды выполнения

  • Отключен компонент "Действия домена" для WebView2.

  • Исправлена проблема, когда клиентам WDP не удается подключиться к удаленному серверу отладки.

Предварительный выпуск пакета SDK 1.0.3908-prerelease для среды выполнения 147 (16 марта 2026 г.)

Дата выпуска: 16 марта 2026 г.

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

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

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

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

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

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

Управление разрешениями на постоянное хранилище для веб-содержимого

Разрешение PersistentStorage позволяет приложению WebView2 обрабатывать запросы из веб-содержимого для сохранения данных, созданных API хранилища, рабочими возможностями обслуживания и связанными технологиями. Разрешение PersistentStorage является членом перечисления в перечислении CoreWebView2PermissionKind .

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

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

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

Только для среды выполнения

  • Исправлена ошибка, из-за которой отключение экрана неправильно изменяло разрешение экрана.

  • Исправлено разрешение на каждый монитор в window.getScreenDetails(). (Проблема No 4826)

  • Отключен компонент действий домена для WebView2.

  • Исправлен сбой API печати в PDF при печати PDF-файлов. (Проблема No 5499)

  • Исправлена проблема, из-за которой экранный диктор объявлял структурный HWND, у которого нет пользовательского интерфейса.

  • Исправлена прозрачность WebView2.

  • Исправлен API для настройки цвета фона элемента управления Субтитры .

Выпуск пакета SDK 1.0.3856.49 для среды выполнения 146 (16 марта 2026 г.)

Дата выпуска: 16 марта 2026 г.

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

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

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

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

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

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

Только для среды выполнения

Предварительный выпуск пакета SDK 1.0.3848-prerelease для среды выполнения 146 (16 февраля 2026 г.)

Дата выпуска: 16 февраля 2026 г.

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

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

Критические изменения

Включение API JavaScript для WebView2 для рабочих ролей служб

Новый AreWebViewScriptApisEnabledForServiceWorkers параметр предоставляет явный и надежный способ управления доступностью API JavaScript для WebView2 (chrome.webview) в сценариях рабочей роли службы.

Этот параметр отключен по умолчанию для приложений WebView2. Приложения, явно не включающие этот параметр, не будут иметь доступа к API JavaScript для WebView2 в сценариях рабочей роли службы. В результате взаимодействие на основе chrome.webview.postMessage рабочей роли службы с ведущим приложением WebView2 не будет работать, если параметр не включен.

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

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

AreWebViewScriptApisEnabledForServiceWorkers = true

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

В настоящее chrome время объекты и chrome.webview доступны скриптам рабочей роли службы при использовании ServiceWorkerRegistered события. Однако начиная со следующего выпуска параметр будет единственным механизмом, AreWebViewScriptApisEnabledForServiceWorkers определяющим, предоставляются ли эти объекты скриптам рабочей роли службы. Протестируйте этот параметр перед следующим выпуском и сообщите о возникших проблемах. Дополнительные сведения см. в разделе [Критическое изменение] Включение API JavaScript для WebView2 для рабочих ролей служб.

См. также сведения о том, включены ли API-интерфейсы скриптов WebView для рабочих ролей служб ниже.

Доступ к локальной сети (LNA) в WebView2

Подсистема браузера Chromium представила доступ к локальной сети (LNA). LNA — это функция безопасности, которая запрещает веб-страницам отправлять запросы к ресурсам частной или локальной сети, если веб-страница не имеет явного разрешения на доступ к ресурсам частной или локальной сети. Примерами таких ресурсов являются localhost, 192.168.*или 10.*.

В настоящее время LNA отключена по умолчанию для приложений WebView2, но вы можете включить поддержку LNA с помощью флага msWebViewAllowLocalNetworkAccessChecks . В настоящее время для приложений WebView2 никаких действий не требуется. Сведения о флаге см. в разделе Доступные флаги браузера WebView2 в флагах браузера WebView2.

После того как вышестоящий, Chromium база кода стабилизируется, мы планируем добавить в перечисление CoreWebView2PermissionKind дополнительные значения перечисления для поддержки SetPermissionState LNA с помощью метода . Эти новые значения перечисления будут использоваться событием UWP WebView.PermissionRequested , чтобы предоставить приложению WebView2 явный контроль над функцией доступа к локальной сети (LNA).

Вы можете заранее протестировать функцию доступа к локальной сети (LNA) в приложении WebView2. Чтобы протестировать приложение с помощью функции LNA, запустите приложение WebView2 со следующим флагом:

--enable-features=LocalNetworkAccessChecks,msWebViewAllowLocalNetworkAccessChecks

Протестировав приложение при запуске с этим флагом, вы можете определить все рабочие процессы, на которые может повлиять функция LNA.

После стабилизации функции LNA мы поделимся обновленным временная шкала для включения функции LNA. Дополнительные сведения см . в разделе [Критическое изменение] Доступ к локальной сети (LNA) в WebView2 — план развертывания.

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

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

Управление включением API скриптов WebView для рабочих ролей служб

AreWebViewScriptApisEnabledForServiceWorkers Используйте свойство в , CoreWebView2Profile чтобы управлять включением API скриптов WebView для рабочих ролей служб.

См. также включение API JavaScript для WebView2 для рабочих ролей служб выше.

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

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

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

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

Только для среды выполнения

  • Исправлено исчезновение панели инструментов PDF при удалении всех параметров в регионе. (Проблема No 4738)

  • Исправлена белая вспышка, возникавшая, когда поиск Windows стал видимым после скрытия.

  • Исправлена тень строки заголовка, чтобы она не отображалась в прозрачном элементе управления WebView2. (Проблема No 5492)

  • Исправлена прозрачность WebView2.

  • Исправлена проблема с запросами доступа к локальной сети (LNA) путем отключения проверок LNA в WebView2.

Выпуск пакета SDK 1.0.3800.47 для среды выполнения 145 (16 февраля 2026 г.)

Дата выпуска: 16 февраля 2026 г.

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

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

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

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

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

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

Только для среды выполнения

  • Исправлена тень строки заголовка, чтобы она не отображалась в прозрачном элементе управления WebView2. (Проблема No 5492)

  • Исправлена проблема с запросами доступа к локальной сети (LNA) путем отключения проверок LNA в WebView2.

  • Исправлена прозрачность WebView2.

Предварительный выпуск пакета SDK 1.0.3796-prerelease для среды выполнения 145 (19 января 2026 г.)

Дата выпуска: 19 января 2026 г.

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

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

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

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

Уровень расширенного режима безопасности

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

Чтобы управлять уровнем ESM для всех экземпляров WebView2 с одинаковым профилем EnhancedSecurityModeLevel , используйте свойство в CoreWebView2Profile (или ICoreWebView2ExperimentalProfile9):

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

  • Используйте значение для Strict включения повышенной безопасности для всех сайтов. Это отключает JIT-компиляцию и применяет дополнительные средства защиты на уровне ОС, повышая безопасность, но потенциально снижая производительность JavaScript.

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

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

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

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

Только для среды выполнения
  • Исправлена chrome.webview недоступность.
  • Отключено фоновое обновление сетевого времени.
Только пакет SDK

Выпуск пакета SDK 1.0.3719.77 для среды выполнения 144 (27 января 2026 г.)

Дата выпуска: 27 января 2026 г.

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

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

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

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

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

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

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

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

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

Только для среды выполнения
  • Исправлена chrome.webview недоступность.
Только пакет SDK

Предварительный выпуск пакета SDK 1.0.3712-prerelease для среды выполнения 144 (8 декабря 2025 г.)

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

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

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

Экспериментальные API (этап 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командной строки .

Выпуск пакета SDK 1.0.3650.58 для среды выполнения 143 (8 декабря 2025 г.)

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

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

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

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

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

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

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

Предварительный выпуск пакета SDK 1.0.3650-prerelease для среды выполнения 143 (7 ноября 2025 г.)

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

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

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

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

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

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

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

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

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

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

Выпуск пакета SDK 1.0.3595.46 для среды выполнения 142 (3 ноября 2025 г.)

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

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

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

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

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

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

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

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

Предварительный выпуск пакета SDK 1.0.3590-prerelease для среды выполнения 142 (7 октября 2025 г.)

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

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

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

Экспериментальные API (этап 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.

Выпуск пакета SDK 1.0.3537.50 для среды выполнения 141 (6 октября 2025 г.)

Дата выпуска: 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.

Предварительный выпуск пакета SDK 1.0.3530-prerelease для среды выполнения 141 (8 сентября 2025 г.)

Дата выпуска: 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 (этап 1. Экспериментальные в предварительной версии)

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

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

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

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

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

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

Выпуск пакета SDK 1.0.3485.44 для среды выполнения 140 (8 сентября 2025 г.)

Дата выпуска: 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 для выпуска нет исправлений ошибок.

Предварительный выпуск пакета SDK 1.0.3477-prerelease для среды выполнения 140 (11 августа 2025 г.)

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

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

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

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

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

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

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

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

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

Предварительный выпуск пакета SDK 1.0.3415-prerelease для Среды выполнения 140 (14 июля 2025 г.)

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

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

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

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

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

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

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

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

  • События жизненного цикла: Мониторинг создания и уничтожения рабочих ролей.
  • Интерфейсы обмена сообщениями: Обмен данными с рабочими ролей с помощью PostMessage и WebMessageReceived; в частности:
    • CoreWebView2ServiceWorker.PostWebMessageAsJson
    • CoreWebView2ServiceWorker.PostWebMessageAsString
    • CoreWebView2DedicatedWorker.PostWebMessageAsJson
    • CoreWebView2DedicatedWorker.PostWebMessageAsString
    • CoreWebView2ServiceWorker.WebMessageReceived
    • CoreWebView2DedicatedWorker.WebMessageReceived
    • chrome.webview.postMessage
    • Не: chrome.webview.postMessageWithAdditionalObjects
  • Управление рабочей ролью. Запрос и получение регистраций и экземпляров рабочих ролей.
Отрисовка настраиваемых строк заголовков (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.

Выпуск пакета SDK 1.0.3405.78 для среды выполнения 139 (11 августа 2025 г.)

Дата выпуска: 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.

См. также

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

  • Last updated on