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 /ja/docs/desktop/troubleshooting.md (or send Accept: text/markdown).
デスクトップアプリのトラブルシューティング
ビルドを妨げる前に、不足したツールチェーン、空白のウィンドウ、リリース署名の失敗を解決します。
インストールとセットアップ
Windows では Windows SDK 付きの C++ Build Tools と WebView2 ランタイムをインストールします。macOS では Xcode コマンドラインツールをインストールします。Linux ではディストリビューション向けの WebKitGTK、コンパイラー、トレイ、システムパッケージをインストールします。rustup で Rust を入れ、ターミナルを開き直し、Tauri を起動する前に cargo check を実行してください。
空白のウィンドウは通常、SUPASTACK_APP_URL に到達できないか、停止した開発サーバーを指しています。読み込んだページがネットワークを失うとオフラインバナーが表示されます。同じマシンのブラウザーで URL が開くこと、意図した値でビルドしたことを確認してください。
実装ワークフロー
リリースの失敗は通常、署名、公証、アップデーターブロックに起因します。macOS では証明書とキーチェーン、Windows では署名証明書とタイムスタンプサーバー、アップデーターの公開鍵とエンドポイントパス、製品識別子を確認します。リリース設定チェックを再実行し、開発ビルドの上書きではなくクリーンなマシンに成果物をインストールしてください。
検証とトラブルシューティング
アプリが起動し、バックエンドに到達し、クリーンにインストールされます。