SuperAPI AI 工具集

configuring-tauri-apps

编程与开发

查看项目

更新于 10-16 08:27

技能介绍

用途

本技能用于指导开发者配置 Tauri v2 应用。Tauri v2 应用通过三个主要配置文件管理应用行为、依赖与构建流程:tauri.conf.json(Tauri 专属设置)、Cargo.toml(Rust 依赖与元数据)、package.json(前端依赖与脚本)。技能围绕这些文件的结构、字段含义与常见用法展开。

主要能力

tauri.conf.json

位于 src-tauri/ 目录,是主配置文件,定义应用元数据、窗口行为、打包选项与插件设置。支持三种格式:JSON(默认 tauri.conf.json)、JSON5(tauri.conf.json5,需 config-json5 Cargo 特性)、TOML(Tauri.toml,需 config-toml Cargo 特性)。

根级字段包括 productName(应用显示名)、version(语义化版本或 package.json 路径)、identifier(反向域名标识,必填)、mainBinaryName(覆盖主二进制文件名)。

build 配置字段包括 devUrl(热重载开发服务器 URL)、frontendDist(构建后前端资源路径或远程 URL)、beforeDevCommand、beforeBuildCommand、features(构建时启用的 Cargo 特性)、removeUnusedCommands(从二进制中剥离未使用的插件命令)。

窗口配置选项包括 title、width/height、minWidth/minHeight、maxWidth/maxHeight、x/y、resizable、fullscreen、center、visible、decorations、transparent、alwaysOnTop、url 等,并给出各自默认值。

安全配置包括 capabilities(权限能力)、assetProtocol.enable 与 assetProtocol.scope(自定义资源协议及允许路径)、pattern.use(安全模式,默认 brownfield)、freezePrototype(阻止原型修改)。

bundle 配置涵盖 active、targets、icon、resources、copyright、category、shortDescription、longDescription、licenseFile,以及 Windows(nsis、msi)、macOS(app、dmg)、Linux(appimage、deb、rpm)、Android(apk、aab)、iOS(app)等平台专属设置。

平台专属配置

可创建平台专属文件,通过 JSON Merge Patch(RFC 7396)覆盖基础配置:tauri.linux.conf.json、tauri.windows.conf.json、tauri.macos.conf.json、tauri.android.conf.json、tauri.ios.conf.json。技能给出 Windows 与 macOS 的示例。

CLI 配置覆盖

支持通过 --config 参数指定自定义配置或内联覆盖,例如 tauri dev --config src-tauri/tauri.dev.conf.json、tauri build --config src-tauri/tauri.beta.conf.json,以及内联 JSON 覆盖。

Cargo.toml

位于 src-tauri/Cargo.toml,管理 Rust 依赖。技能列出 package、build-dependencies、dependencies、features 的示例,并说明常见 Tauri 特性:config-json5、config-toml、devtools、macos-private-api、tray-icon、image-png、image-ico、protocol-asset。版本管理支持语义化兼容("2.0")、精确版本("=2.0.0")、仅补丁更新("~2.0.0")。

package.json 集成

示例展示 name、version、scripts(dev、build、tauri)、dependencies(@tauri-apps/api)、devDependencies(@tauri-apps/cli)。

环境专属配置

技能提供开发(tauri.dev.conf.json)、生产(tauri.prod.conf.json)、Beta(tauri.beta.conf.json)三种环境配置示例,分别覆盖 devUrl、withGlobalTauri、窗口标题、frontendDist、removeUnusedCommands、bundle、identifier、productName、updater 端点等。

TOML 格式

使用 Tauri.toml 时配置采用 kebab-case,技能给出 build、app、app.windows、app.security、app.security.asset-protocol、bundle、plugins.updater 的 TOML 示例。

常见配置模式

包括多窗口应用(多个窗口定义,含 label、title、尺寸、url、visible)、系统托盘应用(trayIcon 与隐藏窗口)、插件配置(updater、shell、deep-link)。

锁文件与校验

建议提交锁文件以保证可复现构建:Cargo.lock、package-lock.json、yarn.lock、pnpm-lock.yaml。使用 JSON schema(https://schema.tauri.app/config/2)获得编辑器自动补全,运行 tauri info 验证配置与环境。

使用方式

开发者按需查阅对应配置文件的结构与字段,参考示例编写或调整 tauri.conf.json、Cargo.toml、package.json;通过平台专属文件或 --config 参数实现环境与平台覆盖;借助 JSON schema 与 tauri info 校验配置。

适用场景

适用于 Tauri v2 桌面应用的初始化配置、多窗口与托盘应用搭建、跨平台打包设置、多环境(开发/生产/Beta)配置管理、插件集成与依赖特性管理。

限制

资料未提供具体收费、价格、平台支持范围或效果保证等信息。部分字段的完整取值与行为细节需以官方文档为准。