feat: 添加 Tauri 桌面应用支持及完整开发环境配置

- 添加 Rust、Tauri 和 Even Better TOML 语言支持扩展以增强开发环境功能。
- 修改构建配置中的输出目录为 src-tauri/binaries,以适配新的构建输出路径。
- 添加 Tauri CLI 及其各平台兼容的可执行文件依赖,以支持多平台应用开发。
- 添加最新版本的 Rust 工具支持并移除旧版本的 Bun。
- 添加 Tauri CLI 工具以支持桌面应用开发
- 添加 Tauri 项目生成文件和构建产物的忽略规则
- 新增项目开发指南文档,明确 Tauri 桌面应用的构建流程、代码风格、Tauri 特定规范及最佳实践。
- 添加 Tauri 构建脚本以支持应用打包和构建流程
- 添加主窗口权限配置,允许执行名为 binaries/server 的侧车二进制文件。
- 生成新的 Cargo.lock 文件以更新项目依赖项的版本和校验和
- 添加 Tauri 应用的 Cargo 项目配置,包含 shell 插件和异步运行时支持。
- 添加32x32像素图标文件以支持应用图标显示
- 添加128x128像素图标文件以支持应用图标显示
- 添加高分辨率图标文件以支持高清显示
- 添加应用图标文件以支持 macOS 平台的图标显示
- 添加图标文件以用于应用程序的视觉标识
- 添加应用图标文件
- 添加方形30x30像素的图标文件以支持应用启动画面和系统显示
- 添加方形44x44像素应用图标文件
- 添加方形71x71像素应用图标以支持不同平台显示需求
- 添加新的方形89x89像素应用图标文件
- 添加新的正方形107x107像素应用图标文件
- 添加方形142x142像素的图标文件以支持应用启动画面和系统显示
- 添加新的方形150x150像素图标文件以用于应用程序界面显示
- 添加新的方形284x284像素应用图标文件
- 添加新的方形310x310像素应用图标文件
- 添加应用商店图标文件
- 添加原生桌面功能命令模块,包含示例问候函数以支持从 Rust 向前端传递消息。
- 添加侧车进程管理功能并注册全局状态与生命周期事件处理
- 添加启动配置以在发布模式下防止Windows出现额外控制台窗口,并启动应用主函数。
- 添加 Sidecar 服务启动与管理功能,自动查找可用端口、启动后端服务并创建主窗口,同时支持超时检测和进程清理。
- 添加 Tauri 项目配置文件并设置应用基本信息、打包选项及图标路径
This commit is contained in:
2026-01-18 15:09:20 +08:00
parent e016ad99f5
commit 8004bf51a8
32 changed files with 5409 additions and 3 deletions

View File

@@ -0,0 +1,8 @@
// 原生桌面功能命令
// 未来可能包含: 文件对话框、系统通知、剪贴板等
// 示例命令 (可根据需要删除或替换)
#[tauri::command]
pub fn greet(name: &str) -> String {
format!("Hello, {}! You've been greeted from Rust!", name)
}

35
src-tauri/src/lib.rs Normal file
View File

@@ -0,0 +1,35 @@
use tauri::Manager;
// 模块声明
mod commands;
mod sidecar;
use sidecar::SidecarProcess;
#[cfg_attr(mobile, tauri::mobile_entry_point)]
pub fn run() {
tauri::Builder::default()
.plugin(tauri_plugin_shell::init())
.setup(|app| {
// 注册全局状态
app.manage(SidecarProcess(std::sync::Mutex::new(None)));
// 启动 Sidecar 进程
let app_handle = app.handle().clone();
sidecar::spawn_sidecar(app_handle);
Ok(())
})
.invoke_handler(tauri::generate_handler![commands::greet])
.build(tauri::generate_context!())
.expect("error while building tauri application")
.run(|app_handle, event| {
// 监听应用退出事件,清理 Sidecar 进程
match event {
tauri::RunEvent::ExitRequested { .. } | tauri::RunEvent::Exit => {
sidecar::cleanup_sidecar_process(app_handle);
}
_ => {}
}
});
}

6
src-tauri/src/main.rs Normal file
View File

@@ -0,0 +1,6 @@
// Prevents additional console window on Windows in release, DO NOT REMOVE!!
#![cfg_attr(not(debug_assertions), windows_subsystem = "windows")]
fn main() {
tauri_shell_lib::run()
}

131
src-tauri/src/sidecar.rs Normal file
View File

@@ -0,0 +1,131 @@
use std::sync::Mutex;
use std::time::Duration;
use tauri::Manager;
use tauri_plugin_shell::process::{CommandChild, CommandEvent};
use tauri_plugin_shell::ShellExt;
// ===== 配置常量 =====
/// Sidecar Server 启动超时时间(秒)
const STARTUP_TIMEOUT_SECS: u64 = 5;
/// 默认起始端口
const DEFAULT_PORT: u16 = 3000;
/// 端口扫描范围(从起始端口开始扫描的端口数量)
const PORT_SCAN_RANGE: u16 = 100;
/// 窗口默认宽度
const DEFAULT_WINDOW_WIDTH: f64 = 1200.0;
/// 窗口默认高度
const DEFAULT_WINDOW_HEIGHT: f64 = 800.0;
/// 窗口标题
const WINDOW_TITLE: &str = "Tauri App";
// ===== 数据结构 =====
/// 全局状态:存储 Sidecar 进程句柄
pub struct SidecarProcess(pub Mutex<Option<CommandChild>>);
// 检查端口是否可用
async fn is_port_available(port: u16) -> bool {
tokio::net::TcpListener::bind(format!("127.0.0.1:{}", port))
.await
.is_ok()
}
// 查找可用端口
async fn find_available_port(start: u16) -> u16 {
for port in start..start + PORT_SCAN_RANGE {
if is_port_available(port).await {
return port;
}
}
start // 回退到起始端口
}
/// 启动 Sidecar 进程并创建主窗口
pub fn spawn_sidecar(app_handle: tauri::AppHandle) {
tauri::async_runtime::spawn(async move {
// 查找可用端口
let port = find_available_port(DEFAULT_PORT).await;
println!("使用端口: {}", port);
// 启动 sidecar
let sidecar = app_handle
.shell()
.sidecar("server")
.expect("无法找到 server")
.env("NITRO_PORT", port.to_string());
let (mut rx, child) = sidecar.spawn().expect("启动 sidecar 失败");
// 保存进程句柄到全局状态
if let Some(state) = app_handle.try_state::<SidecarProcess>() {
*state.0.lock().unwrap() = Some(child);
}
// 监听 stdout等待服务器就绪信号
let start_time = std::time::Instant::now();
let timeout = Duration::from_secs(STARTUP_TIMEOUT_SECS);
let mut server_ready = false;
while let Some(event) = rx.recv().await {
if let CommandEvent::Stdout(line) = event {
let output = String::from_utf8_lossy(&line);
println!("Server: {}", output);
// 检测服务器启动成功的标志
if output.contains("Listening on:") || output.contains("localhost") {
server_ready = true;
println!("✓ Server 启动成功!");
// 创建主窗口
let url = format!("http://localhost:{}", port);
tauri::WebviewWindowBuilder::new(
&app_handle,
"main",
tauri::WebviewUrl::External(url.parse().unwrap()),
)
.title(WINDOW_TITLE)
.inner_size(DEFAULT_WINDOW_WIDTH, DEFAULT_WINDOW_HEIGHT)
.center()
.build()
.expect("创建窗口失败");
break;
}
}
// 超时检查
if start_time.elapsed() > timeout {
eprintln!(
"✗ 启动超时: Server 未能在 {} 秒内启动",
STARTUP_TIMEOUT_SECS
);
break;
}
}
if !server_ready {
eprintln!("✗ Server 启动失败");
std::process::exit(1);
}
});
}
/// 清理 Sidecar 进程 (在应用退出时调用)
pub fn cleanup_sidecar_process(app_handle: &tauri::AppHandle) {
println!("应用退出,正在清理 Sidecar 进程...");
if let Some(state) = app_handle.try_state::<SidecarProcess>() {
if let Ok(mut process) = state.0.lock() {
if let Some(child) = process.take() {
let _ = child.kill();
println!("✓ Sidecar 进程已终止");
}
}
}
}