refactor: 重构项目架构与模块化设计

- 调整项目架构描述,明确 Tauri 仅提供原生桌面能力,业务逻辑由 Nitro Server 处理,并重构模块组织结构,将命令、Sidecar 进程管理等逻辑分离至独立模块。
- 移除未使用的 serde_json 依赖项
- 移除未使用的 serde_json 依赖项
- 添加原生桌面功能命令模块,包含用于从 Rust 向前端返回问候消息的示例命令。
- 重构代码结构,将核心功能拆分为独立模块,统一管理 Nitro 进程的启动与清理,并通过模块化方式提升可维护性。
- 添加 Nitro Sidecar 进程管理功能,自动查找可用端口、启动服务器、监听启动信号并创建主窗口,同时在应用退出时安全清理进程。
This commit is contained in:
2026-01-16 21:21:45 +08:00
parent fc90a29c03
commit 5ee6c148c7
6 changed files with 152 additions and 112 deletions

View File

@@ -4,9 +4,10 @@
## 项目概览
- **项目类型**: Tauri v2 桌面应用
- **项目类型**: Tauri v2 桌面应用(轻量级壳子)
- **后端**: Rust (Edition 2021)
- **架构**: Sidecar 模式集成 Nitro Server
- **架构**: Sidecar 模式 - Nitro Server 承载主要业务逻辑
- **设计理念**: Tauri 仅提供原生桌面能力文件对话框、系统通知等Web 逻辑全部由 Nitro 处理
- **异步运行时**: Tokio
- **Rust 版本**: 1.92.0+
@@ -80,8 +81,11 @@ cargo clean
```
tauri-demo/
├── src/
│ ├── lib.rs # 核心应用逻辑 (主要代码)
── main.rs # 入口文件 (仅调用 lib::run)
│ ├── main.rs # 入口文件 (仅调用 lib::run)
── lib.rs # 核心应用逻辑 (注册插件、命令、状态)
│ ├── commands/
│ │ └── mod.rs # 原生桌面功能命令 (文件对话框、通知等)
│ └── sidecar.rs # Nitro 进程管理 (启动、端口扫描、清理)
├── binaries/ # Sidecar 二进制文件
│ └── nitro-server-* # Nitro Server 可执行文件
├── capabilities/ # Tauri v2 权限配置
@@ -219,6 +223,23 @@ async fn is_port_available(port: u16) -> bool { }
## Tauri 特定规范
### 模块组织
- **`lib.rs`**: 主入口,负责注册插件、命令、状态管理
- **`commands/mod.rs`**: 所有 Tauri 命令集中定义,命令必须是 `pub fn`
- **`sidecar.rs`**: Sidecar 进程管理逻辑,导出公共 API
```rust
// lib.rs - 模块声明
mod commands;
mod sidecar;
use sidecar::NitroProcess;
// 注册命令时使用模块路径
.invoke_handler(tauri::generate_handler![commands::greet])
```
### 命令定义
- 使用 `#[tauri::command]` 宏标记命令
@@ -287,8 +308,10 @@ match event {
```toml
tauri = { version = "2", features = [] }
tokio = { version = "1", features = ["net"] }
tauri-plugin-opener = "2"
tauri-plugin-shell = "2"
serde = { version = "1", features = ["derive"] }
tokio = { version = "1", features = ["net"] }
```
## 开发工具