Janela em branco no Windows Server (WebView2)

Sintoma

Quando abre o cliente Polpo Desk no Windows Server (por exemplo, Windows Server 2016 ou 2019), a janela fica em branco, branca ou preta; o ID de ligação e a palavra-passe nunca aparecem. A janela pode mostrar apenas uma mensagem de estado, ou nada.

Causas prováveis

• O Microsoft Edge WebView2 Runtime não está instalado. A interface do cliente Polpo Desk é desenhada com o componente WebView2 da Microsoft. As versões atuais do Windows 10 e 11 incluem-no, mas no Windows Server 2016/2019 e em algumas instalações mais antigas do Windows 10 não está instalado.
• Servidores sem placa gráfica (GPU) e sessões RDP. Sem aceleração por hardware, o WebView2 pode desenhar a janela a preto.
• Uma versão antiga do cliente. As versões antigas não detetam a falta do WebView2 ou não o conseguem transferir por causa das definições de segurança do Internet Explorer do Windows Server.

Como resolver

1. Aceitar a instalação do WebView2 proposta pelo cliente

Se faltar o WebView2, o cliente atual deteta-o no arranque e pergunta-lhe:

1. Clique em Sim na caixa de diálogo.
2. O cliente transfere o instalador oficial da Microsoft (cerca de 2 MB), verifica a assinatura da Microsoft e instala o componente de forma silenciosa. O progresso é apresentado na janela.
3. Como o instalador transfere o componente propriamente dito a partir da Microsoft, isto pode demorar alguns minutos, consoante a velocidade da sua Internet. Quando terminar, a interface carrega por si só.

Se clicar em Não, a janela indica-lhe que instale o componente e volte a abrir o Polpo Desk.

2. Instalar o WebView2 manualmente

Se a instalação automática falhar, a janela mostra a mensagem "Could not download WebView2" (não foi possível transferir o WebView2) ou "WebView2 could not be installed" (não foi possível instalar o WebView2). Nesse caso:

1. Transfira o instalador "Evergreen" do Microsoft Edge WebView2 Runtime a partir do site da Microsoft (se não o conseguir transferir no servidor, transfira-o noutro computador e copie-o).
2. Execute o instalador como administrador.
3. Feche e volte a abrir o Polpo Desk.

3. Atualizar o cliente

Se estiver a utilizar uma versão antiga, a falta do WebView2 pode não ser detetada ou a transferência pode ser bloqueada pela Configuração de Segurança Avançada do Internet Explorer (IE ESC) no Windows Server. A partir da versão 0.9.106, esta transferência é feita com um método que o IE ESC não afeta. Obtenha o cliente mais recente na página de transferências; para problemas de atualização, consulte Erro "Não foi possível contactar o servidor" ao atualizar.

4. Servidores sem GPU e sessões RDP

Quando o cliente atual deteta que está a ser executado no Windows Server ou numa sessão RDP, desenha automaticamente a sua interface sem aceleração por hardware (por software). Como a interface é pequena, isto não afeta o desempenho. Se a janela continuar preta, atualize o cliente.

O cliente também tenta novamente por si só quando não é possível carregar a interface ou quando o processo do WebView2 falha. Se a janela se corrigir sozinha passado algum tempo, é este mecanismo a funcionar.

5. A janela fica preta quando aberta a partir da área de notificação

Se o cliente arrancar na área de notificação quando o computador é iniciado e a janela ficar preta quando a abre a partir daí, isto foi corrigido na versão 0.9.100. Atualize o seu cliente.

Quando contactar o suporte

Se o WebView2 estiver instalado e o cliente estiver atualizado, mas a janela continuar em branco, contacte-nos. Anexe ao seu pedido o ficheiro %TEMP%\polpodesk-native.log; as linhas que começam por webview e webview2-setup mostram a causa. Para abrir um pedido de suporte, consulte Criar e acompanhar um pedido de suporte; para os sistemas suportados, consulte Requisitos do sistema e definições de rede.