Repository navigation
Installation and Setup es
English · Español
CyberFiles es una aplicación de escritorio para Windows construida con Tauri, Rust y una interfaz web. Sigue los requisitos previos oficiales de Tauri para Windows para la cadena de herramientas de Rust, las herramientas de compilación de Microsoft C++ y el entorno WebView2.
La versión preliminar actual para Windows x64 es CyberFiles v0.8.0. Para el instalador recomendado, descarga CyberFiles_0.8.0_x64-setup.exe. Para la edición portátil, descarga CyberFiles_0.8.0_x64-portable.zip. El archivo SHA256SUMS.txt contiene las sumas de comprobación de ambos paquetes.
El instalador NSIS ofrece instalación para el usuario actual o para todo el sistema. Elegir la instalación para todo el sistema puede requerir aprobación de administrador. La instalación usa el material gráfico de CyberFiles y sigue el idioma del sistema, inglés o español, sin un selector de idioma, y la página final de instalación ofrece ejecutar CyberFiles en cuanto termine. Si falta el runtime de WebView2, la instalación descarga su cargador de arranque, por lo que se necesita conexión a internet durante la instalación.
Para una copia portátil, extrae el ZIP y ejecuta CyberFiles.exe. Almacena la configuración y los datos de usuario en la carpeta CyberFiles_Data junto al ejecutable; conserva esa carpeta al mover o hacer una copia de seguridad de la aplicación. El perfil portátil es independiente de la aplicación instalada y requiere el runtime WebView2 Evergreen.
Las copias instaladas se actualizan por sí mismas. CyberFiles lee el manifiesto de versión firmado al iniciar y cada seis horas; cuando existe una versión más reciente muestra las notas de la versión con la opción de instalar ahora, posponer o omitir esa versión. El instalador conserva el tipo de instalación elegido durante la instalación (usuario actual o todo el sistema) y CyberFiles se reinicia al terminar. La descarga solo se instala cuando su firma coincide con la versión, así que un archivo modificado se rechaza.
Acerca de CyberFiles, abierto desde el menú de la bandeja, ejecuta una comprobación a petición e informa del motivo cuando no se puede alcanzar el manifiesto. La misma ventana desactiva la comprobación automática.
La edición portátil no se actualiza por sí misma, porque el instalador no es dueño de esa carpeta. Acerca de CyberFiles enlaza a la página de versiones en su lugar: descarga el nuevo ZIP y reemplaza los archivos antiguos, conservando la carpeta CyberFiles_Data junto al ejecutable.
El manifiesto se publica en la rama updater en lugar de como un archivo de la versión latest, porque cada versión 0.x se marca como prelanzamiento y el endpoint releases/latest de GitHub las omite.
Configuración › General tiene una sección Integración con Windows con dos integraciones opcionales. Ambas escriben solo datos de registro por usuario, así que ninguna necesita aprobación de administrador, y ambas están disponibles solo en la aplicación de escritorio de Windows.
Menú contextual Abrir en CyberFiles. Añade una entrada Abrir en CyberFiles al menú contextual de cada carpeta, incluido el fondo de carpeta dentro de una ventana del Explorador. Elegirla abre esa carpeta en una pestaña nueva de CyberFiles. Desactivar la opción elimina la entrada, y desinstalar CyberFiles también la elimina. Si CyberFiles ya se está ejecutando, usar la entrada trae la ventana abierta al frente; abrir la carpeta dentro de la ventana en ejecución está previsto para una versión futura.
Iniciar con Windows. Lanza CyberFiles automáticamente al iniciar sesión, registrado mediante la entrada de ejecución de Windows por usuario. Cuando esto está activado, aparece una opción Iniciar minimizado, activada de forma predeterminada: los arranques por inicio de sesión permanecen en el área de notificación en lugar de mostrar la ventana, mientras que cualquier arranque que hagas tú siempre muestra la ventana. Desactivar la opción elimina la entrada de ejecución, y desinstalar CyberFiles también la elimina.
Desde la raíz del repositorio:
npm ci
npm run dev:desktopLa aplicación de escritorio se inicia con la vista de Este equipo. Usa la aplicación nativa para probar la detección de unidades, las propiedades de Windows, el atajo global, la exploración de archivos, las operaciones de archivos y el comportamiento de la Papelera.
npm run build:desktopEsto crea un ejecutable de depuración local sin empaquetar un instalador. Es útil para desarrollo, no para distribución.
npm run build:installerEsto crea el instalador NSIS x64 en src-tauri/target/release/bundle/nsis. La primera compilación de versión puede tardar varios minutos mientras se compilan las dependencias de Rust.
npm run build:portableEsto compila el ejecutable de escritorio y lo empaqueta como un ZIP portátil en src-tauri/target/release/bundle/portable.
npm run lint
npm test
npm run test:nativenpm test ejecuta las pruebas unitarias de TypeScript. npm run test:native ejecuta las pruebas de Rust y debe ejecutarse en el entorno de compilación de Windows compatible. npm run check ejecuta las comprobaciones de lint y de compilación del frontend.
npm run dev:vite-internal inicia Vite en http://127.0.0.1:1421 para la resolución de problemas solo de interfaz. El comando normal de escritorio, npm run dev:desktop, inicia Tauri y gestiona este servidor automáticamente. La vista previa en el navegador es solo para desarrollo y pruebas; no puede enumerar las unidades de Windows ni usar las funciones nativas de Windows Shell, Papelera de reciclaje o atajo global.
En un navegador compatible, la vista previa puede pedir al usuario que seleccione una carpeta mediante la File System Access API. La compatibilidad del navegador es limitada, la API requiere un contexto seguro y un gesto del usuario, y el acceso se rige por los permisos del navegador. Consulta la documentación de showDirectoryPicker() de MDN. Estas restricciones del navegador no definen las capacidades de la aplicación de escritorio de Windows.
- Configuración de Windows → Aplicaciones → Aplicaciones instaladas
- Busca CyberFiles → Haz clic en Desinstalar
La página de confirmación ofrece una casilla Eliminar datos de la aplicación, desactivada de forma predeterminada. Márcala para también eliminar tu configuración y el perfil de WebView2; déjala desactivada para conservarlos para una reinstalación futura.
La edición portátil no tiene desinstalador. Elimina la carpeta extraída, incluida CyberFiles_Data, cuando ya no la necesites.
- Archivos del programa
- Accesos directos del menú Inicio y del escritorio, si se crearon
- La carpeta de instalación recordada (guardada en el registro para que una reinstalación aterrice en el mismo lugar)
- La entrada de menú Abrir en CyberFiles del Explorador, si estaba activada
- La entrada de ejecución al iniciar con Windows, si estaba activada
- La configuración y el perfil de WebView2, solo cuando se marca Eliminar datos de la aplicación
- La configuración (
%APPDATA%\com.cybergems.cyberfiles) y el perfil de WebView2 (%LOCALAPPDATA%\com.cybergems.cyberfiles), conservados de forma predeterminada - Tus archivos: desinstalar elimina solo lo que añadió el instalador, nunca tus documentos o carpetas
⚠️ Para eliminar todos los datos, marca Eliminar datos de la aplicación durante la desinstalación, o elimina ambas carpetas después.
Empujar una etiqueta anotada v* que coincida con las versiones en package.json y src-tauri/tauri.conf.json compila y publica automáticamente una versión. Incluye un resumen conciso orientado al usuario en el mensaje de la etiqueta; se convierte en el resumen de la versión.
CyberFiles is developed by CyberGems. See the source repository. · CyberFiles es desarrollado por CyberGems. Consulta el repositorio de código fuente.
Español — índice
Primeros pasos
Uso
Configuración
Referencia
Getting Started
Usage
Configuration
Reference