编写插件权限

本练习的目的是更好地理解在编写自己的插件时如何创建插件权限。

最后，您将能够为您的插件创建简单的权限。您将拥有一个示例 Tauri 插件，其中权限部分是自动生成和手动创建的。

1. 创建 Tauri 插件

   在我们的示例中，我们将利用 Tauri cli 来引导 Tauri 插件源代码结构。确保您已安装所有先决条件，并通过运行cargo tauri info验证 Tauri CLI 版本是否正确。

   输出应表明tauri-cli版本为2.x。我们将在此逐步说明中使用pnpm，但您可以选择其他包管理器并相应地替换命令。

   安装最新版本后，您可以使用 Tauri CLI 创建插件。

   显示解决方案

   mkdir -p tauri-learning
   cd tauri-learning
   cargo tauri plugin new test
   cd tauri-plugin-test
   pnpm install
   pnpm build
   cargo build

2. 创建新命令

   为了展示一些实用且简单的东西，我们假设我们的命令将用户输入写入临时文件夹中的文件，同时向文件添加一些自定义文件头。

   我们将命令命名为write_custom_file，在src/commands.rs中实现它，并将其添加到插件构建器中以暴露给前端。

   Tauri 的核心工具将为该命令自动生成允许和拒绝权限，因此我们无需关心这些。

   显示解决方案

   命令实现

   src/commands.rs

   use tauri::{AppHandle, command, Runtime};
   
   use crate::models::*;
   use crate::Result;
   use crate::TestExt;
   
   #[command]
   pub(crate) async fn ping<R: Runtime>(
       app: AppHandle<R>,
       payload: PingRequest,
   ) -> Result<PingResponse> {
       app.test1().ping(payload)
   }
   
   #[command]
   pub(crate) async fn write_custom_file<R: Runtime>(
       user_input: String,
       app: AppHandle<R>,
   ) -> Result<String> {
       std::fs::write(app.path().temp_dir().unwrap(), user_input)?;
       Ok("success".to_string())
   }

   为您的新命令自动生成内置权限

   src/build.rs

   const COMMANDS: &[&str] = &["ping", "write_custom_file"];

   这些内置权限将由 Tauri 构建系统自动生成，并将在permissions/autogenerated/commands文件夹中可见。默认情况下，将创建enable-<command>和deny-<command>权限。

3. 暴露新命令

   上一步是编写实际的命令实现。接下来，我们希望将其暴露给前端，以便前端可以消费它。

   显示解决方案

   配置 Tauri 构建器以生成调用处理程序，将前端 IPC 请求传递给新实现的命令

   src/lib.rs

   pub fn init<R: Runtime>() -> TauriPlugin<R> {
   Builder::new("test")
       .invoke_handler(tauri::generate_handler![
           commands::ping,
           commands::write_custom_file,
       ])
       .setup(|app, api| {
           #[cfg(mobile)]
           let test = mobile::init(app, api)?;
           #[cfg(desktop)]
           let test = desktop::init(app, api)?;
           app.manage(test);
   
           // manage state so it is accessible by the commands
           app.manage(MyState::default());
           Ok(())
       })
       .build()
   }

   在前端模块中暴露新命令。

   此步骤对于示例应用程序成功导入前端模块至关重要。这只是为了方便，不影响安全性，因为命令处理程序已经生成，并且可以从前端手动调用该命令。

   guest-js/index.ts

   import { invoke } from '@tauri-apps/api/core'
   
   export async function ping(value: string): Promise<string | null> {
     return await invoke<{value?: string}>('plugin:test|ping', {
       payload: {
         value,
       },
     }).then((r) => (r.value ? r.value : null));
   }
   
   export async function writeCustomFile(user_input: string): Promise<string> {
    return await invoke('plugin:test|write_custom_file',{userInput: user_input});
   }

   提示

   调用参数需要是驼峰式命名。在此示例中，它是userInput而不是user_input。

   确保您的包已构建

   pnpm build

4. 定义默认插件权限

   由于我们的插件应默认暴露write_custom_file命令，因此我们应该将其添加到我们的default.toml权限中。

   显示解决方案

   将其添加到我们的默认权限集中，以允许我们刚刚暴露的新命令。

   permissions/default.toml

   "$schema" = "schemas/schema.json"
   [default]
   description = "Default permissions for the plugin"
   permissions = ["allow-ping", "allow-write-custom-file"]

5. 从示例应用程序调用测试命令

   创建的插件目录结构包含一个examples/tauri-app文件夹，其中有一个可用于测试插件的 Tauri 应用程序。

   由于我们添加了一个新命令，我们需要稍微修改前端以调用我们的新命令。

   显示解决方案

   src/App.svelte

   <script>
     import Greet from './lib/Greet.svelte'
     import { ping, writeCustomFile } from 'tauri-plugin-test-api'
   
     let response = ''
   
     function updateResponse(returnValue) {
       response += `[${new Date().toLocaleTimeString()}]` + (typeof returnValue === 'string' ? returnValue : JSON.stringify(returnValue)) + '<br>'
     }
   
     function _ping() {
       ping("Pong!").then(updateResponse).catch(updateResponse)
     }
     function _writeCustomFile() {
       writeCustomFile("HELLO FROM TAURI PLUGIN").then(updateResponse).catch(updateResponse)
     }
   </script>
   
   <main class="container">
     <h1>Welcome to Tauri!</h1>
   
     <div class="row">
       <a href="https://vite.ac.cn" target="_blank">
         <img src="/vite.svg" class="logo vite" alt="Vite Logo" />
       </a>
       <a href="https://tauri.org.cn" target="_blank">
         <img src="/tauri.svg" class="logo tauri" alt="Tauri Logo" />
       </a>
       <a href="https://svelte.net.cn" target="_blank">
         <img src="/svelte.svg" class="logo svelte" alt="Svelte Logo" />
       </a>
     </div>
   
     <p>
       Click on the Tauri, Vite, and Svelte logos to learn more.
     </p>
   
     <div class="row">
       <Greet />
     </div>
   
     <div>
       <button on:click="{_ping}">Ping</button>
       <div>{@html response}</div>
     </div>
     <div>
       <button on:click="{_writeCustomFile}">Write</button>
       <div>{@html response}</div>
     </div>
   
   
   </main>
   
   <style>
     .logo.vite:hover {
       filter: drop-shadow(0 0 2em #747bff);
     }
   
     .logo.svelte:hover {
       filter: drop-shadow(0 0 2em #ff3e00);
     }
   </style>

   运行此程序并按下“写入”按钮后，您应该会看到以下内容

   success

   并且您应该在临时文件夹中找到一个test.txt文件，其中包含我们新实现的插件命令的消息。🥳