> ## 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/docs/web/before-you-start.md)

[了解如何运行命令和编辑文件](https://supastack.dev/zh/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/docs/web/ship-in-5-minutes.md)

[使用Postgres准备真实账户](https://supastack.dev/zh/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/docs/desktop/run.md)

[构建并验证桌面安装程序](https://supastack.dev/zh/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/docs/desktop/run.md)