Depuração remota HoloLens 2 aplicativos WebView2 WinUI 2 (UWP)

Artigo
12/21/2023

Para usar o Microsoft Edge DevTools para depurar um aplicativo UWP (WebView2 WinUI 2), use a depuração remota. A depuração remota é necessária para aplicativos UWP (WebView2 WinUI 2) porque, atualmente, os DevTools internos não podem ser iniciados dentro de um aplicativo WebView2 WinUI 2 (UWP) assinado pela loja.

O WebView2 no HoloLens 2 e o plug-in do WebView para Unity estão em Versão Prévia e estão sujeitos a alterações antes da disponibilidade geral.

O WebView2 e o plug-in WebView2 só têm suporte em dispositivos HoloLens 2 que executam a atualização Windows 11. Para obter mais informações, consulte Atualizar HoloLens 2.

Anexar DevTools remotamente a um aplicativo do HoloLens 2 WebView2 WinUI 2 (UWP)

Anexe o Microsoft Edge DevTools remotamente a um aplicativo HoloLens 2 WebView2 WinUI 2 (UWP) da seguinte maneira:

No Microsoft Edge, acesse edge://inspect. A página Inspecionar com Ferramentas de Desenvolvedor do Edge é aberta:
Habilitar o Portal do Dispositivo: abra configurações do Windows, selecione Atualizar & Segurança>para desenvolvedores e ative o alternância do Portal do Dispositivo :

Em Conectar usando>ethernet, observe a URL que será usada para a conexão de depuração remota.
Instale ferramentas remotas para o Microsoft Edge na Microsoft Store em seu dispositivo HoloLens 2.
No Microsoft Edge, acesse a URL do Portal do Dispositivo que você observou anteriormente. Verifique se a página Confirmar configurações de segurança está carregada (na guia Portal do Dispositivo windows ):
Se você estiver apenas depurando aplicativos que estão em execução localmente, poderá selecionar o botão Continuar com uma conexão sem segurança .

Ou, se você não estiver executando o aplicativo localmente ou se precisar se conectar por HTTPS, selecione o link Configurar uma conexão segura e siga as etapas na página à qual você é redirecionado.
Verifique se você foi redirecionado para o Gerenciador de Aplicativos: página do Portal do Dispositivo do Windows :
http://<Device Portal URL>/msedge Acesse e verifique se as ferramentas remotas do Microsoft Edge estão funcionando. A página carrega uma lista vazia: [], a menos que haja um aplicativo em execução que seja depurável por ferramentas remotas.
Configure seu aplicativo WebView2 WinUI 2 (UWP) para depuração remota:

Para habilitar a depuração remota, uma variável de ambiente deve ser definida em seu projeto. Essa variável deve ser definida antes de criar a CoreWebView2 instância e antes de definir a WebView2.Source propriedade ou chamar o WebView2.EnsureCoreWebView2Async método.

Defina a seguinte variável:
```
"WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS", "--enable-features=msEdgeDevToolsWdpRemoteDebugging"
```
Por exemplo, se você estiver usando o aplicativo UWP de Exemplo do WebView2, poderá definir a variável de ambiente adicionando a seguinte linha no Browser.xaml.cs arquivo:
```
Environment.SetEnvironmentVariable("WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS", "--enable-features=msEdgeDevToolsWdpRemoteDebugging");
```
A linha é numerada 33 nesta captura de tela, no Browser() construtor, abaixo de uma #endif que envolve uma instrução existente SetEnvironmentVariable :
Inicie seu aplicativo em seu dispositivo HoloLens 2.
Vá para http://<Device Portal URL>/msedge, como http://localhost:50080/msedge, e certifique-se de que sua instância do WebView2 seja exibida na lista:
Saiba mais em edge://inspect. Na caixa de texto Conectar a um dispositivo Windows remoto , insira http://<Device Portal URL>, como http://localhost:50080, e clique em Conectar ao Dispositivo.
Verifique se você pode se conectar com êxito para que o controle WebView2 depurável, chamado Edge, esteja listado no nome do computador:
Na parte inferior da entrada de controle do Edge WebView2, clique no link inspecionar . O Microsoft Edge DevTools abre para o controle WebView2: