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

12,207 阅读2分钟

本教程以 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-create-app

项目结构

[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

003-tauri-run.png

构建应用

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

yarn tauri build

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

003-tauri-build-error

003-tauri-build-app.png

了解更多不同平台打包注意事项:Tauri Building

检查信息

检查 Tauri 信息以确保一切设置正确,在对问题进行分类时,此信息可能很有用。

yarn tauri info

tauri-check-info


仓库地址:lencx/OhMyBox
首发于 GitHub Discussions
关注《浮之静》公众号,私信作者,进 Tauri 技术交流群