Proceso

GitHubnpmcrates.io

Referencia de API

Este plugin proporciona APIs para acceder al proceso actual. Para generar procesos hijo, consulta el plugin shell.

Plataformas Soportadas

Este plugin requiere una versión de Rust de al menos 1.77.2

Plataforma	Nivel	Notas
windows
linux
macos
android
ios

Configuración

Instala el plugin-process para comenzar.

Automático

Usa el gestor de paquetes de tu proyecto para agregar la dependencia:

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

Manual

1. Ejecuta el siguiente comando en la carpeta src-tauri para agregar el plugin a las dependencias del proyecto en Cargo.toml:

   cargo add tauri-plugin-process

2. Modifica lib.rs para inicializar el plugin:

   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. Si quieres utilizar el plugin en JavaScript, instala también el paquete 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

Uso

El plugin process está disponible tanto en JavaScript como en 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

Ten en cuenta que app es una instancia de AppHandle.

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

// restarts the app
app.restart();

Permisos

De forma predeterminada, todos los comandos y alcances (scopes) potencialmente peligrosos del plugin están bloqueados y no se puede acceder a ellos. Debes modificar los permisos en tu configuración de capabilities para habilitarlos.

Consulta la Visión General de Capacidades para obtener más información y la guía paso a paso para usar permisos de plugins.

src-tauri/capabilities/default.json

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

Permiso Predeterminado

Este conjunto de permisos configura qué características del proceso se exponen por defecto.

Permisos Otorgados

Esto permite salir a través de allow-exit y reiniciar a través de allow-restart la aplicación.

Este conjunto de permisos predeterminado incluye lo siguiente:

• allow-exit
• allow-restart

Tabla de Permisos

Identificador	Descripción
process:allow-exit	Habilita el comando exit sin ningún scope preconfigurado.
process:deny-exit	Deniega el comando exit sin ningún scope preconfigurado.
process:allow-restart	Habilita el comando restart sin ningún scope preconfigurado.
process:deny-restart	Deniega el comando restart sin ningún scope preconfigurado.