Información del SO

GitHubnpmcrates.io

Referencia de API

Lee información sobre el sistema operativo utilizando el plugin OS Information.

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 OS Information para comenzar.

Automático

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

npm

npm run tauri add os

yarn

yarn run tauri add os

pnpm

pnpm tauri add os

deno

deno task tauri add os

bun

bun tauri add os

cargo

cargo tauri add os

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-os

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_os::init())
           .run(tauri::generate_context!())
           .expect("error while running tauri application");
   }

3. Si quieres usarlo en JavaScript, instala también el paquete npm:

   npm

   npm install @tauri-apps/plugin-os

   yarn

   yarn add @tauri-apps/plugin-os

   pnpm

   pnpm add @tauri-apps/plugin-os

   deno

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

   bun

   bun add @tauri-apps/plugin-os

Uso

Con este plugin puedes consultar múltiple información del sistema operativo actual. Consulta todas las funciones disponibles en las referencias de la API de JavaScript o la API de Rust.

Ejemplo: Plataforma del SO

platform devuelve una cadena que describe el sistema operativo específico en uso. El valor se establece en tiempo de compilación. Los valores posibles son linux, macos, ios, freebsd, dragonfly, netbsd, openbsd, solaris, android, windows.

JavaScript

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

const currentPlatform = platform();
console.log(currentPlatform);
// Prints "windows" to the console

Rust

let platform = tauri_plugin_os::platform();
println!("Platform: {}", platform);
// Prints "windows" to the terminal

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": [
    ...,
    "os:default"
  ]
}

Permiso Predeterminado

Este conjunto de permisos configura qué información del sistema operativo está disponible para recopilar desde el frontend.

Permisos Otorgados

Toda la información excepto el nombre de host está disponible.

Este conjunto de permisos predeterminado incluye lo siguiente:

• allow-arch
• allow-exe-extension
• allow-family
• allow-locale
• allow-os-type
• allow-platform
• allow-version

Tabla de Permisos

Identificador	Descripción
os:allow-arch	Habilita el comando arch sin ningún scope preconfigurado.
os:deny-arch	Deniega el comando arch sin ningún scope preconfigurado.
os:allow-exe-extension	Habilita el comando exe_extension sin ningún scope preconfigurado.
os:deny-exe-extension	Deniega el comando exe_extension sin ningún scope preconfigurado.
os:allow-family	Habilita el comando family sin ningún scope preconfigurado.
os:deny-family	Deniega el comando family sin ningún scope preconfigurado.
os:allow-hostname	Habilita el comando hostname sin ningún scope preconfigurado.
os:deny-hostname	Deniega el comando hostname sin ningún scope preconfigurado.
os:allow-locale	Habilita el comando locale sin ningún scope preconfigurado.
os:deny-locale	Deniega el comando locale sin ningún scope preconfigurado.
os:allow-os-type	Habilita el comando os_type sin ningún scope preconfigurado.
os:deny-os-type	Deniega el comando os_type sin ningún scope preconfigurado.
os:allow-platform	Habilita el comando platform sin ningún scope preconfigurado.
os:deny-platform	Deniega el comando platform sin ningún scope preconfigurado.
os:allow-version	Habilita el comando version sin ningún scope preconfigurado.
os:deny-version	Deniega el comando version sin ningún scope preconfigurado.