🎯 Objetivo
Transformar una compilación de producción estándar de React/Vite en un instalador .exe nativo de Windows, independiente y altamente personalizado. El wrapper omite el marco de ventana estándar del SO para presentar una interfaz determinista y cinematográfica de instalador en 5 pasos.
🛠️ Módulos de Ingeniería Principal
1. Intercepción del Ciclo de Vida y Estilo de Ventana (electron.js)
Inicializar una huella de ventana fija y codificada ($760 \times 480\text{px}$) con las siguientes propiedades nativas estrictas:
frame: false(Deshabilitar todos los bordes/marcos de ventana nativos del SO)resizable: false(Bloquear dimensiones)transparent: true(Habilitar fondo transparente para estilos web personalizados)
Exponer una arquitectura IPC (Comunicación entre Procesos) asíncrona, aislada y segura a través de preload.js. Esto pasa datos limpiamente entre el runtime de fondo y la capa de renderizado React sin provocar fallos de seguridad por acceso al sandbox.
2. Despliegue de Activos del Sistema (Capa de Fondo Node.js)
- Mapeo de Directorios: Analizar dinámicamente rutas de cadena del espacio de trabajo para construir carpetas destino de manera segura usando
fs-extra. - Inyección de Accesos Directos: Activar un proceso hijo en segundo plano que ejecuta comandos de PowerShell de Windows para construir accesos directos
.lnkdirectamente en el entorno del Escritorio del usuario. - Población del Registro de Lista de Aplicaciones del SO: Inyectar directamente la telemetría requerida de la aplicación de software en la ruta del índice del registro de la máquina local:
HKCU\Software\Microsoft\Windows\CurrentVersion\Uninstall\[NombreApp]Asegurar la población correcta deDisplayName,DisplayIcon, directorios de instalación y cadenas de desinstalación operativas para vincular limpiamente la aplicación a la utilidad Agregar o quitar programas de Windows.
🎨 Arquitectura Frontend y Máquina de Estados (React)
La interfaz del instalador ejecuta una máquina de estados React determinista de 5 pasos, estilizada con primitivas azul pizarra profundas y minimalistas (#0a0f1d, #111827) utilizando Tailwind CSS:
- Fase de Bienvenida: Cabecera tipográfica mínima que muestra la versión del software y banderas de configuración.
- Explorador de Directorios de Tema Personalizado: Un diálogo modal de selección de carpetas personalizado que se ejecuta directamente dentro del contexto DOM de la aplicación web (evitando el explorador de archivos nativo de Windows, que no coincide).
- Alternancia de Espacio de Trabajo: Componente de casilla de verificación con estado (activada por defecto) que gobierna la creación e implementación de archivos de acceso directo en el escritorio.
- Fase de Progreso Cinematográfico: Diseño sin bordes a sangre completa que renderiza micro-interacciones y animaciones CSS suaves sincronizadas con una animación de progreso lineal de exactamente 3.5 segundos, que coincide con la ejecución de copia del sistema de archivos.
- Opciones de Finalización: Pantalla de salida con bifurcación dual que ofrece un disparador de salida estándar o la ejecución inmediata del sistema mediante "Iniciar aplicación".
🖼️ Protocolo de Resolución del Logotipo de la Aplicación
El instalador requiere primitivas gráficas de alta fidelidad (icon.ico y un logo.png transparente). Resuelve los componentes visuales faltantes usando esta secuencia de respaldo:
- Protocolo A: Marca Suministrada por el Usuario (Nivel Alto): Si se proporciona un activo personalizado a través de la pantalla de configuración del asistente, captura el objeto del archivo, valida las dimensiones, transmítelo a las capas de la interfaz de usuario y compila la variante
.icodirectamente en los metadatos del encabezado del ejecutable final. - Protocolo B: Respaldo Contextual Impulsado por IA (Nivel de Conocimiento Cero): Si no se proporciona marca, analiza los metadatos de la aplicación (nombre, descripción, sector industrial). Realiza una búsqueda vectorial o de repositorio para extraer un icono de código abierto limpio, geométrico y minimalista. Barrera de seguridad: Prohibir absolutamente diseños caóticos, decorativos o clip-art literales. Solo son válidas estructuras vectoriales abstractas y de alta gama.
⚠️ Restricciones y Barreras de Seguridad
- Direccionamiento de Activos Relativo: Asegurar que todos los activos de salida dentro de las configuraciones de compilación utilicen rutas relativas (
./static/...). Las referencias de resolución web absolutas romperán dentro del sistema de archivos empaquetado, causando un error de pantalla blanca en tiempo de ejecución. - Aislamiento de Seguridad: Mantener
nodeIntegration: falseycontextIsolation: trueactivos en todo momento. Todas las operaciones de la plataforma en segundo plano deben transitar de manera segura a través de la capacontextBridge.
📝 Ejemplos
Ejemplo: Inyección de Destinos de Manifiesto en package.json
"build": {
"appId": "com.whyskai.custominstaller",
"productName": "WhyskAI-CustomInstaller-Maker",
"win": {
"target": ["nsis"],
"icon": "assets/icon.ico"
},
"nsis": {
"oneClick": false,
"allowToChangeInstallationDirectory": true,
"installerIcon": "assets/icon.ico",
"uninstallerIcon": "assets/icon.ico",
"createDesktopShortcut": true,
"runAfterFinish": true
}
}