程序

GitHub npm crates.io

API 參考

此外掛程式提供 API 以存取目前的程序。若要產生子程序，請參閱 shell 外掛程式。

支援的平台

此外掛程式需要至少 1.77.2 的 Rust 版本

平台	層級	備註
windows
linux
macos
android
ios

設定

安裝 plugin-process 以開始使用。

自動

使用您專案的套件管理器來新增依賴項

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 重新啟動應用程式。

• allow-exit
• allow-restart

權限表

識別碼	描述
process:allow-exit	啟用 exit 命令，而無需任何預先設定的作用域。
process:deny-exit	拒絕 exit 命令，而無需任何預先設定的作用域。
process:allow-restart	啟用 restart 命令，而無需任何預先設定的作用域。
process:deny-restart	拒絕 restart 命令，而無需任何預先設定的作用域。