这个 tauri 快速参考备忘单显示了它的常用命令使用清单
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 run tauri dev
$ yarn tauri dev
$ pnpm tauri dev
$ bunx tauri dev
$ cargo tauri dev
$ npm outdated @tauri-apps/cli
$ yarn outdated @tauri-apps/cli
$ pnpm add -D @tauri-apps/cli
$ npm outdated @tauri-apps/cli
$ 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
打开 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
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
功能
JAVA_HOME
ANDROID_HOME
NDK_HOME
$ 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
$ npm run tauri android dev
$ npm run tauri android build
$ 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": { ... }
}
配置 | Type | 描述 |
---|---|---|
pattern | PatternKind | 应用程序名称 |
version | WindowConfig[] | 应用程序版本 |
cli | CliConfig | CLI 配置 |
bundle | BundleConfig | 打包器配置 |
allowlist | AllowlistConfig | 允许列表配置 |
security | SecurityConfig | 安全配置 |
updater | UpdaterConfig | 更新程序配置 |
systemTray | SystemTrayConfig | 配置应用系统托盘 |
macOSPrivateApi | boolean | macOS 私有API配置 |
配置 | Type | 描述 |
---|---|---|
description | string? | 将显示在帮助信息中 |
longDescription | string? | 将显示在帮助信息中 |
beforeHelp | string? | 该信息显示在自动生成的帮助信息之前。这通常用于标题信息 |
afterHelp | string? | 显示在自动生成的帮助信息之后。通常用于描述如何使用参数,或者需要注意的注意事项 |
args | array? | 命令的参数列表 |
subcommands | object? | 该命令的子命令列表 |
描述 CLI 配置
配置 | 描述 |
---|---|
productName | 应用程序名称 |
version | 应用程序版本 |
窗口配置对象
配置 | 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 | 最小窗口高度 |
应用模式。可以是以下类型中的任意一种:
{ "use": "brownfield" }
{
"use": "isolation",
"options": { "dir": string }
}
要在 Tauri Web 视图窗口中打开的 URL。可以是以下任何一种类型:
string
(format: uri
):外部 URL。string
:应用程序 URL 的路径部分。例如,要加载 tauri://localhost/users/john
,只需在此配置中提供 users/john
配置 | Type | 默认值 | 描述 |
---|---|---|---|
iconPath | string(必填) | null | 系统托盘上使用的默认图标的路径 |
iconAsTemplate | boolean | false | 用于确定图像是否代表 macOS 上的模板图像 |
menuOnLeftClick | boolean | true | 确定在 macOS 上托盘图标收到左键点击时菜单是否应该出现 |
title | string? | null | MacOS 托盘标题 |
应用程序系统托盘图标的配置