118 lines
4.5 KiB
Markdown
118 lines
4.5 KiB
Markdown
|
||
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 获得后端的安全性和性能优势。 |