Tauri框架:使用Rust构建轻量级桌面应用

[复制链接]
发表于 2026-2-5 18:57:02 | 显示全部楼层 |阅读模式

马上注册,结交更多好友,享用更多功能,让你轻松玩转社区。

您需要 登录 才可以下载或查看,没有账号?立即注册

×
Tauri是一款用Rust构建的开源框架,用于创建轻量级、安全且高效的桌面应用步调。它将Rust的强盛功能与Web技能(如HTML、CSS和JavaScript)相团结,提供了一种今世的、跨平台的方式来开辟桌面应用。Tauri的核生理念是“最小权限原则”,只在须要时调用操纵体系API,以低落攻击面。
Tauri架构

Tauri架构告急由以下几个部门构成:

1. Rust后端:使用Rust编写,负责与操纵体系交互、处理处罚体系事故、安全控制和API调用。
2. Web前端:使用Web技能(HTML、CSS和JavaScript)创建用户界面,可以基于任何前端框架(如React、Vue或Svelte)。
3. Tauri API:Rust后端提供的一组API,用于与前端举行通讯,实现前后端的数据互换和功能调用。
4. 包装器:一个轻量级的嵌入式Webview,用于展示前端界面并与Rust后端交互。
创建一个简朴的Tauri应用

起首,确保你已经安装了Rust和Cargo。然后,使用tauri init下令创建一个新的Tauri项目:
  1. cargo tauri init my-app
复制代码
这会天生一个根本的项目布局,包罗src-tauri(Rust后端)和src(Web前端)目次。
Rust后端(src-tauri/main.rs)
  1. use tauri::{Manager, SubCommand};
  2. fn main() {
  3.   tauri::Builder::default()
  4.     .run(tauri::generate_context!())
  5.     .expect("error while running tauri app");
  6. }
复制代码
这是Tauri应用的主入口点。generate_context!宏会自动天生所需的API和事故处理处罚器。
Web前端(src/index.html 和 src/index.ts)

index.html是你的应用界面,可以使用任何你喜欢的HTML布局。index.ts是TypeScript文件,用于处理处罚Tauri API调用和事故监听。
  1. <!-- src/index.html -->
  2. <!DOCTYPE html>
  3. <html lang="en">
  4. <head>
  5.   <meta charset="UTF-8">
  6.   <title>My Tauri App</title>
  7. </head>
  8. <body>
  9.   <h1>Hello, Tauri!</h1>
  10.   <button id="click-me">Click me!</button>
  11.   <script src="index.js"></script>
  12. </body>
  13. </html>
复制代码
  1. // src/index.ts
  2. import { invoke } from '@tauri-apps/api';
  3. document.getElementById('click-me')?.addEventListener('click', async () => {
  4.   const result = await invoke('sayHello');
  5.   alert(`Tauri says: ${result}`);
  6. });
复制代码
在这个例子中,invoke函数用于调用Rust后端的sayHello方法。接下来,我们须要在Rust后端实现这个方法。
Rust后端实现API(src-tauri/src/main.rs)

  1. // 引入必要的库
  2. use tauri::{Command, Manager, Window};
  3. // 定义say_hello命令
  4. #[tauri::command]
  5. fn say_hello() -> String {
  6.   "Hello, frontend!".to_string()
  7. }
  8. fn main() {
  9.   // ...其他代码
  10.   // 注册say_hello命令
  11.   let manager = Manager::build_app(tauri::generate_context!())
  12.     .sub_command(Command::new("sayHello").exec(say_hello))
  13.     .run();
  14.   // ...其他代码
  15. }
复制代码
如今,当你点击按钮时,前端会调用Rust后端的sayHello方法,并体现返回的消息。
编译和运行

使用cargo tauri build编译项目,然后运行target/release/my-app(或在Windows上运行.exe文件)。
Tauri的高级功能和最佳实践

1. 自界说API和事故

Tauri允许你自界说API和事故,以便在Rust后端和Web前端之间举行更复杂的通讯。比方,创建一个用于打开文件选择对话框的API:
  1. // src-tauri/src/main.rs
  2. use tauri::{Manager, Response, Window};
  3. #[tauri::command]
  4. async fn open_file() -> Result<String, String> {
  5.   let file_path = tauri::api::dialog::open_file().await?;
  6.   Ok(file_path.display().to_string())
  7. }
复制代码
在Web前端调用:
  1. // src/index.ts
  2. import { invoke } from '@tauri-apps/api';
  3. document.getElementById('open-file')?.addEventListener('click', async () => {
  4.   const filePath = await invoke('openFile');
  5.   console.log(`Selected file: ${filePath}`);
  6. });
复制代码
2. 使用前端框架

Tauri与React、Vue、Svelte等前端框架无缝集成。比方,使用React创建一个组件:
  1. // src/App.js (React)
  2. import React, { useState } from 'react';
  3. import { invoke } from '@tauri-apps/api';
  4. const App = () => {
  5.   const [filePath, setFilePath] = useState('');
  6.   const handleOpenFile = async () => {
  7.     const result = await invoke('openFile');
  8.     setFilePath(result);
  9.   };
  10.   return (
  11.     <div>
  12.       <button onClick={handleOpenFile}>Open File</button>
  13.       <p>{filePath}</p>
  14.     </div>
  15.   );
  16. };
  17. export default App;
复制代码
3. 资源管理

Tauri提供了内置的资源管理功能,可以将静态资源打包到应用中。在tauri.conf.json中设置:
  1. {
  2.   "build": {
  3.     "resourcesPath": "./resources"
  4.   }
  5. }
复制代码
然后在Rust后端使用tauri::api::fs::read读取资源:
  1. // src-tauri/src/main.rs
  2. use tauri::{Manager, Response, Window};
  3. #[tauri::command]
  4. fn read_resource() -> Result<String, String> {
  5.   let content = tauri::api::fs::read("resources/myfile.txt")?;
  6.   Ok(String::from_utf8_lossy(content.as_ref()).to_string())
  7. }
复制代码
4. 应用更新

Tauri支持自动更新功能,你可以使用tauri-update库来实现。设置tauri.conf.json:
  1. {
  2.   "update": {
  3.     "enabled": true,
  4.     "interval": "1d",
  5.     "url": "https://myapp.com/releases"
  6.   }
  7. }
复制代码
然后在Rust后端处理处罚更新事故:
  1. // src-tauri/src/main.rs
  2. use tauri::{Manager, Update};
  3. fn main() {
  4.   let manager = Manager::build_app(tauri::generate_context!())
  5.     .update(Update::new())
  6.     .run();
  7.   // ...其他代码
  8. }
复制代码
5. 体系集成

Tauri提供了丰富的体系集成API,如托盘图标、菜单、快捷键等。比方,创建一个托盘图标:
  1. // src-tauri/src/main.rs
  2. use tauri::{Manager, Window};
  3. fn main() {
  4.   let mut manager = Manager::build_app(tauri::generate_context!());
  5.   manager.set_tray_icon("path/to/icon.png");
  6.   manager.run();
  7.   // ...其他代码
  8. }
复制代码
6. 安全性和沙箱

Tauri遵照最小权限原则,只在须要时调用体系API。你可以设置安全计谋,限定应用的权限,比方禁用文件体系访问:
  1. // tauri.conf.json
  2. {
  3.   "security": {
  4.     "allow": {
  5.       "fs": false
  6.     }
  7.   }
  8. }
复制代码
Tauri的插件体系与扩展本领

插件体系

Tauri的插件体系允许开辟者扩展其焦点功能,通过编写Rust库来提供额外的服务或集成外部库。插件可以或许以安全、高效的方式与Tauri应用交互,为应用增加更多大概性。
创建自界说插件


  • 界说插件接口:起首,在Rust中界说你的插件接口。这通常涉及创建一个trait,界说你想要公开给前端的功能。
  1.    // my_plugin.rs
  2.    use tauri::plugin::{Builder, TauriPlugin};
  3.    use tauri::Runtime;
  4.    #[tauri::command]
  5.    async fn custom_function<R: Runtime>(app: tauri::AppHandle<R>, arg: String) -> Result<String, String> {
  6.        // 实现你的功能逻辑
  7.        Ok(format!("Custom function received: {}", arg))
  8.    }
  9.    pub fn init<R: Runtime>() -> TauriPlugin<R> {
  10.        Builder::new("myPlugin")
  11.            .invoke_handler(tauri::generate_handler![custom_function])
  12.            .build()
  13.    }
复制代码

  • 在Tauri应用中使用插件:在src-tauri/src/main.rs中,通过Builder的.plugin()方法注册你的插件。
  1.    // src-tauri/src/main.rs
  2.    fn main() {
  3.        tauri::Builder::default()
  4.            .plugin(my_plugin::init())
  5.            .run(tauri::generate_context!())
  6.            .expect("error while running tauri application");
  7.    }
复制代码

  • 前端调用插件方法:在前端代码中,通过@tauri-apps/api提供的invoke函数调用你的插件方法。
  1.    // src/index.ts
  2.    import { invoke } from '@tauri-apps/api';
  3.    async function callCustomFunction() {
  4.        const result = await invoke('myPlugin:customFunction', { arg: 'Hello from frontend!' });
  5.        console.log(result);
  6.    }
复制代码
使用社区插件

Tauri社区生动,已经有许多现成的插件可以使用,比方数据库集成、图形渲染、网络哀求等。这些插件通常托管在GitHub或Crates.io上,可以通过阅读文档相识怎样集成到你的项目中。
扩展与集成



  • 数据库集成:可以使用Rust的数据库驱动(如Diesel、sqlx)编写插件,为应用提供数据库访问本领。
  • 图形与多媒体:使用Rust的多媒体库(如image、rodio)开辟图像处理处罚、音频播放等功能。
  • 硬件访问:通过Rust的低级别库访问硬件资源,如串口通讯、GPIO控制等,实用于物联网物联网(IoT)应用。
安全考量

固然Tauri的计划原则夸大安全性,但在开辟插件时仍需注意安全实践:


  • 最小权限原则:确保插件仅哀求完成任务所必须的最低权限。
  • 代码审计:对第三方插件举行代码查察,确保没有引入安全毛病。
  • 沙箱情况:使用Tauri的安全计谋,限定插件对体系资源的访问。
Tauri的调试与测试

调试

Tauri提供了一些工具和方法来资助开辟者调试应用:
  1.    {
  2.      "logger": {
  3.        "level": "debug"
  4.      }
  5.    }
复制代码

  • 开辟者工具:在运行应用时,可以使用–dev标志启用开辟者模式,这将开启Webview的开辟者工具(F12)。
  1.    cargo tauri dev --dev
复制代码

  • Rust调试:使用Rust的cargo下令行工具举行源代码级别的调试,比方cargo rustc – --break和cargo run – --dev。
  • 前端调试:在开辟者模式下,可以使用Webview的开辟者工具来调试前端代码,包罗JavaScript、CSS和HTML。
测试

Tauri提供了单元测试和集成测试的支持:

  • Rust单元测试:对于Rust后端,可以编写尺度的Rust单元测试。在src-tauri目次下创建tests子目次,然后在那里编写测试文件。
  • 集成测试:Tauri提供了一个名为tauri-testing的库,用于编写集成测试。这些测试可以直接在模仿的Tauri情况中运行,无需实际构建和运行整个应用。
  1.    // 在Cargo.toml中添加依赖
  2.    [dependencies]
  3.    tauri-testing = { version = "latest", features = ["mock"] }
  4.    // 在测试文件中
  5.    use tauri_testing::{mock, Command};
  6.    #[test]
  7.    fn test_say_hello() {
  8.        let app = mock::init().unwrap();
  9.        let result = app.invoke("sayHello").unwrap();
  10.        assert_eq!(result, "Hello, world!");
  11.    }
复制代码

  • 前端测试:对于前端代码,可以使用任何你喜欢的JavaScript测试框架(如Jest、Mocha)举行测试。
性能优化


  • 资源压缩:在tauri.conf.json中设置build选项,启用资源压缩和归并,以减小应用巨细。
  1.    {
  2.      "build": {
  3.        "distDir": "../dist",
  4.        "bundle": true,
  5.        "minify": true,
  6.        "target": "web",
  7.        "resolveSymlinks": false
  8.      }
  9.    }
复制代码

  • 缓存计谋:使用Tauri的cache设置来缓存资源,镌汰网络哀求。
  • 异步加载:使用动态导入和懒加载计谋,仅在须要时加载前端代码。
  • 性能监控监控:使用Chrome DevTools或其他性能分析工具监测应用性能,找出瓶颈并优化。
2024年礼包:2500G盘算机入门到高级架构师开辟资料超等大礼包免费送!
回复

使用道具 举报

登录后关闭弹窗

登录参与点评抽奖  加入IT实名职场社区
去登录
快速回复 返回顶部 返回列表