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

1.0.2592.51

Data de Lançamento: 19 de junho de 2024

Pacote NuGet para o SDK WebView2 1.0.2592.51

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

  • Desativado BreakoutBoxPreferCaptureTimestampInVideoFrame para WebView2 TextureStream.

  • Foi corrigida uma regressão em que o WindowCloseRequested evento só é acionado para a primeira window.close() chamada.

  • Foi corrigida uma regressão em que as matrizes escritas na projeção JavaScript winRT não podiam ser processadas como IDispatch no anfitrião.

  • Foi corrigido um erro em que o pop-up de preenchimento automático é dispensado imediatamente e causa uma alteração de foco.

  • Foi corrigido um erro em que o WebView2 falha ao carregar devido AppPolicyGetWindowingModela . (Problema n.º 4591)

1.0.2646-pré-lançamento

Data de Lançamento: 19 de junho de 2024

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

Funcionalidades gerais

  • Foi adicionado suporte para C#/WinRT .NET 6+.

Recursos experimentais

  • Introduziu o sinalizador msWebView2EnableDownloadContentInWebResourceResponseReceivedde funcionalidade , uma funcionalidade Experimental (em vez de como uma funcionalidade Estável). Quando este sinalizador está ativado, isto permite que as respostas de navegação que se tornam transferências estejam disponíveis no WebResourceResponseReceived.

APIs experimentais

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

  • Foi adicionado um novo SaveFileSecurityCheckStarting evento. Enquanto programador, 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.
  • 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. Como programador, pode optar por bloquear a IU ou permitir que a IU seja apresentada.
  • Foi adicionado um novo GetComICoreWebView2 método à CoreWebView2 classe .NET que lhe permite converter um CoreWebView2 entre .NET e COM. Foi adicionada uma nova interface WinRT que lhe permite converter uma CoreWebView2 entre WinRT e COM. Isto permite-lhe interagir entre bibliotecas escritas em idiomas diferentes.

Promoções

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

  • 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 para representar um identificador do sistema de ficheiros que pode ser publicado no conteúdo Web para lhe fornecer acesso ao sistema de ficheiros.

Correções de erros

Apenas runtime
  • Foi corrigido um erro na lógica de ativação de janela própria para o alojamento de elementos visuais.

1.0.2535.41

Data de Lançamento: 28 de maio de 2024

Pacote NuGet para o SDK WebView2 1.0.2535.41

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

  • Suporte para a Barra de Deslocamento Fluent Style Overlay.

Correções de erros

Apenas runtime

  • Foi corrigido um erro em que, se o LaunchingExternalURIScheme processador de eventos estiver anexado e a caixa de verificação memorizar sempre estiver ativada e o utilizador selecionar esta caixa de verificação, a caixa de diálogo será apresentada incorretamente novamente.

  • Foi corrigido um problema em que os controlos de edição de texto no alojamento visual duplicavam a entrada IME ao perder e, em seguida, recuperar o foco.

  • Foi corrigido um problema em que as aplicações UWP de confiança total não conseguiam apresentar janelas próprias.

Apenas SDK
  • Foi corrigido um problema no SDK que causava valores de Plataforma> errados <na lista de plataformas de projetos .NET. (Problema n.º 1755)

1.0.2584-pré-lançamento

Data de Lançamento: 28 de maio de 2024

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

Recursos experimentais

  • Introduziu uma opção para cancelar a navegação inicial no WebView2, para melhorar o desempenho do arranque. Esta alteração está desativada por predefinição e pode ser ativada com o sinalizador msWebView2CancelInitialNavigation de funcionalidade.

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
  • Foi corrigida uma falha quando os métodos assíncrono de objeto anfitrião .NET devolvem um resultado nulo. (Problema n.º 4509)
Apenas runtime

  • Foi corrigido um problema de fuga de memória do WebView2 quando a janela estava fechada. (Problema n.º 4286)

  • Foi corrigido um problema em ignoreMemberNotFoundError que não estava a funcionar para objetos .NET. (Problema n.º 4497)

  • Agora devolve um código de erro adequado quando CreateSharedBuffer é chamado com 0 tamanho da memória intermédia. (Problema n.º 4554)

  • Foi corrigido um problema de ativação para a caixa de diálogo de navegação por cursor.

  • Foi corrigido um problema em que o evento WebView2 Visual Hosting CursorChanged não estava a ser acionado para cursores personalizados.

Consulte também