Compartilhar via

Notas de versão para o SDK do WebView2

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

Data de Lançamento: 1 de julho de 2025

Pacote NuGet para o SDK WebView2 1.0.3351.48

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

Promoções

As seguintes APIs foram promovidas desde a Fase 2: Estável no Pré-lançamento até à Fase 3: Estável na Versão e estão agora incluídas neste SDK de Versão.

Permitir que as mensagens de evento de entrada passem pela janela do browser

A CoreWebView2ControllerOptions classe tem agora uma AllowHostInputProcessing propriedade, que permite que as mensagens de evento de entrada do utilizador (teclado, rato, toque ou caneta) passem pela janela do browser, para serem recebidas por uma janela de processo de aplicação.

Correções de erros

Apenas runtime
  • Foi corrigido um problema de caixa preta nas caixas de diálogo no alojamento visual.

1.0.3415-pré-lançamento

Data de Lançamento: 14 de julho de 2025

Pacote NuGet para o SDK WebView2 1.0.3415-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 140.0.3415.0 ou superior do Microsoft Edge.

APIs experimentais

As seguintes APIs estão na Fase 1: Experimental em Pré-lançamento e foram adicionadas neste SDK de Pré-lançamento.

Ativar o processamento em segundo plano e o suporte offline (APIs de Trabalho webView2)

As APIs de Trabalho do WebView2 permitem que as aplicações anfitriãs interajam com os Web Workers para descarregar tarefas do thread main, melhorar a capacidade de resposta e suportar operações em segundo plano. Estes Web Workers incluem Trabalhadores Dedicados, Trabalhadores Partilhados e Trabalhadores de Serviço.

Estas APIs fornecem:

  • Eventos de Ciclo de Vida: Monitorize a criação e destruição de trabalhadores.
  • Interfaces de Mensagens: Comunique com os trabalhadores através de PostMessage e WebMessageReceived.
  • Gestão de Trabalho: Consultar e obter registos e instâncias de trabalho.
Compor barras de título personalizadas (API de Sobreposição de Controlos de Janela)

A API de Sobreposição de Controlos de Janela permite que os programadores criem barras de título personalizadas ao compor botões de legenda (minimizar, maximizar, restaurar, fechar) diretamente dentro da janela WebView2. A Sobreposição dos Controlos de Janela é apresentada no canto superior do WebView e integra-se perfeitamente com a IU da sua aplicação.

Utilize esta API quando:

  • Quer substituir a barra de título predefinida do SO por uma barra de título na aplicação totalmente personalizada.
  • Está a trabalhar com funcionalidades de região não cliente, como app-region: drag e IsNonClientRegionSupportEnabled.

Esta API é ideal para aplicações que requerem uma experiência de IU moderna e envolvente.

Promoções

As seguintes APIs foram promovidas desde a Fase 1: Experimental em Pré-lançamento até à Fase 2: Estável em Pré-lançamento e estão incluídas 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 .

Correções de erros

Apenas runtime
  • Foi corrigido um problema de caixa preta nas caixas de diálogo no alojamento visual.
  • Foi corrigido put_UserAgent não funcionar para os trabalhadores de serviços.
  • Foi corrigida uma falha nas DevTools em Windows Server e Windows 10.

1.0.3296.44

Data de Lançamento: 03 de junho de 2025

Pacote NuGet para o SDK WebView2 1.0.3296.44

Para compatibilidade de API completa, esta versão de Versão do SDK WebView2 requer a versão 137.0.3296.44 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.

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.

Correções de erros

Apenas runtime
  • Fixou as margens no PDF impresso.

1.0.3344-pré-lançamento

Data de Lançamento: 03 de junho de 2025

Pacote NuGet para o SDK WebView2 1.0.3344-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 138.0.3344.0 ou superior do Microsoft Edge.

APIs experimentais

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

Promoções

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

Permitir que as mensagens de evento de entrada passem pela janela do browser

A CoreWebView2ControllerOptions classe tem agora uma AllowHostInputProcessing propriedade, que permite que as mensagens de evento de entrada do utilizador (teclado, rato, toque ou caneta) passem pela janela do browser, para serem recebidas por uma janela de processo de aplicação.

Correções de erros

Apenas runtime
  • Foi corrigido um erro em que um evento do rato não era acionado após um evento tátil.
  • Captura Web desativada no controlo WebView2.
  • Foi corrigida a caixa de diálogo Transferências .
  • Foi corrigido um problema com as transferências na moldura predefinida do browser. (Problema n.º 5196)
  • Fixou as margens no PDF impresso.

1.0.3240.44

Data de Lançamento: 05 de maio de 2025

Pacote NuGet para o SDK WebView2 1.0.3240.44

Para compatibilidade total com a API, esta versão de Versão do SDK WebView2 requer a versão 136.0.3240.44 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 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.

Correções de erros

Apenas runtime
  • Foi corrigido um problema em que as transferências a partir da moldura predefinida do browser não foram concluídas. (Problema n.º 5196)
  • Foi corrigido um problema em que o nome do pipe era devolvido incorretamente, o que levou a uma falha em algumas aplicações UWP.

1.0.3296-pré-lançamento

Data de Lançamento: 12 de maio de 2025

Pacote NuGet para o SDK WebView2 1.0.3296-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 137.0.3296.0 ou superior do Microsoft Edge.

APIs experimentais

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

Promoções

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

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.

Correções de erros

Apenas runtime
  • Foi corrigida a barra Localizar que já não aparecia depois de a janela ser movida.
  • Foi corrigido um erro em que a aplicação não conseguia cancelar a navegação para páginas de início de sessão através do NavigationStarting evento.
  • Foi corrigido um problema em que as transferências a partir da moldura predefinida do browser não foram concluídas. (Problema n.º 5196)
  • Foi corrigido um problema em que o nome do pipe era devolvido incorretamente, o que levou a uma falha em algumas aplicações UWP.

1.0.3179.45

Data de Lançamento: 07 de abril de 2025

Pacote NuGet para o SDK WebView2 1.0.3179.45

Para compatibilidade de API completa, esta versão de Versão do SDK WebView2 requer a versão 135.0.3179.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 runtime
  • Corrigimos o elemento Html Select (<selecionar>) para o tornar selecionável, nas aplicações WPF.
  • Foi corrigida a navegação dentro de edge://crashes um controlo WebView2.
  • Foram corrigidos potenciais problemas de falha e IU ao invocar a IU de Credenciais do Windows a partir de uma instância do WebView2.
  • Foi corrigido um erro em que os utilizadores não conseguiam escrever num campo de entrada com informações de preenchimento automático. (Problema n.º 5144)

1.0.3230-pré-lançamento

Data de Lançamento: 07 de abril de 2025

Pacote NuGet para o SDK WebView2 1.0.3230-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 136.0.3230.0 ou superior do Microsoft Edge.

APIs experimentais

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

Promoções

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

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.

Correções de erros

Apenas runtime
  • Foi corrigido um problema no WPF em que a lista pendente da <lista> de dados fechava quando o rato se movia para fora dos limites de controlo webView2.
  • Foi corrigida a navegação dentro de edge://crashes um controlo WebView2.
  • Corrigimos o elemento Html Select (<selecionar>) para o tornar selecionável, nas aplicações WPF.
  • Foram corrigidos potenciais problemas de falha e IU ao invocar a IU de Credenciais do Windows a partir de uma instância do WebView2.
  • Foi corrigido um erro em que os utilizadores não conseguiam escrever no campo de entrada com informações de preenchimento automático. (Problema n.º 5144)
  • Foi corrigida uma regressão nas APIs da Barra de estado.
Apenas SDK
  • Tecla de Tabulação Fixa, Shift+Tecla de Tabulação e Teclas de Seta no modo de alojamento Janela para Elemento Visual.

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.

Consulte também

Referência da API: