Files
Obsidian/MyArticles/Tauri 框架详解.md
T
coco 8b94d76799 a
2026-07-21 13:57:15 +08:00

4.5 KiB
Raw Blame History

Tauri 是一个用于构建跨平台桌面应用的框架,主打超小体积、极致性能,结合了 Rust 后端与前端 Web 技术(HTML/JS/CSS),可适配 macOS、Windows、Linux 等主流桌面平台,还支持移动端(Android/iOS)扩展。

核心特性

  1. 轻量高效:基于系统原生 WebView(如 macOS 的 WKWebView、Windows 的 WebView2、Linux 的 WebKitGTK),无需打包独立运行时,最终二进制文件体积极小;后端由 Rust 编译为原生二进制,性能优异且逆向难度高。

  2. 跨平台能力:支持自定义菜单、系统托盘、原生通知、应用自动更新;提供内置打包工具,可生成 .app/.dmg(macOS)、.exe/.msi(Windows)、.deb/.rpm(Linux)等格式安装包。

  3. 安全设计:采用原生 WebView 协议(无需本地 HTTP 服务器),支持细粒度的权限控制(allowlist)、CSP 注入等安全特性。

  4. 灵活扩展:兼容任意编译为 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 扩展:提供语法提示、配置校验等开发辅助。

相关资源

Tauri 适合追求轻量、高性能、原生体验的桌面应用开发,尤其适合前端开发者复用现有技术栈,同时借助 Rust 获得后端的安全性和性能优势。