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.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 WebView2TextureStream
. - Foi corrigida uma regressão em que o
WindowCloseRequested
evento só é acionado para a primeirawindow.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
AppPolicyGetWindowingModel
a . (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
msWebView2EnableDownloadContentInWebResourceResponseReceived
de 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 noWebResourceResponseReceived
.
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.
CoreWebView2
Classe:Classe CoreWebView2SaveFileSecurityCheckStartingEventArgs
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.CancelSave Property
- Propriedade CoreWebView2SaveFileSecurityCheckStartingEventArgs.DocumentOriginUri
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.FileExtension Property
- Propriedade CoreWebView2SaveFileSecurityCheckStartingEventArgs.FilePath
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.GetDeferral Method
- Propriedade CoreWebView2SaveFileSecurityCheckStartingEventArgs.SuppressDefaultPolicy
- Foi adicionado um novo
ScreenCaptureStarting
evento. Este evento é gerado sempre que o WebView2 e/ou iframe que corresponde aoCoreWebView2Frame
(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.
CoreWebView2
Classe:CoreWebView2Frame
Classe:CoreWebView2ScreenCaptureStartingEventArgs
Classe:
- Foi adicionado um novo
GetComICoreWebView2
método àCoreWebView2
classe .NET que lhe permite converter umCoreWebView2
entre .NET e COM. Foi adicionada uma nova interface WinRT que lhe permite converter umaCoreWebView2
entre WinRT e COM. Isto permite-lhe interagir entre bibliotecas escritas em idiomas diferentes.
-
CoreWebView2
Classe:
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.
CoreWebView2
Classe:CoreWebView2Environment
Classe:CoreWebView2FileSystemHandle
Classe:CoreWebView2FileSystemHandleKind Enum
File
Directory
CoreWebView2FileSystemHandlePermission Enum
ReadOnly
ReadWrite
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.
CoreWebView2EnvironmentOptions
Classe:CoreWebView2ScrollbarStyle Enum
Default
FluentOverlay
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.
1.0.2478.35
Data de Lançamento: 22 de abril de 2024
Pacote NuGet para o SDK WebView2 1.0.2478.35
Para compatibilidade total com a API, esta versão de Versão do SDK WebView2 requer a versão 124.0.2478.35 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.
- Foi adicionada a funcionalidade de seleção de Runtime para suportar mais cenários de teste e piloto de pré-lançamento. Pode especificar
ReleaseChannels
para escolher os canais que são procurados durante a criação do ambiente eChannelSearchKind
para selecionar uma ordem de pesquisa.
CoreWebView2EnvironmentOptions
Classe:CoreWebView2ChannelSearchKind Enumeração
MostStable
LeastStable
Enumeração CoreWebView2ReleaseChannels
None
Stable
Beta
Dev
Canary
Correções de erros
Apenas runtime
- Corrige um potencial excesso de número inteiro que pode levar a uma falha ao utilizar
AdditionalObjects
na API WebMessage.
1.0.2526-pré-lançamento
Data de Lançamento: 22 de abril de 2024
Pacote NuGet para o SDK WebView2 1.0.2526-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 125.0.2526.0 ou superior do Microsoft Edge.
Alterações interruptivas
O requisito mínimo de versão do .NET Framework para o .NET WebView2, incluindo os controlos WPF e WinForms, foi atualizado do .NET Framework 4.5 para o .NET Framework 4.6.2.
APIs experimentais
As seguintes APIs Experimentais foram adicionadas 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.
CoreWebView2
Classe:-
Complete
Default
HtmlOnly
SingleFile
CoreWebView2SaveAsUIResult Enum
Cancelled
FileAlreadyExists
InvalidPath
KindNotSupported
Success
CoreWebView2SaveAsUIShowingEventArgs
Classe:- Propriedade CoreWebView2SaveAsUIShowingEventArgs.AllowReplace
- Propriedade CoreWebView2SaveAsUIShowingEventArgs.Cancel
- Propriedade CoreWebView2SaveAsUIShowingEventArgs.ContentMimeType
- CoreWebView2SaveAsUIShowingEventArgs.GetDeferral Method
- Propriedade CoreWebView2SaveAsUIShowingEventArgs.Kind
- Propriedade CoreWebView2SaveAsUIShowingEventArgs.SaveAsFilePath
- Propriedade CoreWebView2SaveAsUIShowingEventArgs.SuppressDefaultDialog
Promoções
As seguintes APIs foram promovidas de Experimental para Stable neste SDK de Pré-lançamento.
- Suporte para a Barra de Deslocamento Fluent Style Overlay.
CoreWebView2EnvironmentOptions
Classe:CoreWebView2ScrollbarStyle Enum
Default
FluentOverlay
Correções de erros
Runtime e SDK
Foi corrigido um erro na projeção de JavaScript WinRT em que a transmissão de uma matriz escrita resultou num erro "Interface Não Suportada". (Problema n.º 3486)
Foi adicionado suporte para processar
out
parâmetros de matriz na projeção JavaScript winRT.
Apenas runtime
Foi corrigido um erro em que a funcionalidade legendagem automática de imagens estava ativada por predefinição.
Foi corrigido um erro em que, se o
LaunchingExternalURIScheme
processador de eventos estiver anexado, se 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
GetNonClientRegionAtPoint
oNowhere
retorno incorreto para alguns pontos.Foi corrigido um erro em que o Text Services Framework se desligava ao largar um ficheiro numa região do WebView2.
Foi corrigido um erro em que o atalho de teclado Ver Origem Ctrl+U continuava ativado quando a
AreDevToolsEnabled
definição erafalse
.Foi corrigido um erro em que um IME composto era duplicado ao recuperar o foco. (Problema n.º 1610)
Confirmou que
devicePixelRatio
está sincronizado com escalas de rasterização personalizadas. (Problema n.º 3060)Foi corrigida uma condição race ao utilizar
CallDevToolsProtocolMethod
eventos emNewWindowRequested
. (Problema n.º 4181)Foi corrigida uma falha que pode ocorrer no WPF
TabIntoCore
quando oController
foi destruído, mas o utilizador tenta aceder ao controlo (premindo a Tecla de Tabulação ). (Problema n.º 4452)Confirmou que a verificação ortográfica utiliza o idioma de entrada com formato não sensível a maiúsculas e minúsculas.
Tornou a API de Idioma mais robusta em relação à entrada do utilizador.
Foi corrigido um erro em que o pedido Guardar palavra-passe? não era apresentado.
Apenas SDK
- Correção da API em falta
AreBrowserExtensionsEnabled
na projeção winRT.
1.0.2420.47
Data de Lançamento: 25 de março de 2024
Pacote NuGet para o SDK WebView2 1.0.2420.47
Para compatibilidade de API completa, esta versão de Versão do SDK WebView2 requer a versão 123.0.2420.47 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.
- Foi adicionada uma nova API para fornecer resultados de testes de êxito nas regiões que um WebView2 contém. Esta API é útil para aplicações alojadas visualmente que pretendem processar eventos do rato na área não cliente da janela WebView2.
CoreWebView2CompositionController
Classe:CoreWebView2NonClientRegionChangedEventArgs
Classe:Enumeração CoreWebView2NonClientRegionKind
Caption
Client
Nowhere
CoreWebView2Settings
Classe:
- Foi adicionada a
FailureSourceModulePath
propriedade aoProcessFailedEventArgs
tipo, para especificar o caminho completo do módulo que causou a falha em casos de falhas de integridade do código do Windows, ou seja, quando um processo saiu comSTATUS_INVALID_IMAGE_HASH
.
-
CoreWebView2ProcessFailedEventArgs
Classe:
Correções de erros
Apenas SDK
- As assemblagens .NET para WinForms e WPF são agora enviadas com otimização ativada. (Problema n.º 4409)
1.0.2470-pré-lançamento
Data de Lançamento: 25 de março de 2024
Pacote NuGet para o SDK WebView2 1.0.2470-prerelease
Para compatibilidade de API completa, esta versão de Pré-lançamento do SDK WebView2 requer a versão 124.0.2470.0 ou superior do WebView2 Runtime.
APIs experimentais
As seguintes APIs Experimentais foram adicionadas neste SDK de Pré-lançamento.
- Suporte para a Barra de Deslocamento Fluent Style Overlay.
CoreWebView2EnvironmentOptions
Classe:CoreWebView2ScrollbarStyle Enum
Default
FluentOverlay
- 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.
CoreWebView2
Classe:CoreWebView2Environment
Classe:CoreWebView2FileSystemHandle
Classe:CoreWebView2FileSystemHandleKind Enum
File
Directory
CoreWebView2FileSystemHandlePermission Enum
ReadOnly
ReadWrite
Promoções
As seguintes APIs foram promovidas de Experimental para Stable neste SDK de Pré-lançamento.
- Foi adicionada a funcionalidade de seleção de Runtime para suportar mais cenários de teste e piloto de pré-lançamento. Pode especificar
ReleaseChannels
para escolher os canais que são procurados durante a criação do ambiente eChannelSearchKind
para selecionar uma ordem de pesquisa.
CoreWebView2EnvironmentOptions
Classe:CoreWebView2ChannelSearchKind Enumeração
MostStable
LeastStable
Enumeração CoreWebView2ReleaseChannels
None
Stable
Beta
Dev
Canary
- Foi adicionada a
FailureSourceModulePath
propriedade aoProcessFailedEventArgs
tipo, para especificar o caminho completo do módulo que causou a falha em casos de falhas de integridade do código do Windows, ou seja, quando um processo saiu comSTATUS_INVALID_IMAGE_HASH
.
-
CoreWebView2ProcessFailedEventArgs
Classe:
Correções de erros
Apenas runtime
- Foi corrigida uma regressão de fiabilidade que poderia falhar o processo da aplicação quando uma versão antiga da DLL do cliente WebView2 era descarregada.
- Confirmou que a pasta de transferência temporária do WebView2 é exclusiva por pasta de dados do utilizador e não interfere com outras aplicações ou com o browser.
1.0.2365.46
Data de Lançamento: 26 de fevereiro de 2024
Pacote NuGet para o SDK WebView2 1.0.2365.46
Para compatibilidade de API completa, esta versão de Versão do SDK WebView2 requer a versão 122.0.2365.46 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.
- Foi adicionado suporte para
WebResourceRequested
os trabalhadores, que permite definir filtros para receberWebResourceRequested
eventos para trabalhadores de serviços, trabalhadores partilhados e iframes de origem diferente.
CoreWebView2
Classe:CoreWebView2WebResourceRequestedEventArgs
Classe:
- Para suportar extensões de browser no WebView2, adicionado
GetBrowserExtensions
para WinRT:
Correções de erros
Apenas runtime
Foi corrigida uma regressão que afetou o
NewWindowRequested
processamento do evento quando a nova janela está definida como WebView de origem. (Problema n.º 4250)Foi corrigido um erro em que fechar um WebView com um visualizador de PDF incorporado poderia originar uma falha. (Problema n.º 3832)
Corrigimos uma regressão em que os cliques com o rato deixavam de funcionar quando a aplicação ativava
SetWindowDisplayAffinity
. (Problema n.º 4325)
1.0.2415-pré-lançamento
Data de Lançamento: 26 de fevereiro de 2024
Pacote NuGet para o SDK WebView2 1.0.2415-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 123.0.2415.0 ou superior do Microsoft Edge.
Alterações interruptivas
- O comportamento da
InitiatingOrigin
propriedade deCoreWebView2LaunchingExternalUriSchemeEventArgs
foi alterado. Se for uma origemInitiatingOrigin
opaca, oInitiatingOrigin
que é comunicado no caso de args ser a sua origem precursora. A origem precursora é a origem que criou a origem opaca. Por exemplo, se uma moldura emexample.com
abrir um subframe com uma origem opaca diferente, a origem precursora do subframe éexample.com
.
-
CoreWebView2LaunchingExternalUriSchemeEventArgs
Classe:
- O nome dos membros da
CoreWebView2TextureStreamErrorKind
enumeração foi mudado:
Nomes de membros antigos:
-
CoreWebView2TextureStreamErrorKind Enum
CoreWebView2TextureStreamErrorNoVideoTrackStarted
CoreWebView2TextureStreamErrorTextureError
CoreWebView2TextureStreamErrorTextureInUse
Novos nomes de membros:
-
CoreWebView2TextureStreamErrorKind Enum
NoVideoTrackStarted
TextureError
TextureInUse
APIs experimentais
As seguintes APIs Experimentais foram adicionadas neste SDK de Pré-lançamento.
- A
CoreWebView2ControllerOptions
classe tem agora umaAllowHostInputProcessing
propriedade, que permite que as mensagens de entrada do utilizador (teclado, rato, toque e caneta) passem pela janela do browser para serem recebidas por uma janela de processo de aplicação.
-
CoreWebView2ControllerOptions
Classe:
Promoções
As seguintes APIs foram promovidas de Experimental para Stable neste SDK de Pré-lançamento.
- Foi adicionada uma nova API para fornecer resultados de testes de êxito nas regiões que um WebView2 contém. Esta API é útil para aplicações alojadas visualmente que pretendem processar eventos do rato na área não cliente da janela WebView2.
CoreWebView2CompositionController
Classe:CoreWebView2Settings
Classe:
Correções de erros
Apenas runtime
Foi corrigido o facto de a câmara ou o microfone não conseguir abrir nas reuniões do Google Meet ou do Microsoft Teams quando o pedido de permissão está definido como "não persistente" (ou seja,
SavesInProfile = false
). (Problema n.º 3592)Foi corrigido o anexo de um comutador de linha de comandos vazio
--edge-webview-custom-scheme
num processo de browser WebView2.Desativou a chave de registo global
UserDataFolder
, para que esta chave de registo só possa ser aplicada por aplicação.Corrigimos que o
NewWindowRequested
evento não estava a ser acionado quando aberto por uma extensão do browser. (Problema n.º 3841)Corrigimos que o
NewWindowRequested
evento não estava a ser acionado ao abrir uma origem de vista. (Problema n.º 4162)Foi corrigido um problema de acionamento
StateChanged
eBytesReceivedChanged
eventos quando uma transferência envolve navegação.Foi corrigido um erro em que a
BeforeUnload
caixa de diálogo fazia com que a janela WebView2 saltasse inesperadamente. (Problema n.º 4350)Foi corrigido um problema em
PrintAsync
que imprime uma página em branco se esta for chamada demasiado cedo, antes de o PDF ser totalmente carregado. (Problema n.º 3779)
Consulte também
- Acerca das Notas de Versão do SDK WebView2
- Notas de Versão Arquivadas para o SDK WebView2
- Descrição geral das funcionalidades e APIs do WebView2 – descreve muitas das APIs, por área de funcionalidades, que estão em Pacotes SDK de Versão.
- Contactar a equipa do Microsoft Edge WebView2
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de