For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /pt/docs/desktop/troubleshooting.md (or send Accept: text/markdown).
Resolução de problemas da aplicação de desktop
Resolve toolchains em falta, janelas em branco e falhas de assinatura de release antes de bloquearem uma build.
Instalação e configuração
No Windows instala as C++ Build Tools com o Windows SDK e o runtime WebView2. No macOS instala as ferramentas de linha de comandos do Xcode. No Linux instala os pacotes WebKitGTK, compilador, bandeja e sistema indicados para a tua distribuição. Instala o Rust com rustup, reabre o terminal e executa cargo check antes de iniciar o Tauri.
Uma janela em branco significa normalmente que SUPASTACK_APP_URL está inacessível ou aponta para um servidor de desenvolvimento parado; o aviso offline aparece quando a página carregada perde a rede. Confirma que o URL abre num navegador na mesma máquina e que compilaste com o valor pretendido.
Fluxo de implementação
As falhas de release vêm normalmente da assinatura, notarização ou do bloco do atualizador. Verifica o certificado e o porta-chaves no macOS, o certificado de assinatura e o servidor de timestamp no Windows, a chave pública do atualizador e o caminho do endpoint, e o identificador do produto. Volta a executar a verificação da configuração de release e instala o artefacto numa máquina limpa em vez de sobre a build de desenvolvimento.
Verificação e resolução de problemas
A aplicação arranca, alcança o backend e instala-se sem problemas.