47 lines
1.7 KiB
Plaintext
47 lines
1.7 KiB
Plaintext
---
|
||
description: Tauri 2 桌面壳、窗口与单例规范
|
||
globs: src-tauri/**/*
|
||
alwaysApply: false
|
||
---
|
||
|
||
# Tauri 桌面规范
|
||
|
||
## 窗口配置（`tauri.conf.json`）
|
||
|
||
- 主窗口 `label`: `"main"`（单例回调中通过此 label 获取窗口）
|
||
- `decorations: false` — 无边框；`resizable: true`
|
||
- `identifier`: `com.aiclient.desktop`（避免以 `.app` 结尾）
|
||
|
||
## 单例运行
|
||
|
||
- 插件：`tauri-plugin-single-instance`
|
||
- 二次启动时：对 `main` 窗口 `unminimize` → `show` → `set_focus`，**不**新建窗口
|
||
- 注册于 `src-tauri/src/lib.rs`，需 `use tauri::Manager`
|
||
|
||
```rust
|
||
.plugin(tauri_plugin_single_instance::init(|app, _args, _cwd| {
|
||
if let Some(window) = app.get_webview_window("main") {
|
||
let _ = window.unminimize();
|
||
let _ = window.show();
|
||
let _ = window.set_focus();
|
||
}
|
||
}))
|
||
```
|
||
|
||
## 权限（`capabilities/default.json`）
|
||
|
||
- 拖动窗口需：`core:window:allow-start-dragging`
|
||
- 前端标题栏元素使用 `data-tauri-drag-region`（在 aiclient_ui 的 `AppTitlebar.vue`）
|
||
|
||
## Rust 约定
|
||
|
||
- 入口逻辑在 `src/lib.rs`；`main.rs` 仅调用 `tauri_app_lib::run()`
|
||
- 新增 Tauri 命令：在 `lib.rs` 用 `#[tauri::command]` 定义，并在 `invoke_handler` 注册
|
||
- 前端调用：`import { invoke } from "@tauri-apps/api/core"`
|
||
|
||
## 开发注意
|
||
|
||
前端在 **`../aiclient_ui`** 开发并 **`npm run build:deploy`** 部署到服务器；**`tauri build` 不编译前端**。发布版 WebView 加载 `http://81.71.163.140/images/newyaoyan/`（见 `lib.rs`）。
|
||
- 修改 capabilities 或插件后需重新 `tauri dev` / `tauri:build`
|
||
- 发布构建使用 `npm run tauri:build`：`bundle.targets` 为空，跳过 MSI/NSIS；构建结束后由 `src-tauri/scripts/zip-portable.cjs` 生成 `target/release/bundle/zip/*.zip`
|