Tauri 创建 Rust 项目

2023-10-09 14:11 更新

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

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

安装 TAURI CLI
如果你还没有安装Tauri CLI,你可以使用下面的一个命令进行安装。 不确定该用哪个? 请参阅常见问题。
  • npm
npm install --save-dev @tauri-apps/cli

要使npm能够正确检测到Tauri,你需要将它添加到你的package.json文件的"scripts"部分中:

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
npm run tauri init
  • Yarn
yarn tauri init
  • pnpm
pnpm tauri init
  • Cargo
cargo tauri init

它会向您询问几个问题:

  1. 您应用的名字是什么?- 这将会是您打包后和操作系统会调用的应用名称。 您可以在此处填写任何您想要的名称。
  2. 窗口标题叫什么?- 这将会是您主窗口的默认标题。 您可以在此处填写任何您想要的名称。
  3. 前端页面资源 (HTML/CSS/JS) 相对于 <current dir>/src-tauri/tauri.conf.json 文件将被创建的位置?- 这是 production环境时tauri加载web前端资源的目录.对于本指南中的项目示例,是../build。请注意,如果你使用不同的框架,它可能会有所不同,比如​../dist​。
  4. 开发环境时的加载路径?- 可以是一个网络地址也可以是一个文件路径 对于本指南中的项目示例,这是​http://localhost:3000​。请注意,如果你使用不同的框架,它可能会有所不同(甚至可能是一个目录)。
  5. 你将使用什么命令来开发前端页面?- 这是启动前端开发服务器的命令。对于本指南中的项目示例,这是npm run start(确保根据你选择的包管理器进行调整)。
  6. 你将使用什么命令来构建前端页面?- 这是构建前端文件的命令。
信息
若您已熟悉 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 的 图标功能指南 中了解有关多种图标格式的信息。

这就是全部了,你现在已经将Tauri添加到你的现有项目中,你应该会看到一个类似这样的src-tauri目录:

│── package.json
│── public
│ ╰── index.html
│── src
│ │── App.css
│ │── App.jsx
│ │── index.css
│ ╰── index.js
╰── src-tauri
│── Cargo.toml
│── build.rs
│── icons
│── src
╰── tauri.conf.json


以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号