Sistema de archivos y almacenamiento de datos en Electron

En Electron, dado que está basado en Node.js, puedes acceder directamente al sistema de archivos, a las bases de datos y al almacenamiento local.

Esto permite que las aplicaciones de escritorio lean y escriban archivos, guarden configuraciones e incluso implementen una gestión de datos compleja, como el software tradicional.


Operaciones del sistema de archivos

Electron te permite usar los módulos integrados de Node.js en el proceso de renderizado o en el proceso principalfsmódulos para realizar operaciones de archivos.

Uso del módulo fs de Node.js

fsEl módulo proporciona varias operaciones del sistema de archivos, como lectura, escritura, renombrado, eliminación, etc.

Ejemplo

const fs = require('fs');
const path = require('path');

// Obtener la ruta actual de la aplicación
const filePath = path.join(__dirname, 'data.txt');

// Leer archivo de forma asíncrona
fs.readFile(filePath, 'utf8', (err, data) => {
  if (err) throw err;
  console.log('Contenido del archivo:', data);
});

// Escribir archivo (sobrescribir)
fs.writeFile(filePath, 'Hello Electron!', (err) => {
  if (err) throw err;
  console.log('Escritura completada');
});

Descripción de parámetros:

  • fs.readFile(path, encoding, callback): lee el contenido del archivo de forma asíncrona.
  • fs.writeFile(path, data, callback): escribe un archivo (lo crea automáticamente si no existe).
  • path.join(): combina rutas, compatible con varias plataformas.

Monitoreo de archivos

Se puede usarfs.watchpara monitorear cambios de archivos en tiempo real, por ejemplo, para detectar actualizaciones de archivos de configuración o de datos:

fs.watch(filePath, (eventType, filename) => {
  console.log(`文件变化类型: ${eventType}`);
  console.log(`变化的文件: ${filename}`);
});

Rutas de directorio de la aplicación

Electron proporcionaapp.getPath(name)métodos para obtener rutas comunes del sistema:

const { app } = require('electron');

console.log(app.getPath('home'));       // 用户主目录
console.log(app.getPath('desktop'));    // 桌面路径
console.log(app.getPath('userData'));   // 应用数据目录

Estas rutas se pueden usar para almacenar registros, cachés o archivos de configuración del usuario.


Almacenamiento de datos local

Las aplicaciones de Electron suelen necesitar guardar la configuración del usuario, cachés o información de estado. Los métodos de almacenamiento comunes incluyen:

localStorage y sessionStorage

Adecuado para datos simples de pares clave-valor, como configuración de tema, estado de ventana, etc.:

localStorage.setItem('theme', 'dark');
const theme = localStorage.getItem('theme');
console.log(theme);

Diferencia:

  • localStorage: almacenamiento permanente; se conserva después de cerrar la aplicación.
  • sessionStorage: almacenamiento a nivel de sesión; se borra al cerrar la ventana.

Base de datos IndexedDB

Adecuado para almacenar datos estructurados, ideal para aplicaciones sin conexión:

Ejemplo

const request = indexedDB.open('myDatabase', 1);

request.onupgradeneeded = function () {
  const db = request.result;
  db.createObjectStore('users', { keyPath: 'id' });
};

request.onsuccess = function () {
  const db = request.result;
  const tx = db.transaction('users', 'readwrite');
  const store = tx.objectStore('users');
  store.put({ id: 1, name: 'Alice', age: 25 });
};

Uso de electron-store

electron-storeEs la biblioteca de almacenamiento de configuración más conveniente; se persiste automáticamente basada en JSON.

Instalación:

npm install electron-store

Ejemplo de uso:

Ejemplo

const Store = require('electron-store');
const store = new Store();

// Guardar configuración
store.set('user.name', 'Tom');
store.set('theme', 'dark');

// Leer configuración
console.log(store.get('user.name')); // Tom

// Eliminar configuración
store.delete('theme');

Ventajas:

  • Se guarda automáticamente en el directorio de datos del usuario;
  • Formato JSON, intuitivo y fácil de editar;
  • Adecuado para almacenamiento persistente pequeño (configuración, caché, etc.).

Sugerencias para la persistencia de datos

Escenario Solución recomendada
Pares clave-valor simples electron-store
Datos estructurados IndexedDB
Archivos de datos grandes fs + archivos JSON
Base de datos para aplicaciones sin conexión SQLite o LevelDB

Integración de bases de datos

Cuando la aplicación necesita almacenar grandes cantidades de datos o datos relacionales, se puede integrar una base de datos.

Integración de SQLite

SQLite es la base de datos embebida más utilizada en las aplicaciones de Electron.
Instalar dependencias:

 npm install sqlite3

Código de ejemplo:

Ejemplo

const sqlite3 = require('sqlite3').verbose();
const db = new sqlite3.Database('mydata.db');

// Crear tabla
db.run("CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY, name TEXT, age INTEGER)");

// Insertar datos
db.run("INSERT INTO users (name, age) VALUES (?, ?)", ['Alice', 25]);

// Consultar datos
db.all("SELECT * FROM users", [], (err, rows) => {
  if (err) throw err;
  console.log(rows);
});

Uso de LevelDB

LevelDB es una base de datos de tipo clave-valor, adecuada para caché y lectura/escritura de alto rendimiento.

Instalación:

npm install level

Ejemplo de uso:

Ejemplo

const level = require('level');
const db = level('./mydb');

// Escribir datos
await db.put('username', 'Bob');

// Leer datos
const value = await db.get('username');
console.log(value);

Otras opciones de bases de datos

Tipo Escenario de aplicación Biblioteca recomendada
MongoDB Sincronización en la nube, distribuido mongoose
MySQL Grandes datos relacionales mysql2
Realm Sincronización móvil realm-js
LokiJS Base de datos en memoria lokijs

Resumen general

En Electron, las opciones de almacenamiento de datos son flexibles y variadas:

  • Datos pequeños →electron-store;
  • Datos grandes →SQLite;
  • Estructurado →IndexedDB;
  • Claves-valor de alto rendimiento →LevelDB;
  • Basado en archivos →fs + JSON。

Esto permite que las aplicaciones de Electron funcionen de manera ligera y también puedan manejar lógica de negocio compleja y tareas de almacenamiento de datos.

Otras extensiones