Depuração remota HoloLens 2 aplicações WinUI 2 (UWP) do WebView2

Artigo
03/05/2025

Para utilizar o Microsoft Edge DevTools para depurar uma aplicação WebView2 WinUI 2 (UWP), utilize a depuração remota. A depuração remota é necessária para aplicações WebView2 WinUI 2 (UWP) porque, atualmente, as DevTools incorporadas não podem ser iniciadas numa aplicação WebView2 WinUI 2 (UWP) assinada pela loja.

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

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

Anexar DevTools remotamente a uma aplicação HoloLens 2 WebView2 WinUI 2 (UWP)

Anexe remotamente o Microsoft Edge DevTools a uma aplicação HoloLens 2 WebView2 WinUI 2 (UWP) da seguinte forma:

No Microsoft Edge, aceda a edge://inspect. É aberta a página Inspecionar com as Ferramentas de Programação do Edge :
Ativar o Portal do Dispositivo: abra as Definições do Windows, selecione Atualizar & Segurança>para programadores e, em seguida, ative o botão de alternar Portal do Dispositivo :

Em Ligar através> deEthernet, tenha em atenção o URL que será utilizado para a ligação de depuração remota.
Instale as Ferramentas Remotas para o Microsoft Edge a partir da Microsoft Store no seu dispositivo HoloLens 2.
No Microsoft Edge, aceda ao URL do Portal do Dispositivo que anotou anteriormente. Verifique se a página Confirmar definições de segurança está carregada (no separador Portal do Dispositivo Windows ):
Se estiver apenas a depurar aplicações que estão a ser executadas localmente, pode selecionar o botão Continuar com uma ligação não protegida .

Em alternativa, se não estiver a executar a aplicação localmente ou se precisar de se ligar através de HTTPS, selecione a ligação Configurar uma ligação segura e, em seguida, siga os passos na página para a qual foi redirecionado.
Verifique se foi redirecionado para a página Gestor de aplicações: Portal do Dispositivo Windows :
Aceda a http://<Device Portal URL>/msedge e verifique se as Ferramentas Remotas do Microsoft Edge estão a funcionar. A página carrega uma lista vazia: [], a menos que exista uma aplicação em execução que seja depurável por ferramentas remotas.
Configure a sua aplicação WebView2 WinUI 2 (UWP) para depuração remota:

Para ativar a depuração remota, tem de ser definida uma variável de ambiente no projeto. Esta variável tem de 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 estiver a utilizar a aplicação UWP de Exemplo WebView2, pode definir a variável de ambiente ao adicionar a seguinte linha no Browser.xaml.cs ficheiro:
```
Environment.SetEnvironmentVariable("WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS", "--enable-features=msEdgeDevToolsWdpRemoteDebugging");
```
A linha está numerada 33 nesta captura de ecrã, no Browser() construtor, abaixo de uma #endif que encapsula uma instrução existente SetEnvironmentVariable :
Inicie a sua aplicação no seu dispositivo HoloLens 2.
Aceda a http://<Device Portal URL>/msedge, como http://localhost:50080/msedge, e certifique-se de que a instância do WebView2 aparece na lista:
Saiba mais em edge://inspect. Na caixa de texto Ligar a um dispositivo Windows remoto , introduza http://<Device Portal URL>, como http://localhost:50080, e, em seguida, clique em Ligar ao Dispositivo.
Verifique se consegue estabelecer ligação com êxito, para que o seu controlo WebView2 depurável, denominado Edge, esteja listado sob o nome do computador:
Na parte inferior da entrada de controlo Edge WebView2, clique na ligação inspecionar . O Microsoft Edge DevTools é aberto para o controlo WebView2: