Android için Build Tools ve Command Line Tools'u Hızlıca Nasıl Kurarsınız?

Kerem Aydın·10 Temmuz 2026·⏱2 dk

Kısa cevap: Command Line Tools'u indirin, Android SDK klasörüne açın, sdkmanager aracılığıyla "platforms;android-35", "build-tools;35.0.0" ve "platform-tools" paketlerini kurun, ANDROID_SDK_ROOT/ANDROID_HOME değişkenlerini tanımlayın ve bin klasörlerini PATH'e ekleyin — bundan sonra Gradle veya CI üzerinden derleme sorunsuz çalışacaktır.

Hazırlık: Önceden Neler Gerekli?

  • JDK 17+ (OpenJDK 21 önerilir) ve doğru ayarlanmış JAVA_HOME.
  • En az 10 GB boş alan.
  • Gerektiğinde sistem dizinlerine kurulum yapmak için yönetici/root yetkileri. Java'yı kontrol edin:
java -version

Sunucu/CI ortamına kurulum yapıyorsanız, Android Studio içermeyen hafif bir imaj kullanın — Command Line Tools ve gerekli platformlar çok daha az yer kaplar.

Command Line Tools Kurulumu

  1. İşletim sisteminize uygun Command Line Tools arşivini indirin (commandlinetools--latest.zip şeklinde bir dosya).
  2. SDK yapısını oluşturun ve arşivi buraya açın:
# Linux/Mac örneği, kendi yolunuzu kullanın
mkdir -p ~/Android/cmdline-tools
unzip commandlinetools-<os>-latest.zip -d ~/Android/cmdline-tools
# yapı önemlidir: ~/Android/cmdline-tools/latest/...
mv ~/Android/cmdline-tools/cmdline-tools ~/Android/cmdline-tools/latest
  1. PATH'e ekleyin (bash/zsh için):
export ANDROID_HOME=$HOME/Android
export ANDROID_SDK_ROOT=$ANDROID_HOME
export PATH=$PATH:$ANDROID_HOME/cmdline-tools/latest/bin:$ANDROID_HOME/platform-tools

Windows için — ANDROID_HOME değişkenini ve %ANDROID_HOME%\cmdline-tools\latest\bin ile %ANDROID_HOME%\platform-tools yollarını sistem PATH'ine ekleyin (System Properties → Environment Variables üzerinden).

Kontrol edin:

sdkmanager --version

sdkmanager ile SDK Platforms ve Build Tools Kurulumu

  1. Yöneticiyi güncelleyin:
sdkmanager --update
  1. platform-tools, gerekli platform ve Build Tools'u kurun:
sdkmanager "platform-tools" "platforms;android-35" "build-tools;35.0.0"
  1. Lisansları kabul edin:
sdkmanager --licenses
# ve yes yanıtını verin

Tüm sürümleri art arda kurmayın — yalnızca projeleriniz için gerçekten gereken API'leri seçin, böylece disk alanından tasarruf edersiniz.

Kontrol ve Proje Derleme

Araçları kontrol edin:

adb version
$ANDROID_HOME/build-tools/35.0.0/aapt version
sdkmanager --list_installed

Basit bir Gradle projesi oluşturun veya mevcut olanı kullanın. build.gradle dosyasında şunu belirtin:

android {
  compileSdk 35
  buildToolsVersion "35.0.0"
}

Derleme:

./gradlew assembleDebug

Sık Karşılaşılan Hatalar

  • "sdkmanager: command not found" — PATH, cmdline-tools/latest/bin içermiyor.
  • "License not accepted" — sdkmanager --licenses komutunu çalıştırın ve kabul edin.
  • "Java version mismatch" — JDK 17+ kullanın; JAVA_HOME'u kontrol edin.
  • "Out of disk space" — sdkmanager --uninstall "build-tools;XX.X.X" ile gereksiz platformları kaldırın.

SSS

  • Android Studio gerekli mi? Hayır — CI ve hafif ortamlar için Command Line Tools + SDK Platform/Build Tools yeterlidir.
  • build-tools sürümü nasıl seçilir? compileSdk ve buildToolsVersion'ı proje gereksinimleriyle eşleştirin (genellikle ilgili API için en son stabil sürüm yeterlidir).
  • aapt ve apksigner nerede? SDK içindeki build-tools/<sürüm> klasöründe bulunur.
  • CI'da nasıl otomatize edilir? Command Line Tools'u kurun, ardından sdkmanager ile gerekli paketleri yükleyin ve derleme betiğinde lisansları kabul edin.

Artık ortam hazır: testleri çalıştırabilir, APK/AAB oluşturabilir ve derlemeyi CI'a entegre edebilirsiniz.