Android SDK Nedir ve Nasıl Kullanılır?

Kerem Aydın·7 Temmuz 2026·⏱3 dk

Android SDK; derleyiciler, emülatörler, ADB, build-tools ve platformlardan oluşan, Android uygulamaları oluşturmak, test etmek ve derlemek için kullanılan bir araç setidir. SDK'yı Android Studio üzerinden veya ayrı olarak komut satırı yardımcı programlarıyla kurun, platform-tools'u PATH'e ekleyin ve SDK Manager ya da sdkmanager ile güncellemeler yapın; bu sayede API sürümlerinin uyumlu olması sağlanır ve derleme hatalarının önüne geçilir.

Bileşenler ve İşlevleri

  • Android Studio — grafik editörü, şablonları ve yerleşik SDK Manager'ı ile önerilen IDE'dir.
  • Platform-tools — hata ayıklama ve cihaz yönetimi için ADB ve Fastboot içerir.
  • Build-tools — APK/AAB derlemeleri için Gradle, AAPT ve diğer yardımcı programları barındırır.
  • SDK Platforms — her sürüm için çerçeve (framework) içeren API paketleri (örneğin android-35). Bu bileşenler, Kotlin/Java kodunu ART/Dalvik bytecode'a derlemenize, emülatörde test etmenize ve yayın sürümlerini imzalamanıza olanak tanır.

Hızlı Kurulum (Önerilen Yöntem)

  1. Android Studio'yu indirip kurun (kurulum paketi SDK'yı içerir).
  2. Kurulum sırasında Standard profilini seçin (Platform-tools, Emulator ve Build-tools indirilecektir).
  3. İlk çalıştırmada Tools → SDK Manager yolunu izleyerek gerekli SDK Platforms ve SDK Tools seçeneklerini işaretleyin.
  4. SDK yolunu belirtin (varsayılan olarak: macOS/Linux'ta ~/Android/Sdk, Windows'ta C:\Users<User>\AppData\Local\Android\Sdk).
  5. Lisansları kabul edin ve indirme işleminin tamamlanmasını bekleyin.

Studio'yu kurmak istemiyorsanız, yalnızca command line tools ve sdkmanager kullanabilirsiniz (bkz. sonraki bölüm).

Komut Satırı Aracılığıyla Kurulum ve Güncelleme

  • Yalnızca komut satırı araçlarını (command-line tools) indirin, arşivden çıkarın ve sdkmanager'ı kullanın.
  • Temel paketi kurun: sdkmanager "platform-tools" "platforms;android-35" "build-tools;35.0.0"
  • Lisansları kabul edin: sdkmanager --licenses
  • Her şeyi aynı anda güncelleyin: sdkmanager --update
  • Belirli paketleri güncelleyin: sdkmanager "platforms;android-35" "build-tools;35.0.0"

Kurulumdan sonra adb'yi kontrol edin: adb version

Ortam Değişkenlerinin Ayarlanması

Windows (PowerShell): $env:ANDROID_HOME = "C:\Users\Your\AppData\Local\Android\Sdk" setx PATH "%PATH%;%ANDROID_HOME%\platform-tools"

macOS/Linux (bash/zsh): export ANDROID_HOME="$HOME/Android/Sdk" export PATH="$PATH:$ANDROID_HOME/platform-tools"

Terminali yeniden başlatın ve adb version komutunu çalıştırarak kontrol edin.

Pratik İpuçları ve Uyumluluk

  • Modern derlemeler için Java 17+ sürümünü kullanın.
  • Yeni uygulamalar için mevcut API'yi hedefleyin (örneğin api 35) — Play Store, yayınlar için güncel API seviyeleri gerektirir.
  • Araçları güncelledikten sonra önbellek sorunlarını önlemek için ./gradlew clean && ./gradlew assembleDebug komutunu çalıştırın.
  • Emülatörler ve sistem imajları çok fazla alan kaplar — gereksiz platformları SDK Manager üzerinden kaldırın.

Build-tools ve Gradle eklentisi sürümlerini karıştırmayın: eski araçlar sıklıkla derleme hatalarına neden olur. Bağımlılıkları her zaman SDK ile birlikte güncelleyin.

Sık Karşılaşılan Hatalar

  • ADB not found — platform-tools PATH'e eklenmemiş veya terminal yeniden başlatılmamış.
  • Licenses not accepted — sdkmanager --licenses komutunu çalıştırıp lisansları kabul edin.
  • Build failed (minSdk/targetSdk mismatch) — build.gradle dosyasındaki minSdkVersion ve targetSdkVersion değerlerini kontrol edin ve ilgili platformları kurun.
  • Yavaş indirme — yansı sunucuları kullanın veya Android Studio'da Settings → Appearance & Behavior → System Settings → Android SDK → SDK Update Sites yoluyla SDK yöneticisini yapılandırın.

SSS

  • Geliştirme için Android Studio gerekli mi? Hayır, editor + command line tools ile çalışabilirsiniz ancak Studio kurulumu ve hata ayıklamayı kolaylaştırır.
  • Alan nasıl boşaltılır? Eski SDK Platforms ve gereksiz system images'leri SDK Manager üzerinden kaldırın.
  • Gradle'ın yeni platformu kullanması nasıl sağlanır? build.gradle dosyasındaki compileSdkVersion/targetSdkVersion değerlerini güncelleyin ve ilgili platformu SDK Manager üzerinden kurun.