public code v2

This commit is contained in:
Francisco Jesús Martínez Mimbrera
2026-05-23 00:39:14 +02:00
parent 759a8968a2
commit 40dda44902
4 changed files with 141 additions and 75 deletions
+43 -57
View File
@@ -23,35 +23,61 @@ Flintstones permite definir un problema de decisión (alternativas, criterios, e
## Requisitos
| Herramienta | Versión mínima | Notas |
|---|---|---|
| Docker | 20+ | Para compilar sin instalar nada más |
| Java | 11 | Solo para ejecutar el producto compilado |
| Maven | 3.8+ | Solo si compilas fuera de Docker |
El único requisito es tener **Docker Desktop** instalado. Todo lo demás (Java 11, Maven, GTK…) corre dentro del contenedor.
> **Sin Docker:** necesitas JDK 11 y Maven 3.8+.
> **Con Docker:** solo Docker. El contenedor lleva Maven 3.8.6 y JDK 11.
| Herramienta | Versión mínima | Dónde conseguirla |
|---|---|---|
| Docker Desktop | 20+ | [docker.com/products/docker-desktop](https://www.docker.com/products/docker-desktop/) |
> En Windows, Docker Desktop debe estar en modo **Linux containers** (es el modo por defecto).
---
## Compilar
## Compilar y ejecutar
### Con Docker (recomendado)
### macOS / Linux
```bash
./build.sh
./run.sh
```
O directamente:
### Windows
```bat
run.bat
```
Eso es todo. El script gestiona automáticamente cada situación:
| Situación | Qué hace el script |
|---|---|
| Primera vez | Compila el proyecto + construye la imagen Docker + arranca + abre el navegador |
| Ya compilado, imagen ya construida | Solo arranca el contenedor + abre el navegador |
| Ya está corriendo | Abre el navegador directamente |
La primera compilación descarga dependencias de Eclipse (~1-2 GB) y tarda unos minutos. Las siguientes arrancan en segundos.
La aplicación aparece en el navegador en **`http://localhost:6080`** — no hace falta instalar ningún cliente VNC ni ningún visor especial.
Para parar la aplicación:
```bash
docker compose run --rm build
docker compose stop run # macOS / Linux
```
```bat
docker compose stop run :: Windows
```
La primera vez descarga dependencias de Eclipse (~1-2 GB). Las siguientes compilaciones usan caché y son mucho más rápidas.
### Solo compilar (sin ejecutar)
Los productos quedan en:
```bash
./build.sh # macOS / Linux
```
```bat
build.bat :: Windows
```
Los productos compilados quedan en:
```
releng/flintstones.application.product/target/products/
RCP product-linux.gtk.x86_64.zip
@@ -59,7 +85,9 @@ releng/flintstones.application.product/target/products/
RCP product-win32.win32.x86_64.zip
```
### Sin Docker
### Sin Docker (avanzado)
Requiere JDK 11 y Maven 3.8+ instalados localmente:
```bash
mvn clean install -Dmaven.test.skip=true
@@ -67,48 +95,6 @@ mvn clean install -Dmaven.test.skip=true
---
## Ejecutar
### macOS
```bash
cd releng/flintstones.application.product/target/products/
unzip "RCP product-macosx.cocoa.x86_64.zip"
open Eclipse.app
```
> El ejecutable se llama `Eclipse.app` por herencia del launcher de Eclipse RCP.
> En Apple Silicon (M1/M2/M3) funciona vía Rosetta 2 (arquitectura x86_64).
### Linux
```bash
cd releng/flintstones.application.product/target/products/
unzip "RCP product-linux.gtk.x86_64.zip"
./"RCP product"/linux/gtk/x86_64/flinstones
```
Requiere GTK3:
```bash
sudo apt install libgtk-3-0 # Debian/Ubuntu
```
### Linux con VNC (desde Docker)
Levanta el contenedor con display virtual accesible en `localhost:5900`:
```bash
docker compose run --rm run-vnc
```
Conéctate con cualquier cliente VNC (RealVNC, TigerVNC, etc.) a `localhost:5900`.
### Windows
Descomprime `RCP product-win32.win32.x86_64.zip` y ejecuta `flinstones.exe`.
---
## Métodos disponibles
### Métodos clásicos / Ranking