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

Data de Lançamento: 8 de dezembro de 2025

Pacote NuGet para o SDK WebView2 1.0.3650.58

Para compatibilidade de API completa, esta versão de Versão do SDK WebView2 requer a versão 143.0.3650.58 ou superior do WebView2 Runtime.

Promoções para a Fase 3 (Estável no Lançamento)

Não foram promovidas APIs adicionais desde a Fase 2: Estável no Pré-lançamento até à Fase 3: Estável em Versão, neste SDK de Versão.

Correções de erros

Apenas runtime
  • Foi corrigido o acesso à rede local acionando uma janela de pop-up de alerta de permissão.

1.0.3712-pré-lançamento

Data de Lançamento: 8 de dezembro de 2025

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

Promoções para a Fase 1 (Experimental em Pré-lançamento)

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

Personalizar o comportamento do intervalo de portas

As APIs de Intervalo de Portas Permitidas permitem restringir ou personalizar os intervalos de portas de rede que o WebView2 pode utilizar para vários protocolos e âmbitos de transporte. Isto fornece um controlo de segurança melhorado.

  • Utilize SetAllowedPortRange na CoreWebView2EnvironmentOptions instância (ou ICoreWebView2ExperimentalEnvironmentOptions) para configurar restrições de portas durante a criação do ambiente.

    • Utilize o scope parâmetro para especificar se a configuração se aplica a todos os componentes (Default) ou apenas a ligações ponto a ponto webRTC (WebRtc). Atualmente, só WebRtc é suportado.

    • Utilize o protocol parâmetro para especificar o protocolo de transporte (atualmente suporta Udp).

    • Especifique minPort e maxPort valores entre 1025-65535 (inclusive) ou utilize (0,0) para repor/remover restrições.

  • Utilize GetEffectiveAllowedPortRange na CoreWebView2EnvironmentOptions instância (ou ICoreWebView2ExperimentalEnvironmentOptions) para obter a configuração do intervalo de portas ativa para um âmbito e protocolo específicos.

    • Devolve o intervalo definido explicitamente para o âmbito especificado ou herda do Default âmbito se não for definido.

    • Devolve (0,0) se não estiverem configuradas restrições para o âmbito especificado.

Promoções para a Fase 2 (Estável no Pré-lançamento)

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 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 ICoreWebView2CompositionController5 para adicionar um processador de eventos que é invocado quando a operação de arrastar está a iniciar.
  • Utilize ICoreWebView2DragStartingEventArgs 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.

Correções de erros

Este SDK de Pré-lançamento inclui as seguintes correções de erros.

Apenas runtime
  • Foi corrigido o acesso à rede local acionando uma janela de pop-up de alerta de permissão.
  • Foi corrigida uma regressão da setColorScheme API.
  • Foi corrigida a inicialização diferida para ICoreWebView2NewWindowRequestedEventArgs para o comutador da linha de comandos enable-new-window-requested-deferred-initialization.

1.0.3595.46

Data de Lançamento: 3 de novembro de 2025

Pacote NuGet para o SDK WebView2 1.0.3595.46

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

Promoções para a Fase 3 (Estável no Lançamento)

Não foram promovidas APIs adicionais desde a Fase 2: Estável no Pré-lançamento até à Fase 3: Estável em Versão, neste SDK de Versão.

Correções de erros

Este SDK de Versão inclui as seguintes correções de erros.

Apenas runtime
  • Criação desativada de um processo de "Composição Especulativa".

1.0.3650-pré-lançamento

Data de Lançamento: 7 de novembro de 2025

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

Promoções para a Fase 1 (Experimental em Pré-lançamento)

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

Promoções para a Fase 2 (Estável no Pré-lançamento)

Não foram promovidas APIs desde a Fase 1: Experimental em Pré-lançamento até à Fase 2: Estável em Pré-lançamento, neste SDK de Pré-lançamento.

Correções de erros

Este SDK de Pré-lançamento inclui as seguintes correções de erros.

Apenas runtime
  • Criação desativada de um processo de "Composição Especulativa".
  • Foi corrigido um problema de sincronização da caixa de diálogo Localizar ao efetuar programaticamente uma Localizar.

1.0.3537.50

Data de Lançamento: 6 de outubro de 2025

Pacote NuGet para o SDK WebView2 1.0.3537.50

Para compatibilidade de API completa, esta versão de Versão do SDK WebView2 requer a versão 141.0.3537.50 ou superior do WebView2 Runtime.

Promoções para a Fase 3 (Estável no Lançamento)

Não foram promovidas APIs adicionais desde a Fase 2: Estável no Pré-lançamento até à Fase 3: Estável em Versão, neste SDK de Versão.

Correções de erros

Este SDK de Versão inclui as seguintes correções de erros.

Apenas runtime
  • Foi corrigido o acesso à rede local acionando uma janela de pop-up de alerta de permissão.
Apenas SDK
  • Foi corrigido um erro binSkim para WebView2Loader.dll.

1.0.3590-pré-lançamento

Data de Lançamento: 7 de outubro de 2025

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

Promoções para a Fase 1 (Experimental em Pré-lançamento)

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

Suporte de etiquetas de confidencialidade

Uma nova API de Informações de Confidencialidade no WebView2 permite que as aplicações acedam a informações de etiquetas de confidencialidade comunicadas por páginas Web através do Gestor de Restrições de Interação de Páginas. Esta funcionalidade ajuda a alojar aplicações que detetam e respondem a conteúdos confidenciais.

Principais capacidades:

  • Configurar a disponibilidade do Gestor de Restrições de Interação de Páginas – configure uma lista de filtros de URL para o Gestor de Restrições de Interação de Página. Depois de configurar a lista, o Gestor de Restrições de Interação de Página fica disponível em páginas na lista de permissões. Estas páginas podem enviar etiquetas de confidencialidade para a plataforma através da API.

  • Exposição de Informações de Confidencialidade - CoreWebView2 agora expõe uma SensitivityInfo propriedade e um SensitivityInfoChanged evento, permitindo que as aplicações ouçam atualizações às informações da etiqueta de confidencialidade.

O suporte de etiquetas de confidencialidade está inicialmente disponível apenas no Win32. O suporte para .NET e WinRT está planeado para uma versão futura.

Promoções para a Fase 2 (Estável no Pré-lançamento)

Não foram promovidas APIs desde a Fase 1: Experimental em Pré-lançamento até à Fase 2: Estável em Pré-lançamento, neste SDK de Pré-lançamento.

Correções de erros

Este SDK de Pré-lançamento inclui as seguintes correções de erros.

Apenas runtime
  • Foi corrigido um ponteiro pendente no contexto de permissão de acesso ao sistema de ficheiros.
  • Corrigimos a IU bloqueada durante a funcionalidade de arrastar e largar no WinUI3.
  • Foi corrigido o acesso à rede local acionando uma janela de pop-up de alerta de permissão.
  • Foi resolvido um problema em que uma região extra aparecia na árvore de acessibilidade.
  • Foi corrigido um problema em que as transferências na moldura predefinida do browser não funcionavam.
Apenas SDK
  • Foi corrigido um erro binSkim para WebView2Loader.dll.

1.0.3485.44

Data de Lançamento: 8 de setembro de 2025

Pacote NuGet para o SDK WebView2 1.0.3485.44

Para compatibilidade de API completa, esta versão de Versão do SDK WebView2 requer a versão 140.0.3485.44 ou superior do WebView2 Runtime.

Alterações gerais

Este SDK de Versão centra-se em fazer com que o WebView2 funcione melhor, através de melhorias nos bastidores.

  • A infraestrutura de teste foi reforçada.
  • A validação de APIs foi melhorada, para garantir que as APIs têm um desempenho fiável em diferentes cenários.

Estas melhorias fundamentais fornecem funcionalidades estáveis e testadas para a criação de aplicações WebView2.

Promoções para a Fase 3 (Estável no Lançamento)

Não foram promovidas APIs adicionais desde a Fase 2: Estável no Pré-lançamento até à Fase 3: Estável em Versão, neste SDK de Versão.

Correções de erros

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

1.0.3530-pré-lançamento

Data de Lançamento: 8 de setembro de 2025

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

Alterações gerais

Este SDK de Pré-lançamento centra-se em fazer com que o WebView2 funcione melhor, através de melhorias nos bastidores.

  • A infraestrutura de teste foi reforçada.
  • A validação de APIs foi melhorada, para garantir que as APIs têm um desempenho fiável em diferentes cenários.

Estas melhorias fundamentais fornecem funcionalidades estáveis e testadas para a criação de aplicações WebView2.

Promoções para a Fase 1 (Experimental em Pré-lançamento)

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

Promoções para a Fase 2 (Estável no Pré-lançamento)

Não foram promovidas APIs desde a Fase 1: Experimental em Pré-lançamento até à Fase 2: Estável em Pré-lançamento, neste SDK de Pré-lançamento.

Correções de erros

Este SDK de Pré-lançamento inclui as seguintes correções de erros.

Apenas SDK
  • Foi corrigida uma fuga de memória no Controlador de Composição WPF.

1.0.3405.78

Data de Lançamento: 11 de agosto de 2025

Pacote NuGet para o SDK WebView2 1.0.3405.78

Para compatibilidade de API completa, esta versão de Versão do SDK WebView2 requer a versão 139.0.3405.78 ou superior do WebView2 Runtime.

Promoções para a Fase 3 (Estável no Lançamento)

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.

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 corrigida uma falha nas Devtools em Windows Server e Windows 10.

1.0.3477-pré-lançamento

Data de Lançamento: 11 de agosto de 2025

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

Promoções para a Fase 1 (Experimental em Pré-lançamento)

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

Promoções para a Fase 2 (Estável no Pré-lançamento)

Não foram promovidas APIs desde a Fase 1: Experimental em Pré-lançamento até à Fase 2: Estável em Pré-lançamento, neste SDK de Pré-lançamento.

Correções de erros

Apenas runtime
  • 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.
  • Foi removido o controlo do processo do browser depois de chamar remove_BrowserProcessExited.
  • Foi corrigido um problema de fuga de memória em hostObject chamadas de função assíncronas.
  • O toque fixo não funciona no alojamento visual após um toque longo.

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 para a Fase 3 (Estável no Lançamento)

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.

Promoções para a Fase 1 (Experimental em Pré-lançamento)

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 principal, 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 para a Fase 2 (Estável no Pré-lançamento)

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.

Consulte também

Referência da API:

  • Last updated on