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

1.0.2651.64

Data de Lançamento: 13 de agosto de 2024

Pacote NuGet para o SDK WebView2 1.0.2651.64

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

  • Atualizou a API WebMessageObjects para permitir a injeção de objetos DOM no conteúdo WebView2 que é construído através da aplicação e através da CoreWebView2.PostWebMessage API na outra direção. Foi adicionado um novo tipo de objeto Web (CoreWebView2FileSystemHandle) para representar uma alça do sistema de ficheiros que pode ser publicada no conteúdo Web para lhe fornecer acesso ao sistema de ficheiros.

Correções de erros

Apenas runtime
  • Foi corrigida uma regressão em que WebResourceRequested os eventos falham em determinados sites. (Problema n.º 4602)
Apenas SDK
  • Foi corrigido o x86 para a projeção de C# WinRT.

1.0.2730-pré-lançamento

Data de Lançamento: 7 de agosto de 2024

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

APIs experimentais

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

  • Foram adicionadas novas APIs de Controlos de Limitação que permitem uma gestão de recursos eficiente, permitindo-lhe limitar os temporizadores JavaScript. Isto é útil em cenários em que um controlo WebView2 tem de permanecer visível, mas precisa de consumir menos recursos (por exemplo, quando o utilizador não está a interagir com o conteúdo). Estas APIs de Controlos de Limitação permitem-lhe:
    • Personalizar temporizadores de script (setTimeout e setInterval) limitação em diferentes estados de página (primeiro plano, fundo e fundo com limitação intensiva).
    • Limitar temporizadores de script em iframes alojados selecionados.

Promoções

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

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

Correções de erros

Apenas runtime

  • Foi corrigido um problema em que a janela da aplicação não podia ser controlada através de comandos do sistema (como Alt+F4 ou Alt+Barra de Espaço) quando o foco estava no modo de alojamento WebView2 para Elementos visuais. (Problema n.º 2961)

  • Foi corrigido um erro no WebView2 UWP no qual não era possível clicar na barra Localizar a partir da aplicação anfitriã.

Apenas SDK

  • A adicionar a API WinRT CoreWebView2Notification.VibrationPattern em falta. Esta API WinRT pode ser combinada com as notas de versão de promoção da API de notificação estável; consulte "Notificação Web" e NotificationReceived para WinRT, imediatamente acima.

  • Foi corrigido um problema em KeyDown que os eventos do controlo WinForms WebView2 não incluíam as informações corretas ModifierKeys . (Problema n.º 1216)

  • Foi corrigido o x86 para a projeção de C# WinRT.

  • Tornado CreateCoreWebView2Environment e GetAvailableCoreWebView2BrowserVersionString mais robusto face a uma potencial condição race durante a atualização do Runtime.

Consulte também