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:
8
src-tauri/src/commands/mod.rs
Normal file
8
src-tauri/src/commands/mod.rs
Normal 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
35
src-tauri/src/lib.rs
Normal 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
6
src-tauri/src/main.rs
Normal 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
131
src-tauri/src/sidecar.rs
Normal 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 进程已终止");
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user