> ## 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

# 5 分鐘啟動桌面應用

準備 Rust 和作業系統的構建工具，啟動可訪問的 Web 後端，啟動 Tauri 視窗並驗證托盤、快捷方式和本地任務行為。

## 1.安裝通用工具和原生工具

完成 在開始之前，克隆您的桌面儲存庫或所有平臺 monorepo，並在編輯器中開啟它。桌面是圍繞同一 Web 應用程式的本機視窗。它不包括帳戶或聊天的第二次實施。安裝依賴項和本機工具後，開始五分鐘的啟動；首次安裝和 Rust 編譯通常需要更長的時間。

在 Windows 上，使用下面的 Tauri 先決條件連結安裝 Microsoft C++ 構建工具。在其安裝程式中選擇“使用 C++ 進行桌面開發”，保持選擇“Windows SDK”並完成安裝。確保已安裝 Microsoft Edge WebView2 執行時。使用 rustup-init.exe 從 rustup.rs 安裝 Rust；保留預設的 MSVC 工具鏈。安裝後重新開啟終端。

在 macOS 上，在終端中執行 xcode-select --install 並完成命令列工具對話方塊（如果未安裝）。使用 rustup.rs 中的 macOS 命令安裝 Rust。在 Linux 上，按照 Tauri 先決條件頁面獲取您的確切發行版的 WebKitGTK、編譯器、托盤和系統庫包，然後安裝 Rust。 Linux 軟體包名稱各不相同；不要執行其他發行版的命令。

在儲存庫根目錄開啟終端並執行下面的版本檢查。 rustc和cargo都必須列印版本； cargo 是 Rust 的構建工具。如果其中一個缺失，請完成安裝並重新開啟終端，然後再繼續。

[安裝工具並獲取程式碼](https://supastack.dev/zh-tw/docs/web/before-you-start.md)

[瞭解如何執行命令和編輯檔案](https://supastack.dev/zh-tw/docs/web/terminal-basics.md)

[Tauri 作業系統先決條件清單](https://tauri.app/start/prerequisites/)

[官方 Rust 安裝程式](https://rustup.rs/)

```
rustc --version
cargo --version
corepack pnpm install
```


## 2.啟動或選擇Web後端

如果您的結帳包含 apps/web，請按照 Web 教程建立 apps/web/.env.local，使用以下命令在單獨的終端中執行 Web 伺服器並使其保持執行。首先在瀏覽器中檢查 http://localhost:3000。無需資料庫即可使用/dashboard演示； /auth 處的真實登入需要遷移 Postgres。

僅桌面結帳不包含 apps/web. 使用為您的產品提供的單獨執行的 Web 後端，並在瀏覽器中開啟其 URL 以確認其正常工作。桌面 shell 無法為您建立後端。如果該資料夾不存在，請勿嘗試下面的 Web 命令。步驟 3 顯示如何選擇提供的後端地址。

[執行本地Web後端](https://supastack.dev/zh-tw/docs/web/ship-in-5-minutes.md)

[使用Postgres準備真實賬戶](https://supastack.dev/zh-tw/docs/web/database.md)

```
# Only when this checkout contains apps/web:
corepack pnpm --filter @supastack/web dev
```


## 3. 啟動桌面視窗

在後端保持執行的同時，在儲存庫根目錄中開啟第二個終端。對於 http://localhost:3000, 的預設本地後端，執行下面的第一個命令。 Cargo可以下載庫並編譯shell；等待 Supastack 視窗開啟。第一次構建期間的編譯器訊息是預期的。

對於提供的後端，請將下面相應作業系統塊中的 https://app.example.com 替換為其實際的 URL。僅執行您平臺的塊。 SUPASTACK_APP_URL 是終端環境設定，在本機程式啟動時讀取。僅將其放在 root .env 中不會配置 shell。保持後端 URL 沒有嵌入的使用者名稱或密碼。

在所有平臺 monorepo 中，一旦 pnpm 位於 PATH 上，corepack pnpm dev:desktop 就可以一起啟動 Web 和 Tauri，如開始之前中所述。下面的過濾命令也適用於僅桌面結帳，後端單獨執行。

```
# Default local backend (all operating systems):
corepack pnpm --filter @supastack/desktop dev

# Custom backend — Windows PowerShell only:
$env:SUPASTACK_APP_URL = 'https://app.example.com'
corepack pnpm --filter @supastack/desktop dev

# Custom backend — macOS / Linux only:
SUPASTACK_APP_URL=https://app.example.com corepack pnpm --filter @supastack/desktop dev
```


## 4.檢查視窗、托盤和快捷方式

成功意味著視窗顯示與瀏覽器後端相同的主頁。桌面視窗沒有瀏覽器位址列。要開啟無憑據演示，請使用托盤的退出操作退出 shell，然後在 Web 伺服器保持執行的同時在桌面終端中執行下面的作業系統塊。這直接載入/dashboard；按照那裡的網路教程的本地任務步驟進行操作。真實賬戶登入使用後端的資料庫，就像在瀏覽器中一樣。

使用關閉按鈕關閉視窗：應用程式應隱藏到托盤中而不是退出。單擊 Supastack 托盤圖示或在 Windows/Linux 上按 Ctrl + Shift + Space，或在 macOS 上按 Command + Shift + Space，以再次顯示它。使用托盤的退出操作退出。要完全結束開發，還可以在桌面終端中按 Ctrl + C，然後停止後端終端。

如果視窗為空或顯示連線問題，請首先在瀏覽器中開啟配置的 URL。啟動後端或修正URL，然後重新啟動Tauri。如果 Rust 報告未找到 linker.exe，請安裝 Windows C++ 工作負載並重新開啟終端。如果 Linux 報告缺少系統庫，請遵循特定於發行版的先決條件。如果熱鍵已被使用，請使用托盤並按照本機行為進行更改。

這將啟動本地開發視窗；它不會生成簽名的安裝程式或釋出應用程式。按照桌面發行版在另一臺計算機上進行安裝程式構建、平臺簽名和測試。 Windows 編譯不會驗證 macOS 或 Linux 行為。

[配置本機視窗和快捷方式行為](https://supastack.dev/zh-tw/docs/desktop/run.md)

[構建並驗證桌面安裝程式](https://supastack.dev/zh-tw/docs/desktop/release.md)

```
# Open the local demo — Windows PowerShell only:
$env:SUPASTACK_APP_URL = 'http://localhost:3000/dashboard'
corepack pnpm --filter @supastack/desktop dev

# Open the local demo — macOS / Linux only:
SUPASTACK_APP_URL=http://localhost:3000/dashboard corepack pnpm --filter @supastack/desktop dev
```


## 使用本地應用地址

未設定覆蓋值時，Tauri 會載入 http://localhost:3000。只有本地 Next.js 應用使用其他可訪問的 HTTP(S) 來源時才需要設定 SUPASTACK_APP_URL。帶憑據或非 Web 地址會被拒絕。

開發用 bundle identifier 和釋出配置尚不能用於正式產品。釋出前置檢查和平臺簽名請留到獨立的釋出指南中處理。


## 下一篇

[執行並配置外殼](https://supastack.dev/zh-tw/docs/desktop/run.md)