> ## 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-tw/docs/web/deployment.md)》。


## 下一篇

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