Tauri 创建 Rust 项目

2023-09-21 11:05 更新

每款 Tauri 应用的核心都是由一个管理窗口的 Rust 二进制文件、WebView 和进行系统调用的 tauri Rust 包构成。此项目使用官方的软件包管理器及 Rust 通用构建工具 Cargo 来管理。

我们的 Tauri CLI 工具会在底层自动调用 Cargo，所以您大部分情况下无需和其交互。 Cargo 有诸多我们的 CLI 工具所未提供的有用功能，包括测试、分析及格式化工具。请参阅其官方文档来了解更多。

安装 TAURI CLI
如果你还没有安装Tauri CLI，你可以使用下面的一个命令进行安装。不确定该用哪个？请参阅常见问题。

npm
npm install --save-dev @tauri-apps/cli
For npm to detect Tauri correctly you need to add it to the "scripts" section in your package.json file:package.json
"scripts": {
  "tauri": "tauri"
}
Yarn
yarn add -D @tauri-apps/cli
pnpm
pnpm add -D @tauri-apps/cli
Cargo
cargo install tauri-cli

要搭建一个使用 Tauri 的简单 Rust 项目，请打开终端并运行如下命令：

npm run tauri init

Yarn

yarn tauri init

pnpm

pnpm add -D @tauri-apps/cli

Cargo

cargo tauri init

它会向您询问几个问题：

您应用的名字是什么？- 这将会是您打包后和操作系统会调用的应用名称。您可以在此处填写任何您想要的名称。
窗口标题叫什么？- 这将会是您主窗口的默认标题。您可以在此处填写任何您想要的名称。
前端页面资源 (HTML/CSS/JS) 相对于 <current dir>/src-tauri/tauri.conf.json 文件将被创建的位置？- 这是 production 环境时tauri加载web前端资源的目录。Use ../out for this value.
开发环境时的加载路径? - 可以是一个网络地址也可以是一个文件路径 development 。Use http://localhost:3000 for this value.
你将使用什么命令来开发前端页面？- 这是启动前端开发服务器的命令。Use npm run dev for this value (make sure to adapt this to use the package manager of your choice).
你将使用什么命令来构建前端页面？- 这是构建前端文件的命令。

信息
若您已熟悉 Rust，您会发现 tauri init 看起来很像 cargo init 命令。若您想自己设置，您完全可以使用 cargo init 替代此命令，并手动添加 Tauri 依赖。

tauri init 命令将生成 src-tauri 文件夹。传统上，Tauri 应用会将其核心相关的文件放置于此文件夹中。让我们快速过一下此文件夹中的内容：

Cargo.toml - Cargo 的清单文件。您可以声明您应用所依赖的 Rust 包和应用的元数据等等。要查看所有可修改的值，请参阅 Cargo 清单格式。
tauri.conf.json - 此文件可让您自定义 Tauri 应用的各方各面，包括应用名称到允许的 API 列表。请参阅 Tauri 的 API 配置来深入了解每个支持的选项。
src/main.rs - 这是你的 Rust 程序的入口，也是我们启动 Tauri 的地方。您可以发现它由两个部分组成：

src/main.rs

 #![cfg_attr(not(debug_assertions), windows_subsystem = "windows")]

fn main() {
tauri::Builder::default()
   .run(tauri::generate_context!())
   .expect("error while running tauri application");
}

The line beginning with the cfg! 宏 所开始的一行仅有一个目的：关闭构建好的应用在 Windows 上运行时一般会出现的控制台窗口。若您是 Windows 用户，您可以试试去掉这行看看会发生什么。

main 函数是您程序的入口点，也是运行时调用的第一个函数。

图标 - 您可能想为自己的应用整一个漂亮的图标！为了帮助您快速开发，我们为您提供了一套默认图标。您应该在发布前把这些图标换成您自己的图标。您可以在 Tauri 的图标功能指南中了解有关多种图标格式的信息。

现在我们的前端已经构建完成，Rust 项目也已初始化完毕。您马上就可以运行您的应用了！您的 tauri.conf.json 文件看起来像这样：

src-tauri/tauri.conf.json

{
  "build": {
    "beforeBuildCommand": "npm run build",
    "beforeDevCommand": "npm run dev",
    "devPath": "http://localhost:3000",
    "distDir": "../out"
  },

就是这样！现在您可以在您的终端中运行接下来的命令来开始您的应用程序的开发构建：

npm run tauri dev

Yarn

yarn tauri dev

pnpm

pnpm tauri dev

Cargo

cargo tauri dev

以上内容是否对您有帮助：