Partilhar via

Notas de versão para o SDK do WebView2

  • Artigo

Estas Notas de Versão fornecem informações sobre novas funcionalidades e correções de erros incluídas no SDK de Versão webView2 e no SDK de Pré-lançamento webView2.

1.0.2957.106

Data de Lançamento: 20 de janeiro de 2025

Pacote NuGet para o SDK WebView2 1.0.2957.106

Para compatibilidade total com a API, esta versão de Versão do SDK WebView2 requer a versão 132.0.2957.106 ou superior do WebView2 Runtime.

Promoções

As seguintes APIs foram promovidas para Stable e estão agora incluídas neste SDK de Versão.

Mostrar elementos WPF na parte superior da camada WebView2 (WebView2CompositionControl)

O WebView2CompositionControl impede que o controlo WebView2 seja a camada superior de uma aplicação WPF e obscure todos os elementos WPF. Microsoft.Web.WebView2.Wpf.WebView2CompositionControl é uma substituição pendente para o controlo WPF WebView2 padrão. Tanto o controlo WebView2CompositionControl WebView2 como a implementação da Microsoft.Web.WebView2.Wpf.IWebView2 interface. Ambos derivam de , da FrameworkElementseguinte forma:

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

Fundo: se estiver a criar uma aplicação Windows Presentation Foundation (WPF) e a utilizar o controlo WebView2, poderá descobrir que a sua aplicação se depara com problemas de "espaço aéreo", em que o controlo WebView2 é sempre apresentado na parte superior, ocultando todos os elementos WPF na mesma localização, mesmo que tente especificar os elementos WPF para estarem acima do controlo WebView2 (utilizando a ordem da árvore visual ou a propriedade z-index, por exemplo).

Este problema ocorre porque o controlo WPF utiliza o WPF HwndHost para alojar o controlo Win32 WebView2 e HwndHost tem um problema com o espaço aéreo.

Consulte também:

Correções de erros

Apenas runtime
  • Foi corrigida uma regressão em que as alterações de apresentação podem fazer com que o WebView2 seja mais pequeno do que a janela da aplicação.
Apenas SDK
  • Foi corrigido um problema no WPF WebView2CompositionControl em que não é apresentado se for inicializado com o tamanho (0,0), como quando é inicializado num TabItem de um TabControl. (Problema n.º 4941)

1.0.3079-pré-lançamento

Data de Lançamento: 24 de janeiro de 2025

Pacote NuGet para o SDK WebView2 1.0.3079-prerelease

Para compatibilidade de API completa, esta versão de Pré-lançamento do SDK WebView2 requer o WebView2 Runtime que é fornecido com a versão 134.0.3079.0 ou superior do Microsoft Edge.

APIs experimentais

As seguintes APIs Experimentais foram adicionadas neste SDK de Pré-lançamento.

Personalizar o comportamento de Localizar (Localizar API)

A API Localizar permite-lhe controlar programaticamente as operações localizar e permite-lhe adicionar a seguinte funcionalidade à sua aplicação:

  • Personalize as opções Localizar, incluindo Localizar Termo, Sensibilidade a Maiúsculase Minúsculas, Correspondência de Word, Realce de Correspondência e Supressão de IU Predefinida.
  • Localize cadeias de texto e navegue entre elas num controlo WebView2.
  • Inicie programaticamente as operações localizar e navegue em Localizar resultados.
  • Suprimir a IU de Localização predefinida.
  • Controle a status das operações Localizar.

Existem problemas conhecidos com a API Localizar para documentos PDF. Quando vê um documento PDF num controlo WebView2, a funcionalidade Localizar fornece atualmente apenas o primeiro índice e o número de correspondências encontradas. Por exemplo, se a cadeia ocorrer três vezes num PDF, a IU diria 1/3 e não suportaria chamar programaticamente Seguinte ou Anterior. Estamos a investigar ativamente estes problemas e recomendamos que comunique quaisquer problemas que encontre com o repositório WebView2Feedback .

Personalizar o comportamento de arrastar e largar (ArrastarIniciar API)

A DragStarting API substitui o comportamento de arrastar e largar predefinido ao executar no modo de alojamento visual. O DragStarting evento notifica a sua aplicação quando o utilizador inicia uma operação de arrastar no WebView2 e fornece o estado necessário para substituir a operação de arrastar predefinida do WebView2 com a sua própria lógica.

  • Utilize DragStarting no ICoreWebView2ExperimentalCompositionController6 para adicionar um processador de eventos que é invocado quando a operação de arrastar está a iniciar.
  • Utilize ICoreWebView2ExperimentalDragStartingEventArgs para iniciar a sua própria operação de arrastar.
    • Utilize o GetDeferral método para executar qualquer lógica de arrastar assíncrona e chamar de volta para o WebView mais tarde.
    • Utilize a Handled propriedade para que o WebView2 saiba se pretende utilizar a sua própria lógica de arrastar.
Controlar o histórico de navegação de iframes aninhados (FrameCreatedEvent API)

A API FrameCreatedEvent suporta iframes aninhados, como gravar o histórico de navegação de um iframe de segundo nível. Sem esta API, o WebView2 apenas monitoriza iframes de primeiro nível, que são os iframes subordinados diretos da moldura main. Com esta API, a sua aplicação pode subscrever o evento de criação de iframe aninhado, dando à aplicação acesso a todas as propriedades, métodos e eventos de CoreWebView2Frame para o iframe aninhado.

Utilize esta API para gerir o controlo de iframe numa página que contém vários níveis de iframes. Pode optar por controlar qualquer um dos seguintes procedimentos:

  • Apenas a página main e os iframes de primeiro nível (o comportamento predefinido).
  • Uma árvore de frames WebView2 parcial com iframes específicos de interesse.
  • A árvore de molduras WebView2 completa.
Predefinir a cor de fundo na inicialização do WebView2 (DefaultBackgroundColor API)

A API DefaultBackgroundColor permite que os utilizadores definam a propriedade durante a DefaultBackgroundColor inicialização. Isto impede um flash branco disruptivo durante o processo de carregamento do WebView2.

Promoções

As seguintes APIs foram promovidas de Experimental para Stable neste SDK de Pré-lançamento.

Mostrar elementos WPF na parte superior da camada WebView2 (WebView2CompositionControl)

O WebView2CompositionControl impede que o controlo WebView2 seja a camada superior de uma aplicação WPF e obscure todos os elementos WPF. Microsoft.Web.WebView2.Wpf.WebView2CompositionControl é uma substituição pendente para o controlo WPF WebView2 padrão. Tanto o controlo WebView2CompositionControl WebView2 como a implementação da Microsoft.Web.WebView2.Wpf.IWebView2 interface. Ambos derivam de , da FrameworkElementseguinte forma:

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

Fundo: se estiver a criar uma aplicação Windows Presentation Foundation (WPF) e a utilizar o controlo WebView2, poderá descobrir que a sua aplicação se depara com problemas de "espaço aéreo", em que o controlo WebView2 é sempre apresentado na parte superior, ocultando todos os elementos WPF na mesma localização, mesmo que tente especificar os elementos WPF para estarem acima do controlo WebView2 (utilizando a ordem da árvore visual ou a propriedade z-index, por exemplo).

Este problema ocorre porque o controlo WPF utiliza o WPF HwndHost para alojar o controlo Win32 WebView2 e HwndHost tem um problema com o espaço aéreo.

Consulte também:

Correções de erros

Apenas runtime
  • Foi corrigida uma regressão em que as alterações de apresentação podem fazer com que o WebView2 seja mais pequeno do que a janela da aplicação.
  • Ativou a IsolateSandboxedIframes funcionalidade upstream para WebView2.
  • Impediu a eliminação de uma função de trabalho de serviço quando a versão é alterada.
  • A CleanUpSome API no Hostobject agora só faz a libertação da memória para a área dinâmica para dados completa. CleanUpSome foi removido do motor V8.
  • Foi corrigida uma regressão de AreBrowserAcceleratorKeysEnabled. (Problema n.º 5033)
  • Foi corrigido um erro em IsDefaultDownloadDialogOpenChanged que não era acionado quando uma caixa de diálogo era fechada com o teclado. (Problema n.º 4807)
Apenas SDK
  • Foi corrigido um problema no WPF WebView2CompositionControl em que não é apresentado se for inicializado com o tamanho (0,0), como quando é inicializado num TabItem de um TabControl. (Problema n.º 4941)

1.0.2903.40

Data de Lançamento: 18 de novembro de 2024

Pacote NuGet para o SDK WebView2 1.0.2903.40

Para compatibilidade total com a API, esta versão de Versão do SDK WebView2 requer a versão 131.0.2903.40 ou superior do WebView2 Runtime.

Promoções

As seguintes APIs foram promovidas para Stable e estão agora incluídas neste SDK de Versão.

Controlar se a IU de captura de ecrã é apresentada (evento ScreenCaptureStarting)

Foi adicionado um novo ScreenCaptureStarting evento. Este evento é gerado sempre que o WebView2 e/ou iframe que corresponde ao CoreWebView2Frame (ou a qualquer um dos respetivos iframes descendentes) pede permissão para utilizar a API de Captura de Ecrã antes de a IU ser apresentada. Em seguida, a aplicação pode bloquear a apresentação da IU ou permitir que a IU seja apresentada.

Correções de erros

Apenas runtime
  • Permitiu que a caixa de diálogo Transferir recebesse o foco inicial no lançamento.

Alterações gerais

  • O Microsoft Edge WebView2 Runtime já não está listado nasAplicações> de Definiçõesdo WindowsAplicações Instaladas>, porque é um componente de sistema persistente.

1.0.2950-pré-lançamento

Data de Lançamento: 18 de novembro de 2024

Pacote NuGet para o SDK WebView2 1.0.2950-prerelease

Para compatibilidade total com a API, esta versão de Pré-lançamento do SDK WebView2 requer o WebView2 Runtime que é fornecido com a versão 132.0.2950.0 ou superior do Microsoft Edge.

APIs experimentais

Não foram adicionadas APIs Experimentais neste SDK de Pré-lançamento.

Promoções

Não foram promovidas APIs de Experimental para Stable neste SDK de Pré-lançamento.

Correções de erros

Apenas runtime
  • Permitiu que a caixa de diálogo Transferir recebesse o foco inicial no lançamento.
  • Foi corrigida uma falha ao cancelar a navegação para determinados sites no FrameNavigationStarting. (Problema n.º 4843)
  • Foi adiada a personalização do menu de contexto quando o menu de seleção tátil está a ser apresentado. (Problema n.º 4737)
Apenas SDK
  • Suporte arm64ec adicionado.
  • Foi corrigido um problema em que o WebView2 em execução no modo "Janela para Elemento Visual" não conseguia receber a entrada do acelerador.

1.0.2849.39

Data de Lançamento: 21 de outubro de 2024

Pacote NuGet para o SDK WebView2 1.0.2849.39

Para compatibilidade total com a API, esta versão de Versão do SDK WebView2 requer a versão 130.0.2849.39 ou superior do WebView2 Runtime.

Promoções

As seguintes APIs foram promovidas para Stable e estão agora incluídas neste SDK de Versão.

Configurar o aviso de segurança ao guardar um ficheiro (SaveFileSecurityCheckStarting evento)

Foi adicionado um novo SaveFileSecurityCheckStarting evento. A sua aplicação pode registar um processador neste evento para obter o caminho do ficheiro, a extensão de nome de ficheiro e as informações do URI de origem do documento. Em seguida, pode aplicar as suas próprias regras para efetuar ações como as seguintes:

  • Permitir guardar o ficheiro sem apresentar uma IU de aviso de segurança predefinida sobre a política de tipo de ficheiro.
  • Cancele a gravação.
  • Crie a sua própria IU para gerir políticas de tipo de ficheiro de runtime.

Correções de erros

Apenas runtime
  • Foi corrigido um problema de foco na caixa de diálogo Transferir ao premir a Tecla de Tabulação ou Shift+Tecla de Tabulação para mudar para o controlo Webview2.
Apenas SDK
  • A utilização CoreWebView2.AddWebResourceRequestedFilter sem um CoreWebView2WebResourceRequestSourceKinds parâmetro foi preterida. Veja o Método .NET CoreWebView2.AddWebResourceRequestedFilter.
  • Foi adicionado o .NET 8 TargetFramework para WinRT C#, compatibilidade ativada do AOT (antecipadamente) e desativação da triagem de runtime.

1.0.2895-pré-lançamento

Data de Lançamento: 21 de outubro de 2024

Pacote NuGet para o SDK WebView2 1.0.2895-prerelease

Para compatibilidade de API completa, esta versão de Pré-lançamento do SDK WebView2 requer o WebView2 Runtime que é fornecido com a versão 131.0.2895.0 ou superior do Microsoft Edge.

APIs experimentais

As seguintes APIs Experimentais foram adicionadas neste SDK de Pré-lançamento.

RestartRequested evento quando o WebView2 tem de ser reiniciado

Foi adicionado um novo RestartRequested evento. O RestartRequested evento é gerado sempre que o WebView2 precisa de ser reiniciado para aplicar atualizações ou alterações de configuração. Pode utilizar esta API para detetar quando o WebView2 precisa de ser reiniciado e efetuar as ações adequadas. A Priority propriedade dos argumentos do RestartRequested evento indica a prioridade do pedido de reinício:

  • High indica que a aplicação deve pedir aos utilizadores para reiniciarem o mais rapidamente possível.
  • Normal indica que a aplicação deve lembrar os utilizadores para reiniciarem, numa base de melhor esforço.

Promoções

As seguintes APIs foram promovidas de Experimental para Stable neste SDK de Pré-lançamento.

Controlar se a IU de captura de ecrã é apresentada (ScreenCaptureStarting evento)

Foi adicionado um novo ScreenCaptureStarting evento. Este evento é gerado sempre que o WebView2 e/ou iframe que corresponde ao CoreWebView2Frame (ou a qualquer um dos respetivos iframes descendentes) pede permissão para utilizar a API de Captura de Ecrã antes de a IU ser apresentada. Em seguida, a aplicação pode bloquear a apresentação da IU ou permitir que a IU seja apresentada.

Configurar o aviso de segurança ao guardar um ficheiro (SaveFileSecurityCheckStarting evento)

Foi adicionado um novo SaveFileSecurityCheckStarting evento. A sua aplicação pode registar um processador neste evento para obter o caminho do ficheiro, a extensão de nome de ficheiro e as informações do URI de origem do documento. Em seguida, pode aplicar as suas próprias regras para efetuar ações como as seguintes:

  • Permitir guardar o ficheiro sem apresentar uma IU de aviso de segurança predefinida sobre a política de tipo de ficheiro.
  • Cancele a gravação.
  • Crie a sua própria IU para gerir políticas de tipo de ficheiro de runtime.

Correções de erros

Apenas SDK
  • Correção da incompatibilidade do Arm64 com o WindowsAppSDK 1.6.
  • Foi removido um extra WebView2Loader.dll no caso winAppSDK.
  • A utilização CoreWebView2.AddWebResourceRequestedFilter sem um CoreWebView2WebResourceRequestSourceKinds parâmetro foi preterida. Veja o Método .NET CoreWebView2.AddWebResourceRequestedFilter.

1.0.2792.45

Data de Lançamento: 23 de setembro de 2024

Pacote NuGet para o SDK WebView2 1.0.2792.45

Para compatibilidade total com a API, esta versão de Versão do SDK WebView2 requer a versão 129.0.2792.45 ou superior do WebView2 Runtime.

Promoções

Não foram promovidas APIs adicionais para Stable e adicionadas neste SDK de Versão.

Correções de erros

Apenas SDK

1.0.2839-pré-lançamento

Data de Lançamento: 23 de setembro de 2024

Pacote NuGet para o SDK WebView2 1.0.2839-prerelease

Para compatibilidade total com a API, esta versão de Pré-lançamento do SDK WebView2 requer o WebView2 Runtime que é fornecido com a versão 130.0.2839.0 ou superior do Microsoft Edge.

APIs experimentais

Não foram adicionadas APIs Experimentais neste SDK de Pré-lançamento.

Promoções

Não foram promovidas APIs de Experimental para Stable neste SDK de Pré-lançamento.

Correções de erros

Apenas runtime
  • Foi corrigido um problema em que concentrar-se num controlo WebView2 no WinAppSDK com a definição "Deslocar janelas inativas" do Windows desativada fazia com que o deslocamento falhasse.
  • Bloqueado edge://wallet no WebView2. (Problema n.º 4710)
  • Limpou a variável de ambiente para a cor de fundo predefinida nos controlos .NET WebView2 após a criação do controlador.
  • Suporte de acessibilidade ativado para Webview2 no modo de alojamento visual.
  • Foi corrigido um erro ao remover um filtro de "recurso Web pedido" para múltiplas origens quando uma delas era o Documento.
  • Foi corrigida uma regressão em que DataList não estava visível no WinUI ou noutras instâncias webView2 alojadas visualmente.
Apenas SDK
  • Foi corrigida uma dependência do SDK para projetos .NET. (Problema n.º 4743)
  • Foi corrigido um problema de compatibilidade ao chamar GetAvailableBrowserVersionString() com um mais antigo WebView2Loader.dll. (Problema n.º 4395)
  • Foram corrigidos problemas ao compilar código gerado por wv2winrt com as cpp20 opções e /permissive- .
  • Foi adicionado o .NET 8 TargetFramework para WinRT C#, compatibilidade ativada do AOT (antecipadamente) e desativação da triagem de runtime.

1.0.2739.15

Data de Lançamento: 26 de agosto de 2024

Pacote NuGet para o SDK WebView2 1.0.2739.15

Para compatibilidade total com a API, esta versão de Versão do SDK WebView2 requer a versão 128.0.2739.15 ou superior do WebView2 Runtime.

Promoções

As seguintes APIs foram promovidas para Stable e estão agora incluídas neste SDK de Versão.

Processamento de notificações Web

Foi adicionado suporte para a Notificação Web, para notificações não persistentes. O NotificationReceived evento para CoreWebView2 controla o processamento de notificações Web, permitindo a personalização ou supressão pela aplicação anfitriã. As notificações não processadas são predefinidas para a IU do WebView2.

Salvar como

Adição SaveAs de APIs que lhe permitem executar programaticamente a operação Guardar como . Pode utilizar estas APIs para bloquear a caixa de diálogo Guardar como predefinida e, em seguida, guardar silenciosamente ou criar a sua própria IU para Guardar como. Estas APIs referem-se apenas à caixa de diálogo Guardar como , não à caixa de diálogo Transferir , que continua a utilizar as APIs de Transferência existentes.

Correções de erros

Não existem correções de erros neste SDK de Versão.

1.0.2783-pré-lançamento

Data de Lançamento: 26 de agosto de 2024

Pacote NuGet para o SDK WebView2 1.0.2783-prerelease

Para compatibilidade de API completa, esta versão de Pré-lançamento do SDK WebView2 requer o WebView2 Runtime que é fornecido com a versão 129.0.2783.0 ou superior do Microsoft Edge.

APIs experimentais

Não foram adicionadas APIs Experimentais neste SDK de Pré-lançamento.

Promoções

Não foram promovidas APIs de Experimental para Stable neste SDK de Pré-lançamento.

Correções de erros

Runtime e SDK
  • Reativado o comportamento predefinido de SetUserAgent: por predefinição, SetUserAgent é eficaz para iframes entre origens.
Apenas runtime

  • Ativou a funcionalidade de arrastar interativa por predefinição. Veja edge-webview-interactive-dragging em Sinalizadores do browser WebView2.

  • Desativado IsolateSandboxedIframes para WebView2.

  • Foi corrigido um problema em que a criação do WebView falhava quando várias instâncias são iniciadas ao mesmo tempo. (Problema n.º 4731)

  • Foi corrigido um erro na projeção de JavaScript WinRT em que colocava em cache propriedades existentes em objetos cujo nome contém Proxy ou Function causava um erro devido a colisão de nomes.

  • Foi corrigido um erro em que o controlo WebView2 se tornava o tamanho errado depois de desligar e voltar a ligar um monitor.

  • Foi corrigido um problema em que as ligações "mailto:" deixavam uma janela de pop-up sem título aberta, em vez de fechar automaticamente a janela de pop-up.

Apenas SDK

  • A projeção WinRT de C# funciona agora no UWP.

  • Foi corrigido um problema para garantir que GeneratedFilesDir já não aparece no Visual Studio para projeção WinRT C#.

Consulte também