Process（現行プロセス）

《訳注》

Plugin 説明内容の英語表記部分について　Plugin の各章は、原文データからページ内容の一部が自動生成されているため、英語表記のままの部分があります。

API Reference

このプラグインは、現在のプロセスにアクセスするための API を提供します。子プロセスを生成するには、shellプラグインを参照してください。

対応プラットフォーム

This plugin requires a Rust version of at least 1.77.2

Platform	Level	Notes
windows
linux
macos
android
ios

セットアップ

はじめに、「process」プラグインをインストールしてください。

自動で設定
手動で設定

自分のプロジェクトのパッケージ・マネージャーを使用して依存関係を追加します：

npm run tauri add process

yarn run tauri add process

pnpm tauri add process

deno task tauri add process

bun tauri add process

cargo tauri add process

src-tauri フォルダで次のコマンドを実行して、このプラグインを Cargo.toml 内のプロジェクトの依存関係に追加します：
```
cargo add tauri-plugin-process
```

追加したプラグインを初期化するために 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");
}

JavaScript でこのプラグインを使用する場合は、npm パッケージもインストールしてください：

npm install @tauri-apps/plugin-process

yarn add @tauri-apps/plugin-process

pnpm add @tauri-apps/plugin-process

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

bun add @tauri-apps/plugin-process

使用法

「process」プラグインは、JavaScript と Rust の両方で利用できます。

JavaScript
Rust

import { exit, relaunch } from '@tauri-apps/plugin-process';
// `"withGlobalTauri": true` を使用する場合は、
// const { exit, relaunch } = window.__TAURI__.process; を使用できます

// 指定されたステータス・コードでアプリを終了
await exit(0);

// アプリを再起動
await relaunch();

app は AppHandle のインスタンスであることに注意してください。

// 指定されたステータス・コードでアプリを終了
app.exit(0);

// アプリを再起動
app.restart();

アクセス権限 Permissions

デフォルトでは、潜在的に危険なプラグイン・コマンドとそのスコープ（有効範囲）はすべてブロックされており、アクセスできません。これらを有効にするには、capabilities 設定でアクセス権限を変更する必要があります。

詳細については「セキュリティ・レベル Capabilities」の章を参照してください。また、プラグインのアクセス権限を設定するには「プライグン・アクセス権の使用」の章のステップ・バイ・ステップ・ガイドを参照してください。

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

Default Permission

This permission set configures which process features are by default exposed.

Granted Permissions

This enables to quit via allow-exit and restart via allow-restart the application.

This default permission set includes the following:

allow-exit
allow-restart

Permission Table

Identifier	Description
`process:allow-exit`	Enables the exit command without any pre-configured scope.
`process:deny-exit`	Denies the exit command without any pre-configured scope.
`process:allow-restart`	Enables the restart command without any pre-configured scope.
`process:deny-restart`	Denies the restart command without any pre-configured scope.

【※ この日本語版は、「Feb 22, 2025 英語版」に基づいています】

Support on Open Collective Sponsor on GitHub