tauri 备忘清单 & tauri cheatsheet & 开发手册

快速开始

Bash

sh <(curl https://create.tauri.app/sh)

PowerShell

C:\> irm https://create.tauri.app/ps | iex

Cargo

$ cargo install create-tauri-app --locked
$ cargo create-tauri-app

npm/yarn/pnpm/bunx

$ npm create tauri-app@latest
$ yarn create tauri-app
$ pnpm create tauri-app
$ bunx create-tauri-app

依赖环境

软件	描述
rust	rust安装
nodejs	nodejs安装
Windows Build Tools	Microsoft C++ 生成工具 (for windows)
Android Studio	安卓开发工具

更新 npm 包

$ npm install @tauri-apps/cli@latest @tauri-apps/api@latest
$ yarn upgrade @tauri-apps/cli @tauri-apps/api --latest
$ yarn up @tauri-apps/cli @tauri-apps/api
$ pnpm update @tauri-apps/cli @tauri-apps/api --latest
$ bun update @tauri-apps/cli @tauri-apps/api

更新 Cargo 包

打开 src-tauri/Cargo.toml 并更改 tauri 和 tauri-build

[build-dependencies]
tauri-build = "%version%"

[dependencies]
tauri = { version = "%version%" }

其中 %version% 是上面相应的版本号

$ cd src-tauri
$ cargo update

应用程序调试

代码中输出日志方法

println!("Message from Rust: {}", msg);

在 Linux 和 macOS 上通过下面命令重新运行

RUST_BACKTRACE=1 tauri dev

Window 上这样开启

set RUST_BACKTRACE=1 
tauri dev

以编程方式打开 Devtools

use tauri::Manager;
tauri::Builder::default()
  .setup(|app| {
    #[cfg(debug_assertions)] // 仅在调试构建时包含此代码
    {
      let window = app.get_window("main").unwrap();
      window.open_devtools();
      window.close_devtools();
    }
    Ok(())
  });

在生产中使用检查器

$ npm run tauri build -- --debug
$ yarn tauri build --debug
$ pnpm tauri build --debug
$ bunx tauri build --debug
$ cargo tauri build --debug

启用开发工具功能

[dependencies]
tauri = { version = "...", features = ["...", "devtools"] }

在文件 src-tauri/Cargo.toml 中启用 devtools Cargo 功能

准备目标

$ npm install @tauri-apps/cli@next @tauri-apps/api@next
$ npm run tauri migrate
$ rustup target add aarch64-linux-android armv7-linux-androideabi i686-linux-android x86_64-linux-android
$ rm -r src-tauri/gen
$ npm run tauri android init
$ npm run tauri icon

修改应用名：%app_path%\src-tauri\gen\android\app\src\main\res\values\strings.xml

签名

$ keytool -genkey -alias android.keystore -keyalg RSA -validity 20000 -keystore android.keystore
$ zipalign -p -f -v 4 unsigned.apk release.apk
$ apksigner sign --ks android.keystore release.apk

配置结构

默认配置 tauri.conf.json，还支持 tauri.conf.json5 和 Tauri.toml

--	--
`package`	包设置
`tauri`	Tauri 配置
`build`	构建配置
`plugins`	插件配置

下面配置能与主配置进行合并

tauri.linux.conf.json 或 Tauri.linux.conf.toml
tauri.windows.conf.json 或 Tauri.windows.conf.toml
tauri.macos.conf.json 或 Tauri.macos.conf.toml

示例

{
  "build": { ... },
  "package": { ... },
  "tauri": { ... }
}

Tauri 配置

配置	Type	描述
`pattern`	PatternKind	应用程序名称
`version`	WindowConfig[]	应用程序版本
`cli`	CliConfig	CLI 配置
`bundle`	BundleConfig	打包器配置
`allowlist`	AllowlistConfig	允许列表配置
`security`	SecurityConfig	安全配置
`updater`	UpdaterConfig	更新程序配置
`systemTray`	SystemTrayConfig	配置应用系统托盘
`macOSPrivateApi`	boolean	macOS 私有API配置

CliConfig

配置	Type	描述
`description`	string?	将显示在帮助信息中
`longDescription`	string?	将显示在帮助信息中
`beforeHelp`	string?	该信息显示在自动生成的帮助信息之前。这通常用于标题信息
`afterHelp`	string?	显示在自动生成的帮助信息之后。通常用于描述如何使用参数，或者需要注意的注意事项
`args`	array?	命令的参数列表
`subcommands`	object?	该命令的子命令列表

描述 CLI 配置

Package 配置

配置	描述
`productName`	应用程序名称
`version`	应用程序版本

WindowConfig

窗口配置对象

配置	Type	默认值	描述
`label`	string	null	窗口标识符
`url`	WindowUrl	view	窗口的 webview URL
`userAgent`	userAgent?	null	webview 的用户代理
`fileDropEnabled`	boolean	true	是否在 Web 视图上启用文件放置
`center`	boolean	false	窗口是否开始居中
`x`	number?	null	窗口左上角的水平位置
`y`	number?	null	窗口左上角的水平位置
`width`	number	800	窗口宽度
`height`	number	600	窗口高度
`minWidth`	number	null	最小窗口宽度
`minHeight`	number	null	最小窗口高度

PatternKind

应用模式。可以是以下类型中的任意一种：

棕地模式

{ "use": "brownfield" }

隔离模式。建议出于安全目的

{ 
  "use": "isolation",
  "options": { "dir": string }
}

SystemTrayConfig

配置	Type	默认值	描述
`iconPath`	string(必填)	null	系统托盘上使用的默认图标的路径
`iconAsTemplate`	boolean	false	用于确定图像是否代表 macOS 上的模板图像
`menuOnLeftClick`	boolean	true	确定在 macOS 上托盘图标收到左键点击时菜单是否应该出现
`title`	string?	null	MacOS 托盘标题

应用程序系统托盘图标的配置

tauri 备忘清单

入门