Instalación

Guía de Instalación

Descargue e instale GalataJ desde GitHub Releases. Comience a trabajar en minutos.

Requisitos Previos

• Java JDK 11+ - Requerido para perfilar aplicaciones Java
• IntelliJ IDEA 2023.1+ (opcional) - Para integración con IDE

Paso 1: Descargar desde GitHub Releases

1. Vaya a GitHub Releases
2. Descargue el archivo de la última versión para su plataforma:
   • Windows: galataj-<version>-windows.zip
   • Linux: galataj-<version>-linux.tar.gz
   • macOS: galataj-<version>-macos.tar.gz

Paso 2: Extraer Archivos

Extraiga el archivo descargado. Debería ver la siguiente estructura:

galataj-<version>/
├── agent/
│   └── agent-core-1.0.0-SNAPSHOT.jar
├── controller/
│   └── controller-1.0.0-SNAPSHOT.jar
├── cli/
│   └── galataj.exe (Windows) or galataj (Linux/macOS)
└── intellij-plugin/
    └── galataj-1.0.0-SNAPSHOT.zip

Paso 3: Agregar CLI al PATH

La CLI (galataj) necesita ser accesible desde cualquier lugar en su sistema.

Windows

1. Copie galataj.exe a un directorio (ej. C:\tools)
2. Agregue ese directorio a su PATH del sistema:
   • Abra Propiedades del Sistema → Variables de Entorno
   • Edite la variable PATH
   • Agregue C:\tools (o su directorio elegido)
   • Haga clic en Aceptar para guardar
3. Reinicie su terminal

Alternativa: Establezca la propiedad del sistema en IntelliJ IDEA:

• Vaya a Help → Edit Custom VM Options…
• Agregue: -Dgalataj.profiler.cli.path=C:\path\to\galataj.exe
• Reinicie el IDE

Linux/macOS

Opción 1: Instalación a nivel de sistema

sudo cp cli/galataj /usr/local/bin/

Opción 2: Instalación local del usuario

mkdir -p ~/bin
cp cli/galataj ~/bin/
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc  # or ~/.zshrc
source ~/.bashrc  # or ~/.zshrc

Paso 4: Instalar Plugin de IntelliJ

Método 1: Instalar desde ZIP (Recomendado)

1. En IntelliJ IDEA, vaya a File → Settings → Plugins
2. Haga clic en ⚙️ → Install Plugin from Disk…
3. Seleccione el archivo ZIP del plugin: intellij-plugin/galataj-1.0.0-SNAPSHOT.zip
4. Haga clic en OK
5. Reinicie el IDE cuando se le solicite

Método 2: Instalar desde Marketplace (Si Está Disponible)

1. En IntelliJ IDEA, vaya a File → Settings → Plugins
2. Busque “GalataJ”
3. Haga clic en Install
4. Reinicie el IDE cuando se le solicite

Paso 5: Verificar Instalación

Pruebe que todo funciona:

# Verificar acceso a CLI
galataj --version

# Ejecutar verificación de salud del sistema
galataj doctor

Salida esperada:

✓ Java: Found (11.0.19)
✓ Go: Found (1.21.0)
✓ Controller JAR: Found
✓ Agent JAR: Found
✓ Tools.jar: Found
✓ Controller: Not running (expected)
✓ Ports: Available (9876, 9877)

Solución de Problemas

CLI No Encontrada

Error: galataj: command not found

Soluciones:

1. Verifique que CLI esté en el archivo extraído
2. Compruebe que PATH incluya el directorio CLI
3. Reinicie la terminal después de agregar al PATH
4. En Windows, verifique que la extensión del archivo sea .exe

Instalación del Plugin Falló

Error: El plugin no se instala o aparece corrupto

Soluciones:

1. Verifique que el archivo ZIP esté completo (compruebe el tamaño del archivo)
2. Intente descargar la versión nuevamente
3. Asegúrese de que la versión de IntelliJ IDEA sea 2023.1 o posterior
4. Compruebe los logs del IDE: Help → Show Log in Finder

Controller JAR No Encontrado

Error: Controller JAR not found

Soluciones:

1. Verifique que controller/controller-1.0.0-SNAPSHOT.jar exista en el archivo extraído
2. Asegúrese de haber extraído el archivo completo, no solo la CLI
3. Compruebe los permisos de archivo (Linux/macOS)

Agent JAR No Encontrado

Error: Agent JAR not found

Soluciones:

1. Verifique que agent/agent-core-1.0.0-SNAPSHOT.jar exista en el archivo extraído
2. Asegúrese de haber extraído el archivo completo
3. Compruebe los permisos de archivo (Linux/macOS)

Ubicaciones de Archivos

Después de la instalación, sus archivos deberían estar organizados así:

Windows:

C:\tools\galataj.exe          # CLI (en PATH)
C:\galataj\
  ├── agent\agent-core-*.jar        # Agent JAR
  └── controller\controller-*.jar   # Controller JAR

Linux/macOS:

/usr/local/bin/galataj         # CLI (en PATH)
~/galataj/
  ├── agent/agent-core-*.jar        # Agent JAR
  └── controller/controller-*.jar   # Controller JAR

Próximos Pasos

• Siga la Guía de Inicio Rápido para comenzar a perfilar
• Aprenda sobre la Integración con IntelliJ
• Explore los comandos CLI
• Configure los ajustes avanzados

Compilar desde el Código Fuente

Si necesita compilar desde el código fuente (para desarrollo o compilaciones personalizadas), consulte el repositorio de GitHub para instrucciones de compilación.