权限

命令的显式特权描述。

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

如果定义了作用域，则可以使用它来细粒度控制对单个或多个命令的访问。

对象属性:

• 命令
• 描述
• identifier (必需)
• 平台
• 作用域
• 版本

命令

命令

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

默认

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

描述

string | null

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

标识符

string

权限的唯一标识符。

平台

Target[] | null

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

作用域

作用域

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

版本

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

权限的版本。

定义

命令

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

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

对象属性:

• 允许
• 拒绝

允许

string[]

允许的命令。

默认值: []

拒绝

string[]

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

默认值: []

数字

以下任一项:

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

有效的 ACL 数字。

作用域

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

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

示例

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

对象属性:

• 允许
• 拒绝

允许

Value[] | null

定义作用域允许的数据。

拒绝

Value[] | null

定义作用域拒绝的数据。验证逻辑应优先考虑此项。

目标

以下之一:

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

平台目标。

值

以下任一项:

• null 表示 null JSON 值。
• boolean 表示 [bool]。
• Number 表示有效的 ACL [Number]。
• string 表示 [String]。
• Value[] 表示其他 [Value] 的列表。
• 表示 [String] 键到 [Value] 的映射。允许其他属性: Value

所有支持的 ACL 值。