SDK de pré-lançamento 1.0.4255-pré-lançamento, para Runtime 154 (11 de setembro de 2026)

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.

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:

  • Succeeded indica êxito. Um compartilhado CoreWebView2Environment é criado e retornado.

  • OptionsMismatch Indica que um cluster em execução tem opções diferentes. Um compartilhado CoreWebView2Environment não é criado e retornado.

  • NotSupported Indica que o host não pode usar ambientes de cluster, como um processo em área restrita AppContainer . Um compartilhado CoreWebView2Environment nã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 .

Confira também