Capacidades para diferentes ventanas y plataformas

Esta guía te ayudará a personalizar las capacidades de tu aplicación Tauri.

Contenido de esta guía

• Crear múltiples ventanas en una aplicación Tauri
• Usar diferentes capacidades para diferentes ventanas
• Usar capacidades específicas para cada plataforma

Requisitos previos

Este ejercicio está pensado para ser leído después de completar Uso de permisos de plugins.

Guía

1. Crear múltiples ventanas en una aplicación Tauri

   Aquí creamos una app con dos ventanas etiquetadas como first y second. Existen varias formas de crear ventanas en tu aplicación Tauri.

   Crear ventanas con el archivo de configuración de Tauri

   En el archivo de configuración de Tauri, habitualmente llamado tauri.conf.json:

   Mostrar solución

     "productName": "multiwindow",
     ...
     "app": {
       "windows": [
         {
           "label": "first",
           "title": "First",
           "width": 800,
           "height": 600
         },
         {
           "label": "second",
           "title": "Second",
           "width": 800,
           "height": 600
         }
       ],
     },
     ...
   }

   Crear ventanas mediante programación

   En el código de Rust para crear una aplicación Tauri:

   Mostrar solución

   tauri::Builder::default()
       .invoke_handler(tauri::generate_handler![greet])
       .setup(|app| {
           let webview_url = tauri::WebviewUrl::App("index.html".into());
           // First window
           tauri::WebviewWindowBuilder::new(app, "first", webview_url.clone())
               .title("First")
               .build()?;
           // Second window
           tauri::WebviewWindowBuilder::new(app, "second", webview_url)
               .title("Second")
               .build()?;
           Ok(())
       })
       .run(context)
       .expect("error while running tauri application");

2. Aplicar diferentes capacidades a diferentes ventanas

   Las ventanas de una app Tauri pueden usar diferentes características o plugins del backend de Tauri. Para una mayor seguridad, se recomienda otorgar solo las capacidades necesarias a cada ventana. Simulamos un escenario donde la first ventana utiliza funcionalidades del sistema de archivos y de diálogos, y la second solo necesita funcionalidades de diálogos.

   Archivos de capacidad separados por categoría

   Se recomienda separar los archivos de capacidad por categoría de acciones que habilitan.

   Mostrar solución

   Los archivos JSON en src-tauri/capabilities se tendrán en cuenta para el sistema de capacidades. Aquí separamos las capacidades relacionadas con el sistema de archivos y la ventana de diálogos en filesystem.json y dialog.json.

   árbol de archivos del proyecto Tauri:

   /src
   /src-tauri
     /capabilities
       filesystem.json
       dialog.json
     tauri.conf.json
   package.json
   README.md

   Otorgar capacidades del sistema de archivos a la ventana first

   Le otorgamos a la ventana first la capacidad de tener acceso de lectura al contenido del directorio $HOME.

   Mostrar solución

   Usa el campo windows en un archivo de capacidad con una o varias etiquetas de ventana.

   filesystem.json

   {
     "identifier": "fs-read-home",
     "description": "Allow access file access to home directory",
     "local": true,
     "windows": ["first"],
     "permissions": [
       "fs:allow-home-read",
     ]
   }

   Otorgar capacidades de diálogo a las ventanas first y second

   Otorgamos a las ventanas first y second la capacidad de crear un diálogo “Sí/No”

   Mostrar solución

   Usa el campo windows en un archivo de capacidad con una o varias etiquetas de ventana.

   dialog.json

   {
     "identifier": "dialog",
     "description": "Allow to open a dialog",
     "local": true,
     "windows": ["first", "second"],
     "permissions": ["dialog:allow-ask"]
   }

3. Hacer que las capacidades dependan de la plataforma

   Ahora queremos personalizar las capacidades para que estén activas únicamente en ciertas plataformas. Hacemos que nuestras capacidades del sistema de archivos solo estén activas en linux y windows.

   Mostrar solución

   Usa el campo platforms en un archivo de capacidad para hacerlo específico de una plataforma.

   filesystem.json

   {
     "identifier": "fs-read-home",
     "description": "Allow access file access to home directory",
     "local": true,
     "windows": ["first"],
     "permissions": [
       "fs:allow-home-read",
     ],
     "platforms": ["linux", "windows"]
   }

   Las plataformas actualmente disponibles son linux, windows, macos, android y ios.

Conclusión y recursos

Hemos aprendido cómo crear múltiples ventanas en una aplicación Tauri y asignarles capacidades específicas. Además, estas capacidades también se pueden orientar a ciertas plataformas.

Un ejemplo de aplicación que utiliza capacidades de ventana se puede encontrar en el ejemplo de api del repositorio de GitHub de Tauri. Los campos que se pueden usar en un archivo de capacidad se enumeran en la referencia de Capability.