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.3124.44

Data de Lançamento: 10 de março de 2025

Pacote NuGet para o SDK WebView2 1.0.3124.44

Para compatibilidade total com a API, esta versão de Versão do SDK WebView2 requer a versão 134.0.3124.44 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 runtime
  • As extensões não serão desativadas no WebView2 através AddBrowserExtensionAsyncdo , independentemente de o modo de programador estar ativado. (Problema n.º 5113)
  • Atualização em segundo plano desativada da hora da rede. (Problema n.º 5047)
  • Corrigimos que o pop-up de transferência não era apresentado quando target="_blank". (Problema n.º 5063)

1.0.3171-pré-lançamento

Data de Lançamento: 10 de março de 2025

Pacote NuGet para o SDK WebView2 1.0.3171-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 135.0.3171.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
  • Correção do processamento de exceções do método assíncrono do objeto anfitrião. (Problema n.º 3402)
  • Documentação corrigida para CoreWebVIew2.Navigate. (Problema n.º 5091)
Apenas runtime
  • Foi corrigida uma regressão de instalação do arquivo "Adicionar ao Chrome".
  • Foram corrigidos os carregamentos de pastas no UWP e no WinUI. (Problema n.º 3275)
  • As extensões não serão desativadas no WebView2 através AddBrowserExtensionAsyncdo , independentemente de o modo de programador estar ativado. (Problema n.º 5113)
  • Atualização em segundo plano desativada da hora da rede. (Problema n.º 5047)
  • Corrigimos que o pop-up de transferência não era apresentado quando target="_blank". (Problema n.º 5063)
Apenas SDK
  • Corrige uma falha que pode ocorrer quando o Recoletor da Memória chama Finalize um thread diferente do thread main.

1.0.3065.39

Data de Lançamento: 10 de fevereiro de 2025

Pacote NuGet para o SDK WebView2 1.0.3065.39

Para compatibilidade de API completa, esta versão de Versão do SDK WebView2 requer a versão 133.0.3065.39 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 runtime
  • Foi adicionado o botão Fechar em falta na lista de opções Transferir .
  • Foi corrigida uma condição race que ocorria quando o evento de Resposta do Pedido Web nunca ocorre.

1.0.3116-pré-lançamento

Data de Lançamento: 10 de fevereiro de 2025

Pacote NuGet para o SDK WebView2 1.0.3116-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 134.0.3116.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 adicionado o botão Fechar em falta na lista de opções Transferir .
  • Foi corrigida uma condição race que ocorria quando o evento de Resposta do Pedido Web nunca ocorre.
Apenas SDK
  • Foi corrigida a documentação .NET e Win32 do CoreWebView2Find.FindNext método que mencionou FindPreviousincorretamente . O resumo do método é agora mencionado FindNext . (Problema n.º 5059)

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.

Consulte também