Testar as próximas APIs e recursos

Este artigo explica como alternar para um canal de visualização do Microsoft Edge para testar APIs experimentais que estão em um pacote SDK de pré-lançamento do WebView2.

Para testar APIs e recursos novos ou futuros, alterne para um canal de visualização do Microsoft Edge em vez de usar o WebView2 Runtime estável. O Evergreen WebView2 Runtime é atualizado frequentemente para adicionar novas APIs e funcionalidades. Essas atualizações podem incluir APIs que foram promovidas de um SDK do WebView2 de pré-lançamento para Stable o SDK da Experimental versão do WebView2. Algumas das atualizações no Evergreen WebView2 Runtime podem potencialmente quebrar seu aplicativo WebView2.

Recomendamos que você teste as APIs experimentais com antecedência, antes de serem promovidas para Estável no SDK de lançamento do WebView2, alternando para um canal de visualização do Microsoft Edge (que inclui WebView2), para garantir que seu aplicativo seja compatível com versões anteriores.

Veja também:

Use um canal de visualização do WebView2 para testar seu aplicativo em relação às APIs experimentais mais recentes do WebView2

O Evergreen WebView2 Runtime não inclui APIs experimentais do WebView2. Em vez disso, para usar esses recursos experimentais em seu código WebView2, faça com que seu aplicativo use a versão do WebView2 que está em um canal de visualização do Microsoft Edge (Edge Beta, Edge Dev ou Edge Canary).

O canal Canary é recomendado, pois oferece as APIs experimentais mais recentes.

Interação entre o SDK de Pré-lançamento do WebView2 e os Canais de Visualização do Microsoft Edge

  • SDK de pré-lançamento: Esta versão do SDK do WebView2 fornece assinaturas de método para APIs experimentais, que permitem escrever código usando as APIs experimentais do WebView2 em seu aplicativo.

  • Canais de Visualização do Microsoft Edge: Esses canais (Edge Beta, Edge Dev ou Edge Canary) contêm os binários necessários do Microsoft Edge. Esses canais permitem que seu aplicativo seja executado e renderizado usando as APIs experimentais.

Para obter mais informações sobre como as versões do SDK interagem com o WebView2 Runtime e os canais de visualização do Microsoft Edge, consulte SDKs de pré-lançamento e lançamento para o WebView2.

Teste de compatibilidade com versões futuras usando o canal de visualização

Recomendamos que você teste as próximas alterações usando canais de visualização para garantir a compatibilidade direta do seu aplicativo, seguindo estas práticas recomendadas:

Baixar o SDK de pré-lançamento e um canal de visualização

Para usar APIs experimentais, baixe uma versão de pré-lançamento do SDK do WebView2 do pacote Microsoft.Web.WebView2.

Os canais de visualização do Microsoft Edge incluem a visualização do WebView2 Runtime. Os canais de visualização também são chamados de canais Insider. Depois de instalados, os canais de visualização permanecem atualizados; A versão mais recente de cada canal de visualização é instalada automaticamente. Por exemplo, isso significa que o canal Canary será atualizado quase diariamente.

Para baixar um canal de visualização do Microsoft Edge (Beta, Dev ou Canary), acesse Torne-se um Microsoft Edge Insider.

Para implantar o canal de visualização em vários computadores, consulte Como implantar canais de visualização, abaixo.

Abordagens para fazer seu aplicativo usar um canal de navegador específico

Quando um WebView2 for inicializado, ele tentará encontrar um runtime válido no computador a ser usado. Pode ser o WebView2 Runtime, um canal de visualização do Microsoft Edge ou um local especificado que contenha binários de Versão Fixa. Para obter mais informações sobre os tempos de execução com suporte, consulte Distribuir seu aplicativo e o WebView2 Runtime.

Há duas maneiras de fazer com que seu aplicativo WebView2 use um canal de visualização específico do Microsoft Edge:

Essas abordagens são descritas abaixo.

Esta seção se aplica ao uso de uma API, substituição de registro, variável de ambiente ou política de grupo.

Se uma pasta executável do navegador específica não for especificada, o WebView2 tentará carregar um runtime de um dos locais padrão conhecidos. Por padrão, o carregador do WebView2 pesquisa tempos de execução do mais estável para o menos estável (Canary), usando o primeiro tempo de execução encontrado.

WebView2 Runtime (Stable) ->  Edge Beta -> Edge Dev -> Edge Canary

Você pode reverter a ordem de pesquisa padrão definindo a ChannelSearchKind API como LeastStable, ou definindo a política, a chave do Registro ou a ChannelSearchKind variável de ambiente como 1. Inverter a ordem de pesquisa faz com que a pesquisa do carregador WebView2 seja menos estável (Canary) para mais estável:

Edge Canary -> Edge Dev -> Edge Beta -> WebView2 Runtime (Stable)

Isso deve ser feito antes que o controle WebView2 seja inicializado.

Se você precisar de uma ordem mais específica, consulte Como usar ChannelSearchKind para garantir que um canal específico seja usado.

Por padrão, a CoreWebView2EnvironmentOptions.ChannelSearchKind propriedade é CoreWebView2ChannelSearchKind.MostStable (um valor de enumeração). Em vez disso, inverta a ordem de pesquisa definindo a CoreWebView2EnvironmentOptions.ChannelSearchKind propriedade como CoreWebView2ChannelSearchKind.LeastStable.

.NET:

WinRT:

Win32:

Como usar ChannelSearchKind para garantir que um canal específico seja usado

Ao usar o ChannelSearchKind, veja como você pode garantir que um determinado canal de visualização do navegador seja usado quando você tiver vários canais de visualização do navegador instalados.

Além de inverter a ordem de pesquisa de canal, você pode modificar o conjunto de canais de lançamento a serem incluídos na pesquisa, para fornecer maior controle sobre a seleção de canal. O carregador procurará canais no dispositivo na ordem especificada pelo tipo de pesquisa de canal, mas só considerará canais que estão no conjunto especificado de canais de lançamento.

Essa opção é útil se você deseja direcionar um canal específico, em vez de simplesmente escolher o canal mais ou menos estável. Por padrão, os canais de lançamento incluem todos os canais: Estável (0), Beta (1), Dev (2) e Canário (3).

Exemplo:

Channel Search Kind: 1 (Least Stable)
Release Channels: 0 (Stable), 1 (Beta)

Essa configuração de exemplo faz com que o carregador tente executar o aplicativo com o Edge Beta se o Edge Beta estiver instalado no dispositivo e, caso contrário, volte a usar o WebView2 Runtime Estável.

Os canais de lançamento também podem ser definidos por meio da API, chave do Registro, variável de ambiente ou política de grupo.

Por padrão, o carregador considera todos os canais de lançamento. Defina ReleaseChannels como uma máscara dos canais que você gostaria que o carregador procurasse.

.NET:

WinRT:

Win32:

Configurando a pasta executável do navegador (para teste local)

Uma abordagem alternativa é usar uma pasta executável do navegador. Nessa abordagem, você especifica uma pasta que contém binários de tempo de execução. Esta pasta pode ser qualquer um dos seguintes locais:

  • O local instalado do WebView2 Runtime.
  • Um canal de visualização do Microsoft Edge.
  • Uma pasta que contém binários de Versão Fixa que você mesmo implantou no computador.

Se você definir a pasta executável do navegador para um canal de visualização específico do Microsoft Edge, precisará atualizar o local quando o canal de visualização for atualizado para uma versão mais recente. Isso ocorre porque o local inclui o número de versão como parte de seu caminho. Portanto, recomendamos usar essa abordagem apenas para testes locais.

Passe o caminho para a pasta executável do navegador durante a criação do ambiente, usando as APIs a seguir.

.NET (WPF):

.NET (WinForms):

WinRT:

Win32:

Quando o novo tempo de execução for selecionado

Se você estiver usando uma variável de ambiente, chave do Registro ou política de grupo, elas serão aplicadas apenas a quaisquer novos processos do navegador WebView2 Runtime criados; eles não se aplicam aos processos do navegador WebView2 Runtime que já estão em execução. Por exemplo, se você já tiver um WebView2 com uma pasta de dados do usuário específica (e, portanto, um processo de navegador correspondente) e alterar ChannelSearchKind antes de tentar criar um novo WebView2 usando a mesma pasta de dados do usuário, ele usará o processo do navegador WebView2 Runtime existente e não procurará um runtime diferente.

Para garantir que todos os processos usem a variável de ambiente, a chave do Registro ou a política de grupo, você precisa seguir um destes procedimentos:

  • Reinicie o aplicativo.
  • Recrie todos os controles WebView2 que compartilham uma pasta de dados do usuário.
  • Crie um novo WebView2 que tenha uma pasta de dados do usuário diferente de qualquer outro controle WebView2 em execução no momento.

Como definir uma variável de ambiente

Você pode usar várias abordagens para definir variáveis de ambiente:

  • Definindo variáveis de ambiente usando APIs para um aplicativo específico.
  • Definindo variáveis ambientais globalmente, para todos os aplicativos.

Essas abordagens são descritas abaixo.

Definindo variáveis ambientais usando APIs para um aplicativo específico

Você pode definir variáveis de ambiente usando o SetEnvironmentVariable. Chamar essa função de seu aplicativo host limita o escopo da variável de ambiente apenas ao seu aplicativo host e aos controles WebView2 que ela cria e não afeta outros aplicativos no sistema.

Definindo variáveis ambientais globalmente, para todos os aplicativos

Você pode definir variáveis de ambiente usando a interface do usuário do sistema Windows. Essa abordagem torna o escopo da variável de ambiente global para o usuário ou sistema atual e afeta todos os aplicativos que criam controles WebView2.

  1. Na barra de pesquisa do Windows, insira "ambiente" e selecione Editar as variáveis de ambiente do sistema:

    Usando a barra de pesquisa do Windows para descobrir onde editar variáveis de ambiente

    A caixa de diálogo Propriedades do Sistema é aberta.

  2. Selecione a guia Avançado e clique no botão Variáveis de Ambiente :

    O botão Variáveis de Ambiente na caixa de diálogo Propriedades do Sistema

    A caixa de diálogo Variáveis de Ambiente é aberta.

  3. Na seção Variáveis de usuário na parte superior, clique no botão Novo . A caixa de diálogo Nova Variável de Usuário é aberta.

  4. Na caixa de texto Nome da variável , insira o nome da variável de ambiente, ou WEBVIEW2_CHANNEL_SEARCH_KINDWEBVIEW2_BROWSER_EXECUTABLE_FOLDER.

  5. Na caixa de texto Valor da variável , siga um destes procedimentos:

    • Se estiver configurando o ChannelSearchKind, insira 1 para inverter a ordem de pesquisa do padrão para usar os canais de visualização primeiro (Canary, Beta e Dev), seguidos pelo WebView2 Runtime. Qualquer valor diferente que faça com que 1 a ordem de pesquisa padrão seja usada (WebView2 Runtime, Edge Dev, Edge Beta e, em seguida, Edge Canary).

    • Se estiver configurando o BrowserExecutableFolder, insira o caminho para o canal do navegador preferido ou binários de versão fixa.

  6. Clique nos botões OK para fechar as caixas de diálogo.

Como implantar canais de visualização

Para implantar os canais de visualização do Microsoft Edge em vários computadores, execute um dos seguintes procedimentos:

  • Opção 1: instalar manualmente os canais de visualização nos computadores.

  • Opção 2: implantar programaticamente canais de visualização por meio de pontos de extremidade de API.

Essas opções são explicadas abaixo.

Opção 1: Instalar manualmente canais de visualização em computadores

Os canais de visualização podem ser instalados manualmente (manualmente ou por meio de um script personalizado implantado) por meio dos seguintes links corporativos:

Canal Link
Canário Download
Desenvolvimento Download
Beta Download

A instalação manual só precisa ser feita uma vez por máquina. Os canais de pré-lançamento são perenes, portanto, serão atualizados automaticamente quando versões mais recentes estiverem disponíveis.

Opção 2: implantar programaticamente canais de visualização por meio de pontos de extremidade de API

No código do seu aplicativo, escreva sua própria lógica personalizada para implantar a versão mais recente de um canal de visualização do Microsoft Edge da seguinte maneira:

  1. Chame o seguinte ponto de extremidade de API que corresponde ao canal de visualização que você deseja implantar:

    Canal Link
    Canário https://edgeupdates.microsoft.com/api/products/canary
    MSI Link
    Desenvolvimento https://edgeupdates.microsoft.com/api/products/dev
    Beta https://edgeupdates.microsoft.com/api/products/beta

    O canal Canary tem um link MSI separado. Os canais Dev e Beta contêm links MSI.

  2. Busque o pacote mais recente no dispositivo.

  3. Instale o pacote.

Confira também

Documentos empresariais:

Microsoft Intune:

Versões e canais de visualização do Microsoft Edge:

  • Last updated on