不同窗口和平台的能力

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

本指南内容

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

先决条件

此练习旨在阅读完使用插件权限后进行。

指南

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

   这里我们创建一个有两个窗口（标记为 first 和 second）的应用程序。在 Tauri 应用程序中创建窗口有多种方式。

   使用 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
         }
       ],
     },
     ...
   }

   通过编程方式创建窗口

   在 Rust 代码中创建 Tauri 应用程序

   显示解决方案

   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 窗口只需要对话框功能。

   按类别分隔功能文件

   建议根据其启用的操作类别分离功能文件。

   显示解决方案

   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 目录内容的功能。

   显示解决方案

   在功能文件中使用 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 窗口创建“是/否”对话框的功能。

   显示解决方案

   在功能文件中使用 windows 字段，其中包含一个或多个窗口标签。

   dialog.json

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

3. 使功能依赖于平台

   我们现在希望自定义功能，使其仅在特定平台上激活。我们将文件系统功能仅在 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 示例中找到。功能文件中可用的字段列在功能参考中。