进程

GitHub npm crates.io

API 参考

此插件提供了访问当前进程的 API。要生成子进程，请参阅 shell 插件。

支持的平台

此插件需要 Rust 版本至少为 **1.77.2**

平台	级别	备注
Windows
Linux
macOS
Android
iOS

设置

安装进程插件即可开始使用。

自动

使用你的项目包管理器添加依赖项

npm

npm run tauri add process

yarn

yarn run tauri add process

pnpm

pnpm tauri add process

deno

deno task tauri add process

bun

bun tauri add process

cargo

cargo tauri add process

手动

1. 在 src-tauri 文件夹中运行以下命令，将插件添加到项目的 Cargo.toml 依赖项中

   cargo add tauri-plugin-process

2. 修改 lib.rs 以初始化插件

   src-tauri/src/lib.rs

   #[cfg_attr(mobile, tauri::mobile_entry_point)]
   pub fn run() {
       tauri::Builder::default()
           .plugin(tauri_plugin_process::init())
           .run(tauri::generate_context!())
           .expect("error while running tauri application");
   }

3. 如果你想在 JavaScript 中使用该插件，则还需要安装 npm 包

   npm

   npm install @tauri-apps/plugin-process

   yarn

   yarn add @tauri-apps/plugin-process

   pnpm

   pnpm add @tauri-apps/plugin-process

   deno

   deno add npm:@tauri-apps/plugin-process

   bun

   bun add @tauri-apps/plugin-process

用法

进程插件在 JavaScript 和 Rust 中均可用。

JavaScript

import { exit, relaunch } from '@tauri-apps/plugin-process';
// when using `"withGlobalTauri": true`, you may use
// const { exit, relaunch } = window.__TAURI__.process;

// exits the app with the given status code
await exit(0);

// restarts the app
await relaunch();

Rust

请注意，app 是 AppHandle 的一个实例。

// exits the app with the given status code
app.exit(0);

// restarts the app
app.restart();

权限

默认情况下，所有潜在危险的插件命令和范围都被阻止，无法访问。您必须修改 capabilities 配置中的权限才能启用这些功能。

有关更多信息，请参阅功能概述，并参阅分步指南以使用插件权限。

src-tauri/capabilities/default.json

{
  "permissions": [
    ...,
    "process:default",
  ]
}

默认权限

此权限集配置了默认公开的进程功能。

已授予权限

这允许通过 allow-exit 退出应用程序，并通过 allow-restart 重启应用程序。

此默认权限集包括以下内容

• 允许退出
• 允许重启

权限表

标识符	描述
process:allow-exit	启用不带任何预配置范围的退出命令。
process:deny-exit	禁用不带任何预配置范围的退出命令。
process:allow-restart	启用不带任何预配置范围的重启命令。
process:deny-restart	禁用不带任何预配置范围的重启命令。