【03】Tauri 入门篇 - 创建项目

#tauri #rust #web #desktop

仓库：lencx/OhMyBox
如果文章对你有所帮助，可以 star 此项目，或转发给更多有需要的人。大家的支持也会给我更大的写作动力，感恩。

本教程以 macOS 为例，其他平台类似，想了解更多请查看官方文档

初始化

# 使用 yarn
yarn create tauri-app

# 或使用 npx
npx create-tauri-app

此项目以 vite + react-ts 为例（使用 vite 是为了配合 vite-plugin-rsw 插件，可以无缝集成 webAssembly）。如需在老项目中添加 tauri 支持，请参考文档 Add Tauri to Existing Project

项目结构

[tauri-app] # 项目名称
├─ [node_modules] # 前端依赖
├─ [src] # 前端程序源
├─ [src-tauri] # Tauri 程序源
│    ├─ [icons] # 应用程序图标
│    ├─ [src] # Tauri App 程序源，例如系统菜单，托盘，插件配置等
│    ├─ [target] # 构建的产物会被放入此文件夹中，target 目录的结构取决于是否使用 --target 标志为特定的平台构建
│    ├─ build.rs # Tauri 构建应用
│    ├─ Cargo.lock # 包含了依赖的精确描述信息，类似于 yarn.lock 或 package-lock.json
│    ├─ Cargo.toml # Tauri (Rust) 项目清单
│    └─ tauri.conf.json # 自定义 Tauri 应用程序的配置文件，例如应用程序窗口尺寸，应用名称，权限等
├─ index.html # 项目主界面
├─ package.json # 前端项目清单
├─ tsconfig.json # typescript 配置文件
├─ vite.config.ts # vite 配置文件
├─ yarn.lock # 前端依赖的精确描述信息
└─ ... # 其他

启动项目

有两种启动方式：

1. 启动 web 项目

纯前端项目，不和操作系统产生任何交互

yarn dev

2. 启动 tauri 项目

需要和操作系统产生交互，如系统文件读写操作

第一次启动项目时，tauri 会根据src-tauri/Cargo.toml 去下载相关依赖（导致第一次启动比较慢），第二次启动会快很多。

yarn tauri dev

构建应用

Tauri Bundler 是一个 Rust 工具，用于编译二进制文件、打包资产并准备最终捆绑包。它会检测你当前的操作系统并相应地构建一个包。目前支持：

Windows: .msi
macOS: .app, .dmg
Linux: .deb, .appimage

yarn tauri build

如果未修改 src-tauri/tauri.conf.json 中的 identifier 直接 build 会报以下错误。想要正确构建，只需修改为自己特有的标识符即可，如 com.myapp.dev。构建完成后，在 src-tauri/target/release/bundle/{platform}/{app} 下就可以找到应用程序安装包。