适用于不同 Windows 和平台的功能

本指南将帮助你自定义 Tauri 应用的功能。

🌐 This guide will help you customize the capabilities of your Tauri app.

本指南的内容

🌐 Content of this guide

• 在 Tauri 应用中创建多个窗口
• 对不同的窗口使用不同的功能
• 使用平台特定功能

先决条件

🌐 Prerequisites

此练习应在完成 Using Plugin Permissions 后阅读。

🌐 This exercise is meant to be read after completing Using Plugin Permissions.

指南

🌐 Guide

1. 在 Tauri 应用中创建多个窗口

   在这里，我们创建了一个带有两个窗口的应用，分别标记为 first 和 second。在你的 Tauri 应用中，有多种方法可以创建窗口。

   使用 Tauri 配置文件创建窗口

   在 Tauri 配置文件中，通常命名为 tauri.conf.json：

   Show solution

     "productName": "multiwindow",
     ...
     "app": {
       "windows": [
         {
           "label": "first",
           "title": "First",
           "width": 800,
           "height": 600
         },
         {
           "label": "second",
           "title": "Second",
           "width": 800,
           "height": 600
         }
       ],
     },
     ...
   }

   编程创建 Windows

   在用于创建 Tauri 应用的 Rust 代码中：

   Show solution

   tauri::Builder::default()
       .invoke_handler(tauri::generate_handler![greet])
       .setup(|app| {
           let webview_url = tauri::WebviewUrl::App("index.html".into());
           // First window
           tauri::WebviewWindowBuilder::new(app, "first", webview_url.clone())
               .title("First")
               .build()?;
           // Second window
           tauri::WebviewWindowBuilder::new(app, "second", webview_url)
               .title("Second")
               .build()?;
           Ok(())
       })
       .run(context)
       .expect("error while running tauri application");

2. 将不同的功能应用于不同的窗口

   Tauri 应用的窗口可以使用 Tauri 后端的不同功能或插件。 为了更好的安全性，建议只为每个窗口提供必要的功能。 我们模拟一个场景，其中 first 窗口使用文件系统和对话框功能，而 second 只需要对话框功能。

   每个类别的独立功能文件

   建议根据它们所支持的操作类别来分开能力文件。

   Show solution

   src-tauri/capabilities 中的 JSON 文件将被纳入能力系统的考虑范围。这里我们将与文件系统和对话窗口相关的能力分别分到 filesystem.json 和 dialog.json。

   Tauri 项目的文件树:

   /src
   /src-tauri
     /capabilities
       filesystem.json
       dialog.json
     tauri.conf.json
   package.json
   README.md

   为 first 窗口提供文件系统功能

   我们赋予 first 窗口对 $HOME 目录内容的读取访问权限。

   Show solution

   在功能文件中使用 windows 字段，可搭配一个或多个窗口标签。

   filesystem.json

   {
     "identifier": "fs-read-home",
     "description": "Allow access file access to home directory",
     "local": true,
     "windows": ["first"],
     "permissions": [
       "fs:allow-home-read",
     ]
   }

   为 first 和 second 窗口提供对话功能

   我们为 first 和 second 窗口提供创建“是/否”对话框的功能

   Show solution

   在功能文件中使用 windows 字段，可搭配一个或多个窗口标签。

   dialog.json

   {
     "identifier": "dialog",
     "description": "Allow to open a dialog",
     "local": true,
     "windows": ["first", "second"],
     "permissions": ["dialog:allow-ask"]
   }

3. 使能力依赖于平台

   我们现在希望将功能定制为仅在某些平台上生效。我们让我们的文件系统功能仅在 linux 和 windows 上生效。

   Show solution

   在能力文件中使用 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。

结论和资源

🌐 Conclusion and Resources

我们已经学习了如何在 Tauri 应用中创建多个窗口并赋予它们特定的功能。此外，这些功能也可以针对某些平台进行设置。

🌐 We have learned how to create multiple windows in a Tauri app and give them specific capabilities. Furthermore these capabilities can also be targeted to certain platforms.

一个使用窗口功能的示例应用可以在 Tauri Github 仓库 的 api 示例 中找到。可以在功能文件中使用的字段列在 Capability 参考中。

🌐 An example application that used window capabilities can be found in the api example of the Tauri Github repository. The fields that can be used in a capability file are listed in the Capability reference.