Inicio automático

GitHub npm crates.io

API Reference

Inicia automáticamente tu aplicación al arrancar el sistema.

Plataformas compatibles

This plugin requires a Rust version of at least 1.77.2

Platform	Level	Notes
windows
linux
macos
android
ios

Configuración

Instala el plugin de autostart para comenzar.

Automático

Usa el gestor de paquetes de tu proyecto para añadir la dependencia:

npm

npm run tauri add autostart

yarn

yarn run tauri add autostart

pnpm

pnpm tauri add autostart

deno

deno task tauri add autostart

bun

bun tauri add autostart

cargo

cargo tauri add autostart

Manual

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

   cargo add tauri-plugin-autostart --target 'cfg(any(target_os = "macos", windows, target_os = "linux"))'

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()
           .setup(|app| {
               #[cfg(desktop)]
               app.handle().plugin(tauri_plugin_autostart::init(tauri_plugin_autostart::MacosLauncher::LaunchAgent, Some(vec!["--flag1", "--flag2"]) /* arbitrary number of args to pass to your app */));
               Ok(())
           })
           .run(tauri::generate_context!())
           .expect("error al ejecutar la aplicación tauri");
   }

3. Puedes instalar los enlaces de JavaScript Guest utilizando tu gestor de paquetes de JavaScript preferido:

   npm

   npm install @tauri-apps/plugin-autostart

   yarn

   yarn add @tauri-apps/plugin-autostart

   pnpm

   pnpm add @tauri-apps/plugin-autostart

   deno

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

   bun

   bun add @tauri-apps/plugin-autostart

Uso

El plugin de autostart está disponible tanto en JavaScript como en Rust.

JavaScript

import { enable, isEnabled, disable } from '@tauri-apps/plugin-autostart';
// si utilizas `"withGlobalTauri": true`, deberías usar
// const { enable, isEnabled, disable } = window.__TAURI__.autostart;

// Activar el arranque automático
await enable();
// Comprobar el estado de activación
console.log(`registered for autostart? ${await isEnabled()}`);
// Desactivar el arranque automático
disable();

Rust

#[cfg_attr(mobile, tauri::mobile_entry_point)]
pub fn run() {
    tauri::Builder::default()
        .setup(|app| {
            #[cfg(desktop)]
            {
                use tauri_plugin_autostart::MacosLauncher;
                use tauri_plugin_autostart::ManagerExt;

                app.handle().plugin(tauri_plugin_autostart::init(
                    MacosLauncher::LaunchAgent,
                    Some(vec!["--flag1", "--flag2"]),
                ));

                // Obtener el gestor de arranque automático
                let autostart_manager = app.autolaunch();
                // Activar el arranque automático
                let _ = autostart_manager.enable();
                // Comprobar el estado de activación
                println!("registered for autostart? {}", autostart_manager.is_enabled().unwrap());
                // Desactivar el arranque automático
                let _ = autostart_manager.disable();
            }
            Ok(())
        })
        .run(tauri::generate_context!())
        .expect("error al ejecutar la aplicación tauri");
}

Permisos

Por defecto, todos los comandos y ámbitos de plugin potencialmente peligrosos están bloqueados y no se pueden acceder. Debes modificar los permisos en tu configuración de capabilities para habilitar estos.

Consulta la Descripción general de capacidades para obtener más información y la guía paso a paso para utilizar los permisos de plugin.

src-tauri/capabilities/default.json

{
  "permissions": [
    ...,
    "autostart:allow-enable",
    "autostart:allow-disable",
    "autostart:allow-is-enabled"
  ]
}

Default Permission

This permission set configures if your application can enable or disable auto starting the application on boot.

Granted Permissions

It allows all to check, enable and disable the automatic start on boot.

This default permission set includes the following:

• allow-enable
• allow-disable
• allow-is-enabled

Permission Table

Identifier	Description
autostart:allow-disable	Enables the disable command without any pre-configured scope.
autostart:deny-disable	Denies the disable command without any pre-configured scope.
autostart:allow-enable	Enables the enable command without any pre-configured scope.
autostart:deny-enable	Denies the enable command without any pre-configured scope.
autostart:allow-is-enabled	Enables the is_enabled command without any pre-configured scope.
autostart:deny-is-enabled	Denies the is_enabled command without any pre-configured scope.