412 lines
16 KiB
Markdown
412 lines
16 KiB
Markdown
# Guía de Desarrollo: Launcher para Scripts GUI y Proyectos C#
|
|
|
|
## Resumen del Proyecto
|
|
|
|
Esta guía detalla la implementación completa de launchers para diferentes tipos de proyectos que coexistirán con el sistema actual de scripts de configuración. Se han implementado:
|
|
|
|
1. **Launcher GUI Python**: Para scripts Python con interfaz gráfica
|
|
2. **Launcher C#**: Para proyectos C# compilados (.exe) ✅ **IMPLEMENTADO**
|
|
|
|
## Índice
|
|
|
|
1. [Arquitectura General](#arquitectura-general)
|
|
2. [Launcher GUI Python](#launcher-gui-python)
|
|
3. [Launcher C# - IMPLEMENTADO](#launcher-c-implementado)
|
|
4. [Diferencias entre Launchers](#diferencias-entre-launchers)
|
|
5. [Estructura de Archivos](#estructura-de-archivos)
|
|
6. [APIs Implementadas](#apis-implementadas)
|
|
7. [Estado de Implementación](#estado-de-implementación)
|
|
|
|
## Arquitectura General
|
|
|
|
### Estructura de Tabs
|
|
La aplicación ahora cuenta con tres tabs principales:
|
|
- **Scripts (Config)**: Sistema original sin cambios
|
|
- **Launcher GUI (Python)**: Para scripts Python independientes
|
|
- **Launcher C#**: Para proyectos C# compilados ✅
|
|
|
|
### Principio de Separación
|
|
Cada launcher mantiene sus propios archivos de configuración, favoritos y metadatos, evitando interferencias entre sistemas.
|
|
|
|
## Launcher GUI Python
|
|
|
|
### Características
|
|
- Gestión de entornos Python (conda/virtualenv)
|
|
- Scripts Python (.py) independientes
|
|
- Historial de ejecución
|
|
- Sistema de logging completo
|
|
- Editor: VS Code y Cursor
|
|
|
|
### Archivos de Configuración
|
|
- `launcher_scripts.json`: Grupos de scripts Python
|
|
- `launcher_favorites.json`: Favoritos
|
|
- `launcher_history.json`: Historial de ejecución
|
|
- `launcher_script_metadata.json`: Metadatos de scripts
|
|
|
|
## Launcher C# - IMPLEMENTADO ✅
|
|
|
|
### Características Principales
|
|
|
|
#### ✅ Funcionalidades Implementadas:
|
|
1. **Gestión de Proyectos C#**
|
|
- Agregar/editar/eliminar proyectos C#
|
|
- Búsqueda automática de ejecutables en `bin/Release` y `bin/Debug`
|
|
- Categorización por tipo de proyecto (Aplicaciones, Herramientas, APIs, etc.)
|
|
- Validación de directorios existentes
|
|
|
|
2. **Ejecución de Aplicaciones**
|
|
- Lanzamiento directo de archivos .exe
|
|
- Soporte para argumentos de línea de comandos
|
|
- Indicador de build type (Release/Debug) con badges de colores
|
|
- Ejecución en nueva consola para aplicaciones de línea de comandos
|
|
|
|
3. **Sistema de Favoritos (Sin Historial)**
|
|
- Marcar ejecutables como favoritos
|
|
- Panel de acceso rápido a favoritos
|
|
- Ejecución directa desde favoritos
|
|
- ❌ **Sin historial reciente** (según especificación del usuario)
|
|
|
|
4. **Gestión de Procesos**
|
|
- Monitor de procesos C# en ejecución
|
|
- Capacidad de cerrar procesos activos
|
|
- Información de PID y tiempo de inicio
|
|
- Actualización automática cada 10 segundos
|
|
|
|
5. **Editores Soportados (Específicos para C#)**
|
|
- **Cursor**: Editor moderno para desarrollo
|
|
- **Visual Studio 2022**: IDE enterprise para .NET
|
|
- ❌ **Sin VS Code** (reemplazado por VS2022)
|
|
- Apertura de carpetas en explorador de archivos
|
|
- Copia de paths al portapapeles
|
|
|
|
6. **Sistema de Metadatos**
|
|
- Nombres de display personalizables
|
|
- Descripciones cortas y largas
|
|
- Capacidad de ocultar ejecutables
|
|
- Gestión independiente por proyecto
|
|
|
|
#### 🚫 Características Removidas (respecto a Python):
|
|
- ❌ **Historial de ejecución reciente**
|
|
- ❌ **Sistema de logging de salida de consola**
|
|
- ❌ **Gestión de entornos** (conda/virtualenv)
|
|
- ❌ **VS Code** (reemplazado por Visual Studio 2022)
|
|
|
|
#### 📂 Archivos de Configuración C#:
|
|
```
|
|
data/
|
|
├── csharp_launcher_projects.json # Configuración de proyectos ✅
|
|
├── csharp_launcher_favorites.json # Favoritos ✅
|
|
└── csharp_launcher_metadata.json # Metadatos de ejecutables ✅
|
|
```
|
|
|
|
### Categorías Predefinidas C#
|
|
```json
|
|
{
|
|
"Aplicaciones": {"color": "#3B82F6", "icon": "🖥️"},
|
|
"Herramientas": {"color": "#10B981", "icon": "🔧"},
|
|
"Análisis": {"color": "#8B5CF6", "icon": "📊"},
|
|
"Desarrollo": {"color": "#F59E0B", "icon": "💻"},
|
|
"APIs": {"color": "#EF4444", "icon": "🌐"},
|
|
"Otros": {"color": "#6B7280", "icon": "📁"}
|
|
}
|
|
```
|
|
|
|
### Búsqueda de Ejecutables
|
|
El sistema busca automáticamente archivos .exe usando glob patterns:
|
|
```python
|
|
search_patterns = [
|
|
"project_directory/**/bin/Release/**/*.exe",
|
|
"project_directory/**/bin/Debug/**/*.exe"
|
|
]
|
|
```
|
|
|
|
### Interfaz de Usuario C#
|
|
- **Selector de Proyectos**: Dropdown con icono del proyecto
|
|
- **Botones de Acción**: Cursor, VS2022, Carpeta, Copiar Path
|
|
- **Filtros de Categoría**: Botones para filtrar por tipo
|
|
- **Grid de Ejecutables**: Cards con información de build y favoritos
|
|
- **Panel de Favoritos**: Acceso rápido sin historial
|
|
- **Monitor de Procesos**: Estado en tiempo real
|
|
|
|
## Diferencias entre Launchers
|
|
|
|
### Comparación Completa: Python GUI vs C#
|
|
|
|
| Característica | Python GUI | C# |
|
|
|----------------|------------|-----|
|
|
| **Archivos objetivo** | `*.py` | `*.exe` |
|
|
| **Directorio de búsqueda** | Raíz del grupo | `bin/Release`, `bin/Debug` |
|
|
| **Entornos de ejecución** | ✅ Conda/Virtual | ❌ No aplicable |
|
|
| **Historial reciente** | ✅ Completo con timestamps | ❌ **Removido** |
|
|
| **Sistema de logging** | ✅ Salida capturada en tiempo real | ❌ **Solo eventos básicos** |
|
|
| **Editores soportados** | VS Code, Cursor | **Cursor, Visual Studio 2022** |
|
|
| **Tipo de ejecución** | `python.exe`/`pythonw.exe` | **Directo .exe** |
|
|
| **Directorio de trabajo** | Configurable por grupo | **Directorio del .exe** |
|
|
| **Argumentos** | ✅ Modal completo | ✅ Prompt simple |
|
|
| **Gestión de procesos** | ✅ Con foco de ventana | ✅ **Solo terminación** |
|
|
| **Build indicators** | ❌ No aplicable | ✅ **Release/Debug badges** |
|
|
| **Archivos de configuración** | 4 archivos JSON | **3 archivos JSON** |
|
|
|
|
## Estructura de Archivos
|
|
|
|
### Archivos Implementados ✅
|
|
|
|
```
|
|
ParamManagerScripts/
|
|
├── lib/
|
|
│ ├── launcher_manager.py # Gestor Python GUI
|
|
│ └── csharp_launcher_manager.py # ✅ Gestor C# IMPLEMENTADO
|
|
├── static/
|
|
│ └── js/
|
|
│ ├── launcher.js # JS Python GUI
|
|
│ └── csharp_launcher.js # ✅ JS C# IMPLEMENTADO
|
|
├── templates/
|
|
│ └── index.html # ✅ HTML actualizado con tab C#
|
|
├── data/
|
|
│ ├── launcher_scripts.json # Config Python
|
|
│ ├── csharp_launcher_projects.json # ✅ Config C# CREADO
|
|
│ ├── csharp_launcher_favorites.json # ✅ Favoritos C# CREADO
|
|
│ └── csharp_launcher_metadata.json # ✅ Metadatos C# CREADO
|
|
└── app.py # ✅ APIs C# agregadas
|
|
```
|
|
|
|
### Nuevos Archivos Creados
|
|
|
|
1. **`lib/csharp_launcher_manager.py`** ✅
|
|
- Clase `CSharpLauncherManager`
|
|
- Gestión completa de proyectos C#
|
|
- Búsqueda de ejecutables con glob
|
|
- Sistema de favoritos sin historial
|
|
- Monitor de procesos
|
|
|
|
2. **`static/js/csharp_launcher.js`** ✅
|
|
- Clase `CSharpLauncherManager` frontend
|
|
- Gestión de proyectos desde UI
|
|
- Ejecución de ejecutables con argumentos
|
|
- Sistema de favoritos interactivo
|
|
- Monitor de procesos en tiempo real
|
|
|
|
## APIs Implementadas
|
|
|
|
### APIs C# Agregadas a app.py ✅
|
|
|
|
```python
|
|
# === C# LAUNCHER APIs ===
|
|
|
|
# Gestión de proyectos
|
|
GET/POST /api/csharp-projects
|
|
GET/PUT/DELETE /api/csharp-projects/<project_id>
|
|
|
|
# Gestión de ejecutables
|
|
GET /api/csharp-executables/<project_id>
|
|
POST /api/execute-csharp-executable
|
|
|
|
# Sistema de favoritos (sin historial)
|
|
GET/POST /api/csharp-favorites
|
|
|
|
# Categorías y utilidades
|
|
GET /api/csharp-categories
|
|
GET /api/csharp-running-processes
|
|
POST /api/csharp-process-terminate/<pid>
|
|
```
|
|
|
|
### Endpoints Reutilizados y Extendidos ✅
|
|
```python
|
|
# Editores - Modificados para soportar C# con 'csharp' como group_system
|
|
POST /api/open-editor/<editor>/<group_system>/<group_id>
|
|
# Soporta: editor='cursor'|'vs2022', group_system='csharp'
|
|
|
|
# Gestión de carpetas
|
|
POST /api/open-group-folder/<group_system>/<group_id>
|
|
GET /api/get-group-path/<group_system>/<group_id>
|
|
|
|
# Iconos (pendiente implementación para C#)
|
|
GET /api/group-icon/<launcher_type>/<group_id>
|
|
```
|
|
|
|
## Estado de Implementación
|
|
|
|
### ✅ COMPLETADO - Core Funcional
|
|
- ✅ Backend `CSharpLauncherManager` completo
|
|
- ✅ APIs REST para todas las operaciones C#
|
|
- ✅ Sistema de búsqueda de ejecutables en bin/
|
|
- ✅ Gestión de favoritos (sin historial según spec)
|
|
- ✅ Monitor y terminación de procesos
|
|
- ✅ Frontend JavaScript completo
|
|
- ✅ Tab "Launcher C#" en interfaz
|
|
- ✅ Panel de favoritos funcional
|
|
- ✅ Grid de ejecutables con badges Release/Debug
|
|
- ✅ Soporte básico para argumentos
|
|
- ✅ Integración con sistema de tabs existente
|
|
|
|
### ✅ IMPLEMENTACIÓN AVANZADA (Funcional y Completa)
|
|
- ✅ **Editor de proyectos C#**: Modal completo con formulario avanzado
|
|
- ✅ **Gestor de metadatos**: UI completa con validaciones y notificaciones
|
|
- ✅ **Integración VS2022**: Completamente implementada con detección automática
|
|
- ✅ **Integración Cursor**: Completamente implementada con detección automática
|
|
- ✅ **Integración Explorer**: Apertura de carpetas implementada
|
|
- 🚧 **Detección .sln**: No implementada aún (opcional)
|
|
|
|
### 🎯 PRÓXIMOS PASOS OPCIONALES
|
|
1. **Mejoras de Editor de Proyectos** (ya implementado básicamente)
|
|
- ✅ Formulario completo para agregar/editar proyectos
|
|
- ✅ Navegador de carpetas integrado
|
|
- ✅ Validación de campos en tiempo real
|
|
- 🔧 Drag & drop para agregar proyectos (opcional)
|
|
|
|
2. **Mejoras Opcionales de Editores** (ya implementado básicamente)
|
|
- ✅ Detección automática de Visual Studio 2022
|
|
- ✅ Detección automática de Cursor
|
|
- ✅ Apertura de directorios de proyecto
|
|
- 🔧 Apertura directa de archivos .sln (opcional)
|
|
- 🔧 Configuración personalizada de rutas de editores
|
|
|
|
3. **Mejoras de UX**
|
|
- Drag & drop para agregar proyectos
|
|
- Búsqueda y filtrado avanzado
|
|
- Temas y personalización
|
|
|
|
4. **Características Avanzadas**
|
|
- Detección de versión .NET Framework/Core
|
|
- Integración con MSBuild para compilación
|
|
- Gestión de configuraciones de build
|
|
|
|
## Funcionalidades Específicas C#
|
|
|
|
### Detección de Build Type ✅
|
|
```javascript
|
|
// El sistema detecta automáticamente si es Release o Debug
|
|
const buildType = exe.build_type === 'Release' ?
|
|
'<span class="text-xs bg-green-100 text-green-800 px-2 py-1 rounded">Release</span>' :
|
|
'<span class="text-xs bg-yellow-100 text-yellow-800 px-2 py-1 rounded">Debug</span>';
|
|
```
|
|
|
|
### Ejecución Directa ✅
|
|
```python
|
|
# Ejecución sin captura de salida, en nueva consola
|
|
process = subprocess.Popen(
|
|
cmd,
|
|
cwd=work_dir,
|
|
creationflags=subprocess.CREATE_NEW_CONSOLE if sys.platform == "win32" else 0
|
|
)
|
|
```
|
|
|
|
### Sistema de Favoritos Simplificado ✅
|
|
```javascript
|
|
// Sin historial, solo favoritos
|
|
renderFavoritesPanel() {
|
|
// Solo muestra favoritos, no historial reciente
|
|
// Ejecución directa desde panel de favoritos
|
|
}
|
|
```
|
|
|
|
## Notas de Desarrollo
|
|
|
|
### Decisiones de Diseño Implementadas
|
|
1. **Sin Historial**: Eliminado completamente según especificación del usuario
|
|
2. **Sin Logging de Salida**: Los .exe se ejecutan independientemente sin captura
|
|
3. **Búsqueda Específica**: Solo en directorios bin/Release y bin/Debug
|
|
4. **Editores Específicos**: Cursor y Visual Studio 2022, no VS Code
|
|
5. **Ejecución Directa**: Sin interpreters intermedios como Python
|
|
|
|
### Arquitectura de Separación ✅
|
|
- **Managers Independientes**: `LauncherManager` vs `CSharpLauncherManager`
|
|
- **APIs Separadas**: Prefijo `/api/csharp-*` vs `/api/launcher-*`
|
|
- **Datos Separados**: Archivos JSON independientes
|
|
- **Frontend Modular**: JavaScript classes separadas
|
|
|
|
### Consideraciones de Escalabilidad
|
|
- **Fácil Extensión**: Patrón establecido para agregar nuevos launchers
|
|
- **Reutilización de Componentes**: UI patterns consistentes
|
|
- **Mantenibilidad**: Código bien documentado y modular
|
|
- **Testing**: Estructura preparada para pruebas unitarias
|
|
|
|
## Conclusión - Implementación Completa ✅
|
|
|
|
El **Launcher C#** ha sido **implementado exitosamente** siguiendo exactamente las especificaciones del usuario:
|
|
|
|
### ✅ Requisitos Cumplidos:
|
|
- ✅ **Nuevo tab "Launcher C#"** separado del Python
|
|
- ✅ **Sin historial reciente ni logging** de salida
|
|
- ✅ **Búsqueda de archivos .exe** en bin/Release y bin/Debug
|
|
- ✅ **Editores Cursor y Visual Studio 2022** (sin VS Code)
|
|
- ✅ **Sistema similar al Python** pero adaptado para C#
|
|
- ✅ **Lista manual de proyectos** editable (JSON)
|
|
- ✅ **Favoritos funcionales** sin historial
|
|
- ✅ **Gestión de procesos** C# en ejecución
|
|
|
|
### 🎯 Resultado:
|
|
La aplicación ahora cuenta con **tres launchers completamente funcionales**:
|
|
1. **Scripts (Config)**: Sistema original intacto
|
|
2. **Launcher GUI (Python)**: Con todas sus características
|
|
3. **Launcher C#**: Nuevo sistema optimizado para .NET ✅
|
|
|
|
El proyecto está **listo para uso** con todas las funcionalidades core implementadas. Las mejoras adicionales son opcionales y pueden agregarse incrementalmente según necesidades futuras.
|
|
|
|
### 🚀 Para Usar el Launcher C#:
|
|
1. Ejecutar la aplicación
|
|
2. Ir al tab "Launcher C#"
|
|
3. Usar "Gestionar Proyectos" para agregar proyectos
|
|
4. Seleccionar un proyecto del dropdown
|
|
5. Los ejecutables aparecerán automáticamente
|
|
6. Usar botones de editores, favoritos y ejecución según necesidad
|
|
|
|
**¡Implementación exitosa y funcional!** ✅
|
|
|
|
---
|
|
|
|
## 🎉 Últimas Mejoras Implementadas
|
|
|
|
### Integración Completa de Editores ✅
|
|
- **Cursor**: Detección automática en múltiples ubicaciones comunes
|
|
- **Visual Studio 2022**: Soporte para Community, Professional y Enterprise
|
|
- **Explorer**: Apertura directa de carpetas de proyecto
|
|
|
|
### APIs Extendidas ✅
|
|
```python
|
|
# Editores - Ahora soporta C# con vs2022
|
|
POST /api/open-editor/<editor>/csharp/<project_id>
|
|
# Soporta: editor='cursor'|'vs2022'|'vscode'
|
|
|
|
# Gestión de carpetas - Extiende soporte a C#
|
|
POST /api/open-group-folder/csharp/<project_id>
|
|
GET /api/get-group-path/csharp/<project_id>
|
|
```
|
|
|
|
### Frontend Mejorado ✅
|
|
- **Funciones Async**: Todas las funciones de editor ahora son asíncronas
|
|
- **Manejo de Errores**: Notificaciones elegantes para éxitos y errores
|
|
- **Fallbacks**: Alertas de respaldo si el sistema de notificaciones no está disponible
|
|
- **Clipboard API**: Copia de paths con fallback para navegadores antiguos
|
|
|
|
### Rutas de Detección Automática ✅
|
|
```javascript
|
|
// Visual Studio 2022 - Busca en orden de preferencia:
|
|
- Community: C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\IDE\devenv.exe
|
|
- Professional: C:\Program Files\Microsoft Visual Studio\2022\Professional\Common7\IDE\devenv.exe
|
|
- Enterprise: C:\Program Files\Microsoft Visual Studio\2022\Enterprise\Common7\IDE\devenv.exe
|
|
- x86 fallback: C:\Program Files (x86)\Microsoft Visual Studio\2022\Community\Common7\IDE\devenv.exe
|
|
|
|
// Cursor - Busca en ubicaciones comunes:
|
|
- Local: C:\Users\[user]\AppData\Local\Programs\cursor\Cursor.exe
|
|
- Program Files: C:\Program Files\Cursor\Cursor.exe
|
|
- Program Files x86: C:\Program Files (x86)\Cursor\Cursor.exe
|
|
- PATH: cursor (comando global)
|
|
```
|
|
|
|
### Experiencia de Usuario ✅
|
|
1. **Seleccionar Proyecto C#** → Botones de editores se activan automáticamente
|
|
2. **Click en "Cursor"** → Abre el proyecto directamente en Cursor
|
|
3. **Click en "Visual Studio 2022"** → Abre el proyecto en VS2022
|
|
4. **Click en "📁 Explorador"** → Abre la carpeta del proyecto
|
|
5. **Notificaciones** → Confirmación visual de éxito o error
|
|
|
|
### Compatibilidad ✅
|
|
- **Windows**: Totalmente funcional con rutas nativas
|
|
- **Cross-platform**: APIs preparadas para macOS y Linux
|
|
- **Fallbacks**: Alertas tradicionales si fallan las notificaciones modernas
|
|
- **Navegadores**: Clipboard API con fallback a execCommand
|
|
|
|
**🚀 El Launcher C# ahora tiene funcionalidad completa de editores igual que el launcher Python!** ✅
|
|
|