4.5 KiB
Tauri 是一个用于构建跨平台桌面应用的框架,主打超小体积、极致性能,结合了 Rust 后端与前端 Web 技术(HTML/JS/CSS),可适配 macOS、Windows、Linux 等主流桌面平台,还支持移动端(Android/iOS)扩展。
核心特性
-
轻量高效:基于系统原生 WebView(如 macOS 的 WKWebView、Windows 的 WebView2、Linux 的 WebKitGTK),无需打包独立运行时,最终二进制文件体积极小;后端由 Rust 编译为原生二进制,性能优异且逆向难度高。
-
跨平台能力:支持自定义菜单、系统托盘、原生通知、应用自动更新;提供内置打包工具,可生成
.app/.dmg(macOS)、.exe/.msi(Windows)、.deb/.rpm(Linux)等格式安装包。 -
安全设计:采用原生 WebView 协议(无需本地 HTTP 服务器),支持细粒度的权限控制(allowlist)、CSP 注入等安全特性。
-
灵活扩展:兼容任意编译为 HTML/JS/CSS 的前端框架(Vue/React/Svelte 等),Rust 后端可通过 IPC 与前端通信,支持插件系统扩展功能。
核心架构
Tauri 架构分为核心层(Rust) 和工具层(JS/TS) 两大模块,核心组件依赖关系如下:
1. Tauri Core(Rust 核心)
| 组件 | 作用 |
|---|---|
tauri |
核心整合层:聚合运行时、宏、工具类、API,读取 tauri.conf.json 配置并初始化应用 |
tauri-utils |
通用工具库:解析配置、处理资产(Assets)、注入 CSP、检测平台等 |
tauri-codegen |
代码生成:编译期嵌入/压缩/哈希资产、解析 tauri.conf.json 生成配置结构体 |
tauri-macros |
Rust 宏:提供 #[command]/generate_handler! 等简化 IPC 开发的宏 |
tauri-build |
构建工具:辅助 Cargo 构建过程,关联 codegen 能力 |
tauri-runtime |
运行时抽象层:定义窗口/事件等核心接口 |
tauri-runtime-wry |
基于 WRY 的运行时实现(默认启用):封装系统 WebView 交互 |
tauri-cli |
Rust 原生 CLI:提供应用构建、开发、打包等核心命令 |
2. Tauri Tooling(JS/TS 工具)
| 组件 | 作用 |
|---|---|
@tauri-apps/api |
前端 API 库:提供 TypeScript/JS 接口,封装 WebView 与 Rust 后端的 IPC 通信 |
@tauri-apps/cli |
Node.js 封装层:基于 napi-rs 包装 tauri-cli,提供 pnpm tauri dev 等命令 |
create-tauri-app |
项目脚手架:快速初始化基于不同前端框架的 Tauri 项目 |
核心依赖关系(关键链路)
tauri(核心)
├── tauri-macros(宏)
│ └── tauri-codegen(代码生成)
│ └── tauri-utils(工具)
├── tauri-runtime-wry(WRY 运行时)
│ └── tauri-runtime(运行时抽象)
│ └── tauri-utils
├── tauri-build(构建)
│ └── tauri-codegen
└── tauri-utils
快速上手
1. 初始化项目
# 使用脚手架创建项目
npm create tauri-app@latest
# 或
yarn create tauri-app
# 或
pnpm create tauri-app
2. 开发/构建命令
# 开发模式(热更新)
pnpm tauri dev
# 生产构建
pnpm tauri build
# 查看所有 CLI 命令
pnpm tauri --help
关键配置
核心配置文件为 tauri.conf.json,可配置:
-
应用元信息(名称、版本、图标);
-
安全策略(allowlist 控制 API 权限、CSP 规则);
-
窗口配置(大小、标题栏、是否启用开发者工具);
-
构建选项(资产目录、目标平台);
-
系统托盘、更新策略等高级特性。
扩展能力
-
插件系统:通过
tauri-plugin扩展功能(如文件系统、网络、数据库); -
移动端支持:基于 WRY/TAO 扩展 Android/iOS 平台适配;
-
CI/CD 集成:提供 GitHub Action 简化自动化构建/测试;
-
VS Code 扩展:提供语法提示、配置校验等开发辅助。
相关资源
-
官方文档:https://tauri.app
-
架构详情:https://github.com/tauri-apps/tauri/blob/dev/ARCHITECTURE.md
-
社区 Discord:https://discord.gg/SpmNs4S
Tauri 适合追求轻量、高性能、原生体验的桌面应用开发,尤其适合前端开发者复用现有技术栈,同时借助 Rust 获得后端的安全性和性能优势。