> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 桌面应用故障排除

在阻塞构建之前解决缺少工具链、空白窗口和发布签名失败。

## 安装与配置

在 Windows 上安装带 Windows SDK 的 C++ 生成工具和 WebView2 运行时。在 macOS 上安装 Xcode 命令行工具。在 Linux 上安装适用于你的发行版的 WebKitGTK、编译器、托盘和系统包。用 rustup 安装 Rust，重新打开终端，并在启动 Tauri 前运行 `cargo check`。

空白窗口通常意味着 `SUPASTACK_APP_URL` 无法访问或指向已停止的开发服务器；当已加载页面失去网络时会显示离线横幅。确认该 URL 能在同一台机器的浏览器中打开，并且你使用了预期的值构建。


## 实现流程

发布失败通常来自签名、公证或更新器块。检查 macOS 上的证书和钥匙串、Windows 上的签名证书和时间戳服务器、更新器公钥和端点路径，以及产品标识符。重新运行发布配置检查，然后在干净机器上安装产物，而不是覆盖开发构建。


## 验证与排障

应用启动、连接后端并顺利安装。


如果你想继续完成设置，可以阅读《[部署清单](https://supastack.dev/zh/docs/web/deployment.md)》。


## 下一篇

[部署清单](https://supastack.dev/zh/docs/web/deployment.md)