不同窗口和平台的授权配置
本指南将帮助你自定义 Tauri 应用程序的授权配置(Capability)。
本指南的内容
Section titled “本指南的内容”- Tauri 应用中创建多个窗口
- 对不同的窗口使用不同的授权配置
- 使用平台特定的授权配置
完成 使用插件权限 后再阅读此练习。
-
在 Tauri 应用程序中创建多个窗口
Section titled “在 Tauri 应用程序中创建多个窗口”这里我们创建一个有两个窗口的应用程序,并分别标记为
first和second。 在 Tauri 应用程序中,有很多种方法可以创建窗口。使用 Tauri 配置文件创建窗口
Section titled “使用 Tauri 配置文件创建窗口”在 Tauri 配置文件中,通常名为
tauri.conf.json:"productName": "multiwindow",..."app": {"windows": [{"label": "first","title": "First","width": 800,"height": 600},{"label": "second","title": "Second","width": 800,"height": 600}],},...}以编程的方式创建窗口
Section titled “以编程的方式创建窗口”在 Rust 代码中创建 Tauri 应用程序:
tauri::Builder::default().invoke_handler(tauri::generate_handler![greet]).setup(|app| {let webview_url = tauri::WebviewUrl::App("index.html".into());// 第一个窗口tauri::WebviewWindowBuilder::new(app, "first", webview_url.clone()).title("First").build()?;// 第二个窗口tauri::WebviewWindowBuilder::new(app, "second", webview_url).title("Second").build()?;Ok(())}).run(context).expect("error while running tauri application"); -
为不同窗口应用不同的授权配置
Section titled “为不同窗口应用不同的授权配置”Tauri 应用的窗口可以使用 Tauri 后端的不同功能或插件。为了提高安全性,建议只为每个窗口提供必要的授权配置。 我们模拟了一个场景,其中
first窗口使用文件系统和对话框功能,second只使用对话框功能。按操作类别拆分授权配置文件
Section titled “按操作类别拆分授权配置文件”建议根据授权配置文件所支持的操作类别来分离授权配置文件。
src-tauri/capabilities中的 JSON 文件将被纳入授权配置系统。 在这里,我们将与文件系统和对话框窗口相关的授权配置分别存储到filesystem.json和dialog.json中。Tauri 项目的文件树:
/src/src-tauri/capabilitiesfilesystem.jsondialog.jsontauri.conf.jsonpackage.jsonREADME.md为
Section titled “为 first 窗口配置文件系统访问权限”first窗口配置文件系统访问权限我们赋予
first窗口读取$HOME目录内容的权限。在授权配置文件中使用具有一个或多个窗口标签的
windows字段。filesystem.json {"identifier": "fs-read-home","description": "Allow access file access to home directory","local": true,"windows": ["first"],"permissions": ["fs:allow-home-read",]}为
Section titled “为 first 和 second 窗口配置对话框权限”first和second窗口配置对话框权限我们为
first和second窗口提供创建“是/否”的对话框的权限。在授权配置文件中使用具有一个或多个窗口标签的
windows字段。dialog.json {"identifier": "dialog","description": "Allow to open a dialog","local": true,"windows": ["first", "second"],"permissions": ["dialog:allow-ask"]} -
让授权配置仅在指定平台生效
Section titled “让授权配置仅在指定平台生效”我们现在想自定义授权配置,使其仅在某些平台上有效。我们使我们的文件系统授权配置仅在
linux和windows上有效。在授权配置文件中使用
platforms字段使其特定于平台。filesystem.json {"identifier": "fs-read-home","description": "Allow access file access to home directory","local": true,"windows": ["first"],"permissions": ["fs:allow-home-read",],"platforms": ["linux", "windows"]}目前可用的平台有
linux、windows、macos、android和ios。
我们学习了如何在 Tauri 应用中创建多个窗口并为它们应用特定的授权配置。此外,这些授权配置还可以针对特定平台进行定制。
在 Tauri Github 仓库 的
api 示例
中可以找到一个使用窗口授权配置的示例程序。
授权配置文件中可以使用的字段在 授权配置 参考中列出。
© 2026 Tauri Contributors. CC-BY / MIT