项目结构
一个 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