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

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

  • Статья

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

1.0.3065.39

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

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

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

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

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

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

Только для среды выполнения
  • Добавлена недостающая кнопка Закрыть во всплывающем элементе Скачать .
  • Исправлено состояние гонки, которое возникало, когда событие ответа веб-запроса никогда не возникало.

1.0.3116-prerelease

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

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

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

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

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

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

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

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

Только для среды выполнения
  • Добавлена недостающая кнопка Закрыть во всплывающем элементе Скачать .
  • Исправлено состояние гонки, которое возникало, когда событие ответа веб-запроса никогда не возникало.
Только пакет SDK
  • Исправлена документация CoreWebView2Find.FindNext по .NET и Win32 метода, в котором неправильно упоминалось FindPrevious. В сводке метода теперь упоминается FindNext . (Проблема No 5059)

1.0.2957.106

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

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

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

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

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

Отображение элементов WPF поверх слоя WebView2 (WebView2CompositionControl)

Не WebView2CompositionControl позволяет элементу управления WebView2 быть самым верхним слоем в приложении WPF и скрыть все элементы WPF. Microsoft.Web.WebView2.Wpf.WebView2CompositionControl является заменой стандартного элемента управления WEBView2 WPF. Как элемент управления WebView2, так и WebView2CompositionControl реализация Microsoft.Web.WebView2.Wpf.IWebView2 интерфейса. Оба они являются производными от FrameworkElement, как показано ниже.

  • FrameworkElement ->HwndHost ->WebView2.
  • FrameworkElement ->Control ->WebView2CompositionControl.

Фон. Если вы создаете приложение Windows Presentation Foundation (WPF) и используете элемент управления WebView2, вы можете обнаружить, что в приложении возникают проблемы с "воздушным пространством", когда элемент управления WebView2 всегда отображается сверху, скрывая все элементы WPF в том же расположении, даже если вы пытаетесь указать элементы WPF над элементом управления WebView2 (с помощью визуального порядка дерева или свойства z-index. например).

Эта проблема возникает из-за того, что элемент управления WPF использует WPF HwndHost для размещения элемента управления Win32 WebView2 и HwndHost имеет проблему с воздушным пространством.

См. также:

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

Только для среды выполнения
  • Исправлена регрессия, из-за которой изменения отображения могли привести к тому, что WebView2 отрисовывается меньше окна приложения.
Только пакет SDK
  • Исправлена проблема в WPFWebView2CompositionControl, из-за которой он не отображался при инициализации с размером (0,0), например при инициализации TabControlв TabItem . (Проблема No 4941)

1.0.3079-prerelease

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

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

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

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

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

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

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

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

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

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

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

  • Используйте DragStarting в , ICoreWebView2ExperimentalCompositionController6 чтобы добавить обработчик событий, который вызывается при запуске операции перетаскивания.
  • Используйте ICoreWebView2ExperimentalDragStartingEventArgs для запуска собственной операции перетаскивания.
    • Используйте метод для GetDeferral выполнения любой асинхронной логики перетаскивания и последующего вызова в WebView.
    • Используйте свойство , Handled чтобы сообщить WebView2, следует ли использовать собственную логику перетаскивания.
Отслеживание журнала навигации для вложенных iframes (API FrameCreatedEvent)

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

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

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

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

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

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

Отображение элементов WPF поверх слоя WebView2 (WebView2CompositionControl)

Не WebView2CompositionControl позволяет элементу управления WebView2 быть самым верхним слоем в приложении WPF и скрыть все элементы WPF. Microsoft.Web.WebView2.Wpf.WebView2CompositionControl является заменой стандартного элемента управления WEBView2 WPF. Как элемент управления WebView2, так и WebView2CompositionControl реализация Microsoft.Web.WebView2.Wpf.IWebView2 интерфейса. Оба они являются производными от FrameworkElement, как показано ниже.

  • FrameworkElement ->HwndHost ->WebView2.
  • FrameworkElement ->Control ->WebView2CompositionControl.

Фон. Если вы создаете приложение Windows Presentation Foundation (WPF) и используете элемент управления WebView2, вы можете обнаружить, что в приложении возникают проблемы с "воздушным пространством", когда элемент управления WebView2 всегда отображается сверху, скрывая все элементы WPF в том же расположении, даже если вы пытаетесь указать элементы WPF над элементом управления WebView2 (с помощью визуального порядка дерева или свойства z-index. например).

Эта проблема возникает из-за того, что элемент управления WPF использует WPF HwndHost для размещения элемента управления Win32 WebView2 и HwndHost имеет проблему с воздушным пространством.

См. также:

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

Только для среды выполнения
  • Исправлена регрессия, из-за которой изменения отображения могли привести к тому, что WebView2 отрисовывается меньше, чем окно приложения.
  • Включена IsolateSandboxedIframes функция вышестоящий для WebView2.
  • Запрещено удаление рабочей роли службы при изменении версии.
  • API CleanUpSome в Hostobject теперь выполняет сборку мусора только для полной кучи. CleanUpSome удален из подсистемы V8.
  • Исправлена регрессия AreBrowserAcceleratorKeysEnabled. (Проблема No 5033)
  • Исправлена ошибка, IsDefaultDownloadDialogOpenChanged из-за которой не активировался при закрытии диалогового окна с помощью клавиатуры. (Проблема No 4807)
Только пакет SDK
  • Исправлена проблема в WPFWebView2CompositionControl, из-за которой он не отображался при инициализации с размером (0,0), например при инициализации TabControlв TabItem . (Проблема No 4941)

1.0.2903.40

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

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

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

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

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

Управление показом пользовательского интерфейса снимка экрана (событие ScreenCaptureStarting)

Добавлено новое ScreenCaptureStarting событие. Это событие возникает всякий раз, когда WebView2 и (или) iframe, соответствующий CoreWebView2Frame (или любому из его потомков iframe), запрашивает разрешение на использование API захвата экрана перед показом пользовательского интерфейса. Затем приложение может заблокировать отображение пользовательского интерфейса или разрешить отображение пользовательского интерфейса.

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

Только для среды выполнения
  • В диалоговом окне "Скачивание " разрешено получать начальное внимание на запуске.

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

  • Среда выполнения Microsoft Edge WebView2 больше не указана в разделе Параметры>Windows Приложения>Установленные приложения, так как это постоянный системный компонент.

1.0.2950-prerelease

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

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

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

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

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

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

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

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

Только для среды выполнения
  • В диалоговом окне "Скачивание " разрешено получать начальное внимание на запуске.
  • Исправлен сбой при отмене навигации по определенным сайтам в FrameNavigationStarting. (Проблема No 4843)
  • Отложена настройка контекстного меню при отображении меню выбора касания. (Проблема No 4737)
Только пакет SDK
  • Добавлена поддержка Arm64ec.
  • Исправлена проблема, из-за которой WebView2, выполняющийся в режиме "Окно в визуальный", не мог получать входные данные акселератора.

1.0.2849.39

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

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

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

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

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

Настройка предупреждения системы безопасности при сохранении файла (SaveFileSecurityCheckStarting событие)

Добавлено новое SaveFileSecurityCheckStarting событие. Приложение может зарегистрировать обработчик в этом событии, чтобы получить путь к файлу, расширение имени файла и сведения о URI источника документа. Затем можно применить собственные правила для выполнения таких действий:

  • Разрешить сохранение файла без предоставления пользовательского интерфейса предупреждения системы безопасности по умолчанию о политике типа файла.
  • Отмена сохранения.
  • Создайте собственный пользовательский интерфейс для управления политиками типа файлов среды выполнения.

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

Только для среды выполнения
  • Исправлена проблема с фокусом диалогового окна загрузки при нажатии клавиш TAB или SHIFT+TAB для переключения в элемент управления Webview2.
Только пакет SDK
  • Использование CoreWebView2.AddWebResourceRequestedFilter без CoreWebView2WebResourceRequestSourceKinds параметра теперь не рекомендуется. См. метод .NET CoreWebView2.AddWebResourceRequestedFilter.
  • Добавлена версия .NET 8 TargetFramework для WinRT на C#, включена совместимость AOT (на опережение) и отключена маршалинг среды выполнения.

1.0.2895-prerelease

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

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

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

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

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

RestartRequested событие, когда WebView2 необходимо перезапустить

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

  • High указывает, что приложение должно запрашивать у пользователей перезапуск как можно скорее.
  • Normal указывает, что приложение должно напоминать пользователям о необходимости перезапуска на основе наилучших усилий.

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

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

Управление тем, отображается ли пользовательский интерфейс снимка экрана (ScreenCaptureStarting событие)

Добавлено новое ScreenCaptureStarting событие. Это событие возникает всякий раз, когда WebView2 и (или) iframe, соответствующий CoreWebView2Frame (или любому из его потомков iframe), запрашивает разрешение на использование API захвата экрана перед показом пользовательского интерфейса. Затем приложение может заблокировать отображение пользовательского интерфейса или разрешить отображение пользовательского интерфейса.

Настройка предупреждения системы безопасности при сохранении файла (SaveFileSecurityCheckStarting событие)

Добавлено новое SaveFileSecurityCheckStarting событие. Приложение может зарегистрировать обработчик в этом событии, чтобы получить путь к файлу, расширение имени файла и сведения о URI источника документа. Затем можно применить собственные правила для выполнения таких действий:

  • Разрешить сохранение файла без предоставления пользовательского интерфейса предупреждения системы безопасности по умолчанию о политике типа файла.
  • Отмена сохранения.
  • Создайте собственный пользовательский интерфейс для управления политиками типа файлов среды выполнения.

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

Только пакет SDK
  • Исправлена несовместимость Arm64 с WindowsAppSDK 1.6.
  • Удален дополнительный WebView2Loader.dll в случае WinAppSDK.
  • Использование CoreWebView2.AddWebResourceRequestedFilter без CoreWebView2WebResourceRequestSourceKinds параметра теперь не рекомендуется. См. метод .NET CoreWebView2.AddWebResourceRequestedFilter.

1.0.2792.45

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

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

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

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

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

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

Только пакет SDK

1.0.2839-prerelease

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

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

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

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

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

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

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

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

Только для среды выполнения
  • Исправлена проблема, из-за которой фокусировка на элементе управления WebView2 в WinAppSDK с отключенным параметром Windows "Прокрутка неактивных окон" приводила к сбою прокрутки.
  • Заблокировано edge://wallet в WebView2. (Проблема No 4710)
  • После завершения создания контроллера была очищена переменная среды для цвета фона по умолчанию в элементах управления .NET WebView2.
  • Включена поддержка специальных возможностей для Webview2 в режиме визуального размещения.
  • Исправлена ошибка при удалении фильтра "запрошенный веб-ресурс" для нескольких источников, если один из них — Document.
  • Исправлена регрессия, когда DataList не отображалось в WinUI или других визуально размещенных экземплярах WebView2.
Только пакет SDK
  • Исправлена зависимость пакета SDK для проектов .NET. (Проблема No 4743)
  • Исправлена проблема совместимости при вызове GetAvailableBrowserVersionString() более старой версии WebView2Loader.dll. (Проблема No 4395)
  • Исправлены проблемы при компиляции кода, созданного wv2winrt, с параметрами cpp20 и /permissive- .
  • Добавлена версия .NET 8 TargetFramework для WinRT на C#, включена совместимость AOT (на опережение) и отключена маршалинг среды выполнения.

См. также