Installation

Guide d’Installation

Téléchargez et installez GalataJ depuis GitHub Releases. Soyez opérationnel en quelques minutes.

Prérequis

• Java JDK 11+ - Requis pour le profilage des applications Java
• IntelliJ IDEA 2023.1+ (optionnel) - Pour l’intégration IDE

Étape 1 : Télécharger depuis GitHub Releases

1. Allez sur GitHub Releases
2. Téléchargez la dernière archive de version pour votre plateforme :
   • Windows : galataj-<version>-windows.zip
   • Linux : galataj-<version>-linux.tar.gz
   • macOS : galataj-<version>-macos.tar.gz

Étape 2 : Extraire les Fichiers

Extrayez l’archive téléchargée. Vous devriez voir la structure suivante :

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

Étape 3 : Ajouter CLI au PATH

La CLI (galataj) doit être accessible depuis n’importe où sur votre système.

Windows

1. Copiez galataj.exe dans un répertoire (ex. C:\tools)
2. Ajoutez ce répertoire à votre PATH système :
   • Ouvrez Propriétés Système → Variables d’Environnement
   • Modifiez la variable PATH
   • Ajoutez C:\tools (ou votre répertoire choisi)
   • Cliquez sur OK pour enregistrer
3. Redémarrez votre terminal

Alternative : Définissez la propriété système dans IntelliJ IDEA :

• Allez dans Help → Edit Custom VM Options…
• Ajoutez : -Dgalataj.profiler.cli.path=C:\path\to\galataj.exe
• Redémarrez l’IDE

Linux/macOS

Option 1 : Installation système

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

Option 2 : Installation locale utilisateur

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

Étape 4 : Installer le Plugin IntelliJ

Méthode 1 : Installer depuis ZIP (Recommandé)

1. Dans IntelliJ IDEA, allez dans File → Settings → Plugins
2. Cliquez sur ⚙️ → Install Plugin from Disk…
3. Sélectionnez le fichier ZIP du plugin : intellij-plugin/galataj-1.0.0-SNAPSHOT.zip
4. Cliquez sur OK
5. Redémarrez l’IDE quand demandé

Méthode 2 : Installer depuis le Marketplace (Si Disponible)

1. Dans IntelliJ IDEA, allez dans File → Settings → Plugins
2. Recherchez “GalataJ”
3. Cliquez sur Install
4. Redémarrez l’IDE quand demandé

Étape 5 : Vérifier l’Installation

Testez que tout fonctionne :

# Vérifier l'accès à la CLI
galataj --version

# Exécuter la vérification de santé du système
galataj doctor

Sortie attendue :

✓ 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)

Dépannage

CLI Non Trouvée

Erreur : galataj: command not found

Solutions :

1. Vérifiez que la CLI est dans l’archive extraite
2. Vérifiez que PATH inclut le répertoire CLI
3. Redémarrez le terminal après l’ajout au PATH
4. Sur Windows, vérifiez que l’extension de fichier est .exe

Échec de l’Installation du Plugin

Erreur : Le plugin ne s’installe pas ou apparaît corrompu

Solutions :

1. Vérifiez que le fichier ZIP est complet (vérifiez la taille du fichier)
2. Essayez de télécharger à nouveau la version
3. Assurez-vous que la version d’IntelliJ IDEA est 2023.1 ou ultérieure
4. Vérifiez les logs de l’IDE : Help → Show Log in Finder

Controller JAR Non Trouvé

Erreur : Controller JAR not found

Solutions :

1. Vérifiez que controller/controller-1.0.0-SNAPSHOT.jar existe dans l’archive extraite
2. Assurez-vous d’avoir extrait l’archive complète, pas seulement la CLI
3. Vérifiez les permissions de fichier (Linux/macOS)

Agent JAR Non Trouvé

Erreur : Agent JAR not found

Solutions :

1. Vérifiez que agent/agent-core-1.0.0-SNAPSHOT.jar existe dans l’archive extraite
2. Assurez-vous d’avoir extrait l’archive complète
3. Vérifiez les permissions de fichier (Linux/macOS)

Emplacements des Fichiers

Après l’installation, vos fichiers devraient être organisés ainsi :

Windows :

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

Linux/macOS :

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

Prochaines Étapes

• Suivez le Guide de Démarrage Rapide pour commencer le profilage
• Découvrez l’Intégration IntelliJ
• Explorez les commandes CLI
• Configurez les paramètres avancés

Compiler depuis le Code Source

Si vous devez compiler depuis le code source (pour le développement ou des builds personnalisés), consultez le dépôt GitHub pour les instructions de compilation.