Kurulum

Kurulum Kılavuzu

GalataJ’yi GitHub Releases’ten indirin ve kurun. Dakikalar içinde çalışmaya başlayın.

Ön Gereksinimler

• Java JDK 11+ - Java uygulamalarını profillemek için gerekli
• IntelliJ IDEA 2023.1+ (isteğe bağlı) - IDE entegrasyonu için

Adım 1: GitHub Releases’ten İndirin

1. GitHub Releases sayfasına gidin
2. Platformunuz için en son sürüm arşivini indirin:
   • Windows: galataj-<version>-windows.zip
   • Linux: galataj-<version>-linux.tar.gz
   • macOS: galataj-<version>-macos.tar.gz

Adım 2: Dosyaları Çıkarın

İndirilen arşivi çıkarın. Aşağıdaki yapıyı görmelisiniz:

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

Adım 3: CLI’yi PATH’e Ekleyin

CLI (galataj) sisteminizin her yerinden erişilebilir olmalıdır.

Windows

1. galataj.exe’yi bir dizine kopyalayın (örn. C:\tools)
2. Bu dizini sistem PATH’inize ekleyin:
   • Sistem Özellikleri → Ortam Değişkenleri’ni açın
   • PATH değişkenini düzenleyin
   • C:\tools (veya seçtiğiniz dizini) ekleyin
   • Kaydetmek için Tamam’a tıklayın
3. Terminalinizi yeniden başlatın

Alternatif: IntelliJ IDEA’da sistem özelliği ayarlayın:

• Help → Edit Custom VM Options… menüsüne gidin
• Ekleyin: -Dgalataj.profiler.cli.path=C:\path\to\galataj.exe
• IDE’yi yeniden başlatın

Linux/macOS

Seçenek 1: Sistem genelinde kurulum

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

Seçenek 2: Kullanıcı yerel kurulumu

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

Adım 4: IntelliJ Eklentisini Kurun

Yöntem 1: ZIP’ten Kurulum (Önerilen)

1. IntelliJ IDEA’da File → Settings → Plugins menüsüne gidin
2. ⚙️ → Install Plugin from Disk… seçeneğine tıklayın
3. Eklenti ZIP dosyasını seçin: intellij-plugin/galataj-1.0.0-SNAPSHOT.zip
4. OK’a tıklayın
5. İstendiğinde IDE’yi yeniden başlatın

Yöntem 2: Marketplace’ten Kurulum (Varsa)

1. IntelliJ IDEA’da File → Settings → Plugins menüsüne gidin
2. “GalataJ” arayın
3. Install’a tıklayın
4. İstendiğinde IDE’yi yeniden başlatın

Adım 5: Kurulumu Doğrulayın

Her şeyin çalıştığını test edin:

# CLI erişimini kontrol edin
galataj --version

# Sistem sağlık kontrolü çalıştırın
galataj doctor

Beklenen çıktı:

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

Sorun Giderme

CLI Bulunamadı

Hata: galataj: command not found

Çözümler:

1. CLI’nin çıkarılan arşivde olduğunu doğrulayın
2. PATH’in CLI dizinini içerdiğini kontrol edin
3. PATH’e ekledikten sonra terminali yeniden başlatın
4. Windows’ta dosya uzantısının .exe olduğunu doğrulayın

Eklenti Kurulumu Başarısız

Hata: Eklenti kurulmuyor veya bozuk görünüyor

Çözümler:

1. ZIP dosyasının tam olduğunu doğrulayın (dosya boyutunu kontrol edin)
2. Sürümü tekrar indirmeyi deneyin
3. IntelliJ IDEA sürümünün 2023.1 veya üzeri olduğundan emin olun
4. IDE günlüklerini kontrol edin: Help → Show Log in Finder

Controller JAR Bulunamadı

Hata: Controller JAR not found

Çözümler:

1. Çıkarılan arşivde controller/controller-1.0.0-SNAPSHOT.jar dosyasının var olduğunu doğrulayın
2. Sadece CLI’yi değil, tam arşivi çıkardığınızdan emin olun
3. Dosya izinlerini kontrol edin (Linux/macOS)

Agent JAR Bulunamadı

Hata: Agent JAR not found

Çözümler:

1. Çıkarılan arşivde agent/agent-core-1.0.0-SNAPSHOT.jar dosyasının var olduğunu doğrulayın
2. Tam arşivi çıkardığınızdan emin olun
3. Dosya izinlerini kontrol edin (Linux/macOS)

Dosya Konumları

Kurulumdan sonra dosyalarınız şu şekilde organize edilmelidir:

Windows:

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

Linux/macOS:

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

Sonraki Adımlar

• Profil analizi yapmaya başlamak için Hızlı Başlangıç Kılavuzu’nu takip edin
• IntelliJ Entegrasyonu hakkında bilgi edinin
• CLI komutlarını keşfedin
• Gelişmiş ayarları yapılandırın

Kaynak Koddan Derleme

Kaynak koddan derlemeniz gerekiyorsa (geliştirme veya özel derlemeler için), derleme talimatları için GitHub deposuna bakın.