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

118 lines
4.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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 项目|
## 核心依赖关系(关键链路)
```Plain
tauri(核心)
├── tauri-macros(宏)
│ └── tauri-codegen(代码生成)
│ └── tauri-utils(工具)
├── tauri-runtime-wry(WRY 运行时)
│ └── tauri-runtime(运行时抽象)
│ └── tauri-utils
├── tauri-build(构建)
│ └── tauri-codegen
└── tauri-utils
```
## 快速上手
### 1. 初始化项目
```Bash
# 使用脚手架创建项目
npm create tauri-app@latest
# 或
yarn create tauri-app
# 或
pnpm create tauri-app
```
### 2. 开发/构建命令
```Bash
# 开发模式(热更新)
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://github.com/tauri-apps/tauri](https://github.com/tauri-apps/tauri)
- 官方文档:[https://tauri.app](https://tauri.app)
- 架构详情:[https://github.com/tauri-apps/tauri/blob/dev/ARCHITECTURE.md](https://github.com/tauri-apps/tauri/blob/dev/ARCHITECTURE.md)
- 社区 Discord:[https://discord.gg/SpmNs4S](https://discord.gg/SpmNs4S)
Tauri 适合追求轻量、高性能、原生体验的桌面应用开发,尤其适合前端开发者复用现有技术栈,同时借助 Rust 获得后端的安全性和性能优势。