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 /es/docs/desktop/troubleshooting.md (or send Accept: text/markdown).
Solución de problemas de la app de escritorio
Resuelve toolchains ausentes, ventanas en blanco y fallos de firma de release antes de que bloqueen un build.
Configuración y ajustes
En Windows instala las C++ Build Tools con el Windows SDK y el runtime de WebView2. En macOS instala las herramientas de línea de comandos de Xcode. En Linux instala los paquetes WebKitGTK, compilador, bandeja y sistema indicados para tu distribución. Instala Rust con rustup, vuelve a abrir la terminal y ejecuta cargo check antes de iniciar Tauri.
Una ventana en blanco suele significar que SUPASTACK_APP_URL no es accesible o apunta a un servidor de desarrollo detenido; el aviso sin conexión aparece cuando la página cargada pierde la red. Confirma que la URL abre en un navegador en la misma máquina y que compilaste con el valor previsto.
Flujo de implementación
Los fallos de release suelen venir de la firma, la notarización o el bloque del actualizador. Revisa el certificado y el llavero en macOS, el certificado de firma y el servidor de marcas de tiempo en Windows, la clave pública del actualizador y la ruta del endpoint, y el identificador del producto. Vuelve a ejecutar la comprobación de configuración de release y luego instala el artefacto en una máquina limpia en lugar de sobre el build de desarrollo.
Verificación y solución de problemas
La app se inicia, alcanza el backend y se instala correctamente.