跳到内容
Tauri

项目结构

一个 Tauri 项目通常由两部分组成:一个 Rust 项目和一个 JavaScript 项目(可选),典型的设置如下:

.
├── package.json
├── index.html
├── src/
│ ├── main.js
├── src-tauri/
│ ├── Cargo.toml
│ ├── Cargo.lock
│ ├── build.rs
│ ├── tauri.conf.json
│ ├── src/
│ │ ├── main.rs
│ │ └── lib.rs
│ ├── icons/
│ │ ├── icon.png
│ │ ├── icon.icns
│ │ └── icon.ico
│ └── capabilities/
│ └── default.json

在这种情况下,JavaScript 项目位于顶层,而 Rust 项目位于 src-tauri/ 内部。Rust 项目是一个普通的 Cargo 项目,带有一些额外的文件。

  • tauri.conf.json 是 Tauri 的主配置文件,它包含从应用程序标识符到开发服务器 URL 的所有内容。此文件也是 Tauri CLI 用于查找 Rust 项目的标记。要了解更多信息,请参阅 Tauri 配置
  • capabilities/ 目录是 Tauri 读取 能力文件 的默认文件夹(简而言之,您需要在此处允许命令才能在 JavaScript 代码中使用它们)。要了解更多信息,请参阅 安全性
  • icons/ 目录是 tauri icon 命令的默认输出目录,通常在 tauri.conf.json > bundle > icon 中引用,并用于应用程序的图标。
  • build.rs 包含 tauri_build::build(),用于 Tauri 的构建系统。
  • src/lib.rs 包含 Rust 代码和移动端入口点(标记为 #[cfg_attr(mobile, tauri::mobile_entry_point)] 的函数),我们不直接在 main.rs 中编写代码的原因是,在移动端构建中,我们会将您的应用程序编译成一个库,并通过平台框架加载它们。
  • src/main.rs 是桌面应用程序的主要入口点,我们在 main 中运行 tauri_app_lib::run() 以使用与移动端相同的入口点,因此为简单起见,请勿修改此文件,请修改 lib.rs

Tauri 的工作方式类似于静态 Web 主机,其构建方式是您首先将 JavaScript 项目编译为静态文件,然后编译 Rust 项目,该项目将这些静态文件捆绑在一起,因此 JavaScript 项目的设置与您构建静态网站基本相同。要了解更多信息,请参阅 前端配置

如果您只想使用 Rust 代码,只需删除所有其他内容,并将 src-tauri/ 文件夹用作您的顶层项目或 Rust 工作区的一个成员。


© 2025 Tauri 贡献者。CC-BY / MIT