Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Notas de versão do SDK de pré-lançamento do Microsoft Edge WebView2, data de lançamento: 11 de setembro de 2026.
Pacote NuGet para WebView2 SDK 1.0.4255-prerelease
Para compatibilidade total com a API, esta versão de pré-lançamento do SDK do WebView2 requer o WebView2 Runtime que vem com o Microsoft Edge versão 154.0.4255.0 ou posterior; consulte Runtime 154.0.4258.31 (28 de setembro de 2026).
Conteúdo detalhado:
APIs Experimentais (Fase 1: Experimental no Pré-lançamento)
As seguintes APIs estão na Fase 1: Experimental no Pré-lançamento e foram adicionadas neste SDK de Pré-lançamento.
API LaunchingExternalUriScheme no nível de quadro
O LaunchingExternalUriScheme evento agora também é gerado em CoreWebView2Frame, além de CoreWebView2. Isso permite que um host atribua uma inicialização de esquema de URI externo (como mailto:, tel:, ou um protocolo personalizado) para o específico iframe que o iniciou. Isso é útil quando vários subaplicativos estão hospedados em iframes, inclusive quando os iframes compartilham a mesma origem.
O LaunchingExternalUriScheme evento é gerado quando o conteúdo em um frame, ou em um iframe aninhado dentro dele, tenta iniciar um esquema de URI externo. Quando o lançamento se origina de um aninhado iframe, o evento borbulha para fora através dos ancestrais rastreados CoreWebView2Frame - começando com o quadro rastreado mais próximo (mais interno) e prosseguindo em direção ao quadro de nível superior - e finalmente para CoreWebView2. O remetente de eventos para cada invocação é o CoreWebView2Frame que recebe o evento.
CoreWebView2LaunchingExternalUriSchemeEventArgs tem uma nova Handled propriedade. Os manipuladores no nível de quadro são invocados antes dos CoreWebView2manipuladores no nível de quadro; se um manipulador no nível de quadro for definido HandledTRUEcomo , o evento não será gerado nos quadros ancestrais restantes ou em CoreWebView2.
Cancel continua a controlar se o URI é iniciado, enquanto Handled controla se os manipuladores restantes são invocados. Args (incluindo Cancel e Handled) são compartilhados entre camadas; para suprimir os manipuladores no nível do WebView ao fazer um Deferral, defina Handled antes de fazer o adiamento.
CoreWebView2FrameClasse:CoreWebView2LaunchingExternalUriSchemeEventArgsClasse:
API de Ambiente de Cluster Compartilhado
A API de ambiente de cluster compartilhado permite que aplicativos host cooperantes compartilhem explicitamente um ambiente WebView2, incluindo um processo de navegador e uma pasta de dados do usuário, concordando com um ClusterName. Os aplicativos não fornecem um caminho da pasta de dados do usuário; o WebView2 Runtime deriva do nome do cluster.
Um aplicativo host chama CoreWebView2Environment.CreateOrJoinClusterEnvironmentAsync com uma CoreWebView2ClusterEnvironmentOptions instância. O primeiro host a estabelecer o cluster determina suas opções em todo o processo. Hosts posteriores ingressam quando suas opções correspondem. Essas opções permanecem autoritativas enquanto o processo de navegador compartilhado estiver em execução; Depois de sair, o próximo host poderá estabelecer o cluster com opções diferentes.
A operação acima retorna um CoreWebView2ClusterEnvironmentCreateResult contendo um Status e, em caso de êxito, o .CoreWebView2Environment Valores possíveis de Status:
Succeededindica êxito. Um compartilhadoCoreWebView2Environmenté criado e retornado.OptionsMismatchIndica que um cluster em execução tem opções diferentes. Um compartilhadoCoreWebView2Environmentnão é criado e retornado.NotSupportedIndica que o host não pode usar ambientes de cluster, como um processo em área restritaAppContainer. Um compartilhadoCoreWebView2Environmentnão é criado e retornado.
Falhas ao iniciar ou concluir a operação são relatadas separadamente como exceções no .NET e no WinRT ou valores retornados com falha HRESULT no Win32.
Ligue CoreWebView2Environment.GetClusterEnvironmentOptions para ler as opções de um cluster em execução sem iniciar um navegador. Ele retorna null quando nenhum cluster está em execução ou o host não pode usar ambientes de cluster. O fluxo recomendado é ler as opções atuais, reutilizá-las se disponíveis e, em seguida, criar ou ingressar. Como outro host pode estabelecer um cluster entre essas chamadas, os aplicativos ainda devem lidar lendo OptionsMismatch as opções novamente e tentando novamente ou usando um ambiente privado.
PerHostProfileIsolation é habilitado por padrão e nomeia nomes de perfil por aplicativo host para impedir o compartilhamento acidental de perfil. Este não é um limite de segurança; Os membros do cluster devem confiar uns nos outros. O compartilhamento é suportado no mesmo usuário e sessão de logon, com hosts usando o mesmo nível de integridade, estado de elevação e WebView2 Runtime resolvido. Os aplicativos devem marcar o suporte ao tempo de execução e voltar para um ambiente privado quando a API não estiver disponível.
Consulte a especificação da API do Ambiente de Cluster Compartilhado do WebView2 .
-
Classe CoreWebView2ClusterEnvironmentOptions
- Propriedade CoreWebView2ClusterEnvironmentOptions.AdditionalBrowserArguments
- Propriedade CoreWebView2ClusterEnvironmentOptions.AllowSingleSignOnUsingOSPrimaryAccount
- Propriedade CoreWebView2ClusterEnvironmentOptions.AreBrowserExtensionsEnabled
- Propriedade CoreWebView2ClusterEnvironmentOptions.ChannelSearchKind
- Propriedade CoreWebView2ClusterEnvironmentOptions.ClusterName
- Propriedade CoreWebView2ClusterEnvironmentOptions.CustomSchemeRegistrations
- Propriedade CoreWebView2ClusterEnvironmentOptions.EnableTrackingPrevention
- Propriedade CoreWebView2ClusterEnvironmentOptions.Language
- Propriedade CoreWebView2ClusterEnvironmentOptions.PerHostProfileIsolation
- Propriedade CoreWebView2ClusterEnvironmentOptions.ReleaseChannels
-
Enumeração CoreWebView2ClusterEnvironmentStatus
NotSupportedOptionsMismatchSucceeded
-
CoreWebView2EnvironmentClasse: