权限

命令的显式特权说明。

它可以使命令能够在应用程序的前端中被访问。

如果定义了作用域（scope），它可用于细粒度控制单个或多个命令的访问权限。

对象属性:

• commands
• description
• 标识符 (必需)
• platforms
• scope
• version

commands

命令

使用此权限时允许或拒绝的命令。

默认

{
  "allow": [],
  "deny": []
}

description

string | null

关于该权限作用的人类可读描述。Tauri 的内部约定是在 Markdown 内容中使用 <h4> 标题，以便于 Tauri 文档生成。

identifier

string

权限的唯一标识符。

platforms

Target[] | null

此权限适用的目标平台。默认情况下，该权限影响所有平台。

scope

范围

使用此权限时允许或拒绝的作用域。

version

integer | null 最小值为 1，格式为 uint64

权限的版本。

定义

命令

权限内部允许和拒绝的命令。

如果两个命令在 allow 和 deny 中冲突，则默认应为拒绝。

对象属性:

• allow
• deny

allow

string[]

允许的命令。

默认值：[]

deny

string[]

拒绝的命令，具有优先级。

默认值：[]

数字

以下任何一种:

• integer 格式为 int64，表示 [i64]。
• number 格式为 double，表示 [f64]。

一个有效的 ACL 数字。

范围

用于控制 Tauri 命令细粒度行为的参数。

它可以是任何可序列化的 Serde 类型，用于允许或阻止 Tauri 命令内部的某些操作。配置的作用域将传递给命令，并由命令实现强制执行。

示例

{
  "allow": [{ "path": "$HOME/**" }],
  "deny": [{ "path": "$HOME/secret.txt" }]
}

对象属性:

• allow
• deny

allow

Value[] | null

定义作用域允许哪些内容的数据。

deny

Value[] | null

定义作用域拒绝哪些内容的数据。验证逻辑应优先处理此项。

目标

以下其中之一:

• "macOS" macOS。
• "windows" Windows。
• "linux" Linux。
• "android" Android。
• "iOS" iOS。

平台目标。

值

以下任何一种:

• null 表示一个空 JSON 值。
• boolean 表示一个 [bool] 值。
• Number 表示一个有效的 ACL [Number] 值。
• string 表示一个 [String] 值。
• Value[] 表示其他 [Value] 值的列表。
• 表示从 [String] 键到 [Value] 值的映射。允许附加属性：Value

所有支持的 ACL 值。