Заметки о выпуске для SDK WebView2
Эти заметки о выпуске содержат сведения о новых функциях и исправлениях ошибок, включенных в пакет SDK для выпуска WebView2 и пакет SDK предварительной версии WebView2.
1.0.2420.47
Дата выпуска: 25 марта 2024 г.
Пакет NuGet для пакета SDK Для WebView2 1.0.2420.47
Для полной совместимости API для этой версии пакета SDK для WebView2 требуется среда выполнения WebView2 версии 123.0.2420.47 или более поздней.
Рекламные акции
Следующие API были повышены до стабильных и теперь включены в этот пакет SDK для выпуска.
- Добавлен новый API для предоставления результатов тестирования попадания в регионах, содержащихся в WebView2. Этот API полезен для визуально размещенных приложений, которые хотят обрабатывать события мыши в не клиентской области окна WebView2.
CoreWebView2CompositionController
Класса:CoreWebView2NonClientRegionChangedEventArgs
Класса:Перечисление CoreWebView2NonClientRegionKind
Caption
Client
Nowhere
CoreWebView2Settings
Класса:
- Добавлено
FailureSourceModulePath
свойство вProcessFailedEventArgs
тип , чтобы указать полный путь к модулю, вызвавшего сбой в случае сбоев целостности кода Windows, то есть при завершении процесса сSTATUS_INVALID_IMAGE_HASH
.
CoreWebView2ProcessFailedEventArgs
Класса:
Исправления ошибок
Только пакет SDK
- Сборки .NET для WinForms и WPF теперь поставляются с включенной оптимизацией. (Проблема No 4409)
1.0.2470-prerelease
Дата выпуска: 25 марта 2024 г.
Пакет NuGet для пакета SDK Для WebView2 1.0.2470-prerelease
Для полной совместимости API для этой предварительной версии пакета SDK для WebView2 требуется среда выполнения WebView2 версии 124.0.2470.0 или более поздней.
Экспериментальные API-интерфейсы
В этот пакет SDK для предварительной версии добавлены следующие экспериментальные API.
- Поддержка полосы прокрутки наложения стиля Fluent.
CoreWebView2EnvironmentOptions
Класса:Перечисление CoreWebView2ScrollbarStyle
Default
FluentOverlay
- Обновлен API WebMessageObjects, чтобы разрешить внедрение объектов DOM в содержимое WebView2, созданное с помощью приложения и
CoreWebView2.PostWebMessage
API в другом направлении. Добавлен новый тип веб-объекта для представления дескриптора файловой системы, который может быть размещен в веб-содержимом, чтобы предоставить ему доступ к файловой системе.
CoreWebView2
Класса:CoreWebView2Environment
Класса:CoreWebView2FileSystemHandle
Класса:Перечисление CoreWebView2FileSystemHandleKind
File
Directory
Перечисление CoreWebView2FileSystemHandlePermission
ReadOnly
ReadWrite
Рекламные акции
Следующие API были повышены с экспериментального на стабильный в этом предварительном пакете SDK.
- Добавлена функция выбора среды выполнения для поддержки дополнительных сценариев предварительного тестирования и тестирования. Вы можете указать
ReleaseChannels
, какие каналы будут искаться во время создания среды, иChannelSearchKind
выбрать порядок поиска.
CoreWebView2EnvironmentOptions
Класса:Перечисление CoreWebView2ChannelSearchKind
MostStable
LeastStable
Перечисление CoreWebView2ReleaseChannels
None
Stable
Beta
Dev
Canary
- Добавлено
FailureSourceModulePath
свойство вProcessFailedEventArgs
тип , чтобы указать полный путь к модулю, вызвавшего сбой в случае сбоев целостности кода Windows, то есть при завершении процесса сSTATUS_INVALID_IMAGE_HASH
.
CoreWebView2ProcessFailedEventArgs
Класса:
Исправления ошибок
Только для среды выполнения
- Исправлена регрессия надежности, которая могла завершаться сбоем процесса приложения при выгрузке старой версии клиентской библиотеки DLL WebView2.
- Убедитесь, что папка временной загрузки WebView2 является уникальной для каждой папки данных пользователя и не мешает работе других приложений или браузера.
1.0.2365.46
Дата выпуска: 26 февраля 2024 г.
Пакет NuGet для пакета SDK Для WebView2 1.0.2365.46
Для полной совместимости API этой версии пакета SDK для WebView2 требуется среда выполнения WebView2 версии 122.0.2365.46 или более поздней.
Рекламные акции
Следующие API были повышены до стабильных и теперь включены в этот пакет SDK для выпуска.
- Добавлена поддержка для
WebResourceRequested
рабочих ролей, которая позволяет задавать фильтры для полученияWebResourceRequested
событий для рабочих ролей обслуживания, общих рабочих ролей и iframe-разных источников.
CoreWebView2
Класса:CoreWebView2WebResourceRequestedEventArgs
Класса:
- Для поддержки расширений браузера в WebView2 добавлены для
GetBrowserExtensions
WinRT:
Исправления ошибок
Только для среды выполнения
Исправлена регрессия, влияющая на обработку
NewWindowRequested
события, когда в новом окне задано значение исходного WebView. (Проблема No 4250)Исправлена ошибка, из-за которой закрытие WebView со встроенным средством просмотра PDF-файлов могло привести к сбою. (Проблема No 3832)
Исправлена регрессия, из-за которой щелчки мышью перестали работать, когда приложение включило
SetWindowDisplayAffinity
. (Проблема No 4325)
1.0.2415-prerelease
Дата выпуска: 26 февраля 2024 г.
Пакет NuGet для пакета SDK Для WebView2 1.0.2415-prerelease
Для полной совместимости API этой предварительной версии пакета SDK для WebView2 требуется среда выполнения WebView2, которая поставляется с Microsoft Edge версии 123.0.2415.0 или более поздней.
Критические изменения
InitiatingOrigin
Поведение свойства объектаCoreWebView2LaunchingExternalUriSchemeEventArgs
изменилось.InitiatingOrigin
Если является непрозрачным источником, то источник,InitiatingOrigin
сообщающийся в аргументах события, является его предшественником. Источником-предшественником является источник, создавший непрозрачный источник. Например, если кадр, который находится вexample.com
, открывает подфрейм, имеющий другой непрозрачный источник, предшественником подфрейма будетexample.com
.
CoreWebView2LaunchingExternalUriSchemeEventArgs
Класса:
- Члены перечисления
CoreWebView2TextureStreamErrorKind
были переименованы:
Старые имена участников:
- Перечисление CoreWebView2TextureStreamErrorKind
CoreWebView2TextureStreamErrorNoVideoTrackStarted
CoreWebView2TextureStreamErrorTextureError
CoreWebView2TextureStreamErrorTextureInUse
Новые имена участников:
- Перечисление CoreWebView2TextureStreamErrorKind
NoVideoTrackStarted
TextureError
TextureInUse
Экспериментальные API-интерфейсы
В этот пакет SDK для предварительной версии добавлены следующие экспериментальные API.
- Класс
CoreWebView2ControllerOptions
теперь имеетAllowHostInputProcessing
свойство, которое позволяет пользователю ввести сообщения (клавиатура, мышь, сенсорный ввод и перо) через окно браузера, которые будут получены окном процесса приложения.
CoreWebView2ControllerOptions
Класса:
Рекламные акции
Следующие API были повышены с экспериментального на стабильный в этом предварительном пакете SDK.
- Добавлен новый API для предоставления результатов тестирования попадания в регионах, содержащихся в WebView2. Этот API полезен для визуально размещенных приложений, которые хотят обрабатывать события мыши в не клиентской области окна WebView2.
CoreWebView2CompositionController
Класса:CoreWebView2Settings
Класса:
Исправления ошибок
Только для среды выполнения
Исправлена возможность открытия камеры или микрофона в собраниях Google Meet или Microsoft Teams, когда для запроса разрешения задано значение "не сохраняется" (т. е
SavesInProfile = false
. ). (Проблема No 3592)Исправлено добавление пустого
--edge-webview-custom-scheme
параметра командной строки в процесс браузера WebView2.Отключен глобальный
UserDataFolder
раздел реестра, чтобы этот раздел реестра можно было применять только для каждого приложения.Исправлено
NewWindowRequested
событие, которое не запускалось при открытии расширением браузера. (Проблема No 3841)Исправлено
NewWindowRequested
событие, которое не запускается при открытии источника представления. (Проблема No 4162)Исправлена проблема с срабатыванием
StateChanged
иBytesReceivedChanged
событиями, когда скачивание связано с навигацией.Исправлена ошибка, из-за которой диалоговое
BeforeUnload
окно WebView2 неожиданно перепрыгивалось. (Проблема No 4350)Исправлена проблема, из-за которой
PrintAsync
пустая страница печаталась при вызове слишком быстро, прежде чем pdf-файл был полностью загружен. (Проблема No 3779)
1.0.2277.86
Дата выпуска: 5 февраля 2024 г.
Пакет NuGet для пакета SDK Для WebView2 1.0.2277.86
Для полной совместимости API этой версии пакета SDK для WebView2 требуется среда выполнения WebView2 версии 121.0.2277.86 или более поздней.
Критические изменения
Важно.
Критическое изменение. Переходы по about:blank
теперь можно отменить через NavigationStarting
событие. Чтобы отменить изменения к старому поведению, отключите msWebView2CancellableAboutNavigations
флаг функции.
Рекламные акции
Следующие API были повышены до стабильных и теперь включены в этот пакет SDK для выпуска.
ExecuteScriptWithResult
предоставляет сведения об исключении в случае сбоя скрипта.TryGetResultAsString
получает результат выполнения скрипта в виде строки, а не в формате JSON, чтобы было удобнее взаимодействовать со строковыми результатами:
CoreWebView2
Класса:
Исправления ошибок
Только для среды выполнения
Убедитесь, что язык проверки орфографии соответствует
put_Language
программно. Настраиваемое контекстное меню также обновляется с правильными проверками орфографии. (только для среды выполнения)Исправлена ошибка, из-за которой переставало запускать
NavigationCompleted
событие для некоторых веб-сайтов, загружающих видео в формате AV1. (только для среды выполнения) (Проблема No 3801)Исправлена проблема, из-за которой ресурсы COM хост-процесса освобождались во время сноса WebView. (только для среды выполнения) (Проблема No 4226)
Исправлена ошибка, которая нарушила загрузку некоторых приложений социальных сетей, таких как Facebook, Twitter и Linkedin. Это изменение зависит от среды выполнения. (только для среды выполнения) (Проблема No 4281)
1.0.2357-prerelease
Дата выпуска: 30 января 2024 г.
Пакет NuGet для пакета SDK Для WebView2 1.0.2357-prerelease
Для полной совместимости API этой предварительной версии пакета SDK для WebView2 требуется среда выполнения WebView2, которая поставляется с Microsoft Edge версии 122.0.2357.0 или более поздней.
Экспериментальные API-интерфейсы
В этот пакет SDK для предварительной версии добавлены следующие экспериментальные API.
- Добавлена функция выбора среды выполнения для поддержки дополнительных сценариев предварительного тестирования и тестирования. Разработчики могут указать
ReleaseChannels
, какие каналы будут искаться во время создания среды, иChannelSearchKind
выбрать порядок поиска.
- Добавлен новый API для предоставления результатов тестирования попадания в регионах, содержащихся в WebView2. Этот API полезен для визуально размещенных приложений, которые хотят обрабатывать события мыши в не клиентской области окна WebView2.
CoreWebView2CompositionController
Класса:CoreWebView2Settings
Класса:
Рекламные акции
Следующие API были повышены с экспериментального на стабильный в этом предварительном пакете SDK.
CoreWebView2AcceleratorKeyPressedEventArgs
имеет новоеIsBrowserAcceleratorKeyEnabled
свойство, позволяющее управлять тем, обрабатывает ли браузер клавиши акселератора (сочетания клавиш), такие как CTRL+P или F3:
CoreWebView2AcceleratorKeyPressedEventArgs
Класса:
- API сведений о кадрах, включая
GetProcessExtendedInfos
, предоставляет snapshot коллекцию всех кадров, которые активно выполняются в связанном процессе отрисовщика. Этот API позволяет ведущему приложению определять, какая часть WebView2 потребляет ресурсы, например память или ЦП:
CoreWebView2Environment
Класса:CoreWebView2ProcessExtendedInfo
Класса:CoreWebView2
Класса:CoreWebView2Frame
Класса:CoreWebView2FrameInfo
Класса:
ExecuteScriptWithResult
предоставляет сведения об исключении в случае сбоя скрипта.TryGetResultAsString
получает результат выполнения скрипта в виде строки, а не в формате JSON, чтобы было удобнее взаимодействовать со строковыми результатами:
CoreWebView2
Класса:
CreateFromComICoreWebView2
заключает в оболочку существующийICoreWebView2
CoreWebView2
объект в экземпляре, чтобы разработчики .NET могли взаимодействовать с элементом управления, созданным на C++.
CoreWebView2
Класса:
- Для поддержки расширений браузера в WebView2 добавлены для
GetBrowserExtensions
WinRT:
- Добавлена поддержка
WebResourceRequested
для рабочих ролей, которая позволяет задавать фильтры для полученияWebResourceRequested
событий для рабочих ролей обслуживания, общих рабочих ролей и различных iframes источника.
CoreWebView2
Класса:CoreWebView2WebResourceRequestedEventArgs
Класса:
Исправления ошибок
Только для среды выполнения
Исправлена ошибка, из-за которой закрытие элемента управления WebView, имеющего встроенное средство просмотра PDF, могло привести к сбою. (только для среды выполнения) (Проблема No 3832)
Исправлены проблемы с стеком значков панели задач дочернего процесса. (только для среды выполнения) (Проблема No 3245)
Исправлена ошибка, которая отправляла ненужный сетевой запрос для облачной службы конфигурации Edge. (только для среды выполнения) (Выпуск No 4180)
Обновлено поведение
app-region
свойства CSS, чтобы изменение его значения вызывало изменение макета страницы. (только для среды выполнения)Исправлена проблема,
put_AreBrowserAcceleratorKeysEnabled
из-за которой не удавалось обновить параметры для WebView2, если обработчик событий неAcceleratorKeyPressed
зарегистрирован. (только для среды выполнения) (Проблема No 4278)
Только пакет SDK
Исправлена проблема, из-за которой элементу управления WebView2 в .NET не удавалось найти
WebView2Loader.dll
по UNC-путям. (только пакет SDK) (Проблема No 4081)Исправлены некоторые проблемы, приводящие к возникновению экземпляров в элементах
InvalidOperationException
управления .NET, которые не были полезны разработчикам. (только пакет SDK) (Проблема No 4272)
1.0.2210.55
Дата выпуска: 11 декабря 2023 г.
Пакет NuGet для пакета SDK WebView2 1.0.2210.55
Для полной совместимости API этой версии пакета SDK для WebView2 требуется среда выполнения WebView2 версии 120.0.2210.55 или более поздней.
Критические изменения
Важно.
Критическое изменение. Если вы разрабатываете неупакованное приложение Win32 с помощью среды выполнения фиксированной версии версии 120 или более поздней версии и нацеливаетесь на Windows 10 устройства, необходимо выполнить несколько команд оболочки ACL (icacls
), чтобы избежать сбоя из-за новой функции безопасности, реализованной в WebView2. См . раздел [Критическое изменение] Неупакованное приложение Win32 с фиксированной версией 120+ в Win10 требует ACL. Исправление описано в статье Распространение приложения и среды выполнения WebView2, раздел Сведения о режиме распространения среды выполнения фиксированных версий, шаг "На устройствах Windows 10, начиная с фиксированной версии 120, разработчики неупакованных приложений Win32, использующие фиксированную версию, должны выполнять следующие команды".
Рекламные акции
Следующие API были повышены до стабильных и теперь включены в этот пакет SDK для выпуска.
- Поддержка расширений браузера в WebView2:
CoreWebView2EnvironmentOptions
Класса:CoreWebView2Profile
Класса:
- API сведений о кадрах, включая
GetProcessExtendedInfos
, предоставляет snapshot коллекцию всех кадров, которые активно выполняются в связанном процессе отрисовщика. Этот API позволяет ведущему приложению определять, какая часть WebView2 потребляет ресурсы, например память или ЦП:
CoreWebView2Environment
Класса:CoreWebView2ProcessExtendedInfo
Класса:CoreWebView2
Класса:CoreWebView2Frame
Класса:CoreWebView2FrameInfo
Класса:
ICoreWebView2AcceleratorKeyPressedEventArgs
имеет новоеIsBrowserAcceleratorKeyEnabled
свойство, позволяющее разработчикам управлять тем, обрабатывает ли браузер клавиши акселератора (сочетания клавиш), такие как CTRL+P или F3:
CoreWebView2AcceleratorKeyPressedEventArgs
Класса:
- Добавлена поддержка управления удалением профиля:
CoreWebView2Profile
Класса:
Исправления ошибок
Добавлена поддержка отмены обещаний для асинхронных методов объектов узла в проекции WinRT JS. Сведения о
AddHostObjectToScript
см. в разделе Вызов собственного кода WinRT из веб-кода. (среда выполнения и пакет SDK)Отключено автоматическое обновление HTTPS для навигации ПО API WebView2. (только для среды выполнения) (Проблема No 4104)
1.0.2151.40
Дата выпуска: 6 ноября 2023 г.
Пакет NuGet для пакета SDK Для WebView2 1.0.2151.40
Для полной совместимости API для этой версии пакета SDK для WebView2 требуется среда выполнения WebView2 версии 119.0.2151.40 или более поздней.
Общая доступность
Важно.
Объявление: пакет SDK для Xbox WebView2 теперь доступен в общедоступной версии и доступен на xbox 2310 октября (231018–2200). Дополнительные сведения см. в разделе Объявление WebView2 для Xbox.
Рекламные акции
Следующие API были повышены до стабильных и теперь включены в этот пакет SDK для выпуска.
- Добавлены сведения об исходном кадре в
NewWindowRequested
аргументы события, чтобы определить источник запроса:
CoreWebView2NewWindowRequestedEventArgs
Класса:
- Для WinRT добавлены параметры для управления регистрацией пользовательской
CoreWebView2Environment
схемы при создании :
CoreWebView2CustomSchemeRegistration
Класса:CoreWebView2EnvironmentOptions
Класса:
Исправления ошибок
- Исправлена проблема с надежностью, из-за которой несколько созданий WebView могли привести к сбою. (только для среды выполнения) (Проблема No 3793)
1.0.2194-prerelease
Дата выпуска: 6 ноября 2023 г.
Пакет NuGet для пакета SDK Для WebView2 1.0.2194-prerelease
Для полной совместимости API этой предварительной версии пакета SDK для WebView2 требуется среда выполнения WebView2, которая поставляется с Microsoft Edge версии 120.0.2194.0 или более поздней.
Рекламные акции
Следующие API были повышены с экспериментального на стабильный в этом предварительном пакете SDK.
- Поддержка расширений браузера в WebView2:
- Класс CoreWebView2BrowserExtension
CoreWebView2EnvironmentOptions
Класса:CoreWebView2Profile
Класса:
Исправления ошибок
- Исправлена проблема, из-за которой WebView2 иногда отображал размытое содержимое или не отображал содержимое после изменения масштаба монитора или переключения между режимами RDP и закрепления. (только для среды выполнения)
- Исправлена проблема,
TextServicesFoundation
вызывающая сбой при уничтожении экземпляра WebView2. (только для среды выполнения) - Устраняет утечку памяти в .NET, если веб-сообщения отправляются из WebView2, но не считываются со стороны приложения. (среда выполнения и пакет SDK) (Проблема No 3794)
- Исправлена проблема,
ScaleFactor
из-за которой параметр не работал должным образом для всех API-интерфейсов печати WebView2. (только для среды выполнения) (Проблема No 4082)
1.0.2088.41
Дата выпуска: 16 октября 2023 г.
Пакет NuGet для пакета SDK Для WebView2 1.0.2088.41
Для полной совместимости API этой версии пакета SDK для WebView2 требуется среда выполнения WebView2 версии 118.0.2088.41 или более поздней.
Рекламные акции
Дополнительные API не были повышены до стабильных и не добавлены в этот пакет SDK для выпуска.
Исправления ошибок
- Исправлена проблема, из-за которой некоторые приложения UWP не могут вводить текст. (только для среды выполнения) (Проблема No 3805)
- Исправлен сбой инициализации для приложений, использующих параметр совместимости Windows
PerProcessSystemDPIForceOff
. (только для среды выполнения) (Проблема No 3692) - Исправлена ошибка смещения положения диалога в WebView2. (только для среды выполнения) (Проблема No 3763)
1.0.2164-prerelease
Дата выпуска: 18 октября 2023 г.
Пакет NuGet для пакета SDK Для WebView2 1.0.2164-prerelease
Для полной совместимости API этой предварительной версии пакета SDK для WebView2 требуется среда выполнения WebView2, которая поставляется с Microsoft Edge версии 120.0.2164.0 или более поздней.
Экспериментальные API-интерфейсы
В этот пакет SDK для предварительной версии добавлены следующие экспериментальные API.
- Добавлено
FailureSourceModulePath
свойство вProcessFailedEventArgs
тип , чтобы указать полный путь к модулю, вызвавшего сбой в случае сбоев целостности кода Windows, то есть при завершении процесса сSTATUS_INVALID_IMAGE_HASH
.
CoreWebView2ProcessFailedEventArgs
Класса:
Исправления ошибок
- Добавлена поддержка дополнительных параметров страницы (
PageRange
иPagesPerSheet
) в API PrintToPDF. (только для среды выполнения) (Проблема No 3719) - Навигация по файлу ресурсов расширения была обработана неправильно и теперь исправлена с помощью правильного метода обработки. (только для среды выполнения) (Выпуск No 3728)
- Исправлена проблема, из-за которой некоторые приложения UWP не могут вводить текст. (только для среды выполнения) (Проблема No 3805)
- Исправлен сбой инициализации для приложений, использующих параметр совместимости Windows
PerProcessSystemDPIForceOff
. (только для среды выполнения) (Проблема No 3692) - Удалены мониторы, которые собирали данные при изменении параметра браузера по умолчанию. (только для среды выполнения)
- Исправлена ошибка смещения положения диалога в WebView2. (только для среды выполнения) (Проблема No 3763)
- Исправлен сбой
NewWindowRequested
в случае, еслиNewWindow
для задано значениеnull
. (только для среды выполнения)
См. также
- Сведения о заметках о выпуске пакета SDK для WebView2
- Архивные заметки о выпуске пакета SDK для WebView2
- Общие сведения о функциях и API WebView2 . В этой статье описываются многие API по областям функций, которые находятся в пакетах ПАКЕТА SDK для выпуска.
- Обращение к команде Microsoft Edge WebView2