API Seviyesi Nedir ve Cihazda Hızlıca Nasıl Öğrenilir

API Seviyesi, platformda mevcut olan Android API setini benzersiz şekilde tanımlayan bir tam sayıdır. API seviyesini hızlıca öğrenebilirsiniz: Ayarlar → Hakkında (Android sürümü) bölümünde veya daha kesin olarak adb aracılığıyla: adb shell getprop ro.build.version.sdk.

API Seviyesi Hakkında Kısa Bilgi

API Seviyesi, bir uygulamanın hangi sınıflara, yöntemlere ve XML niteliklerine erişebileceğini gösterir. Geliştiriciler minSdkVersion ve targetSdkVersion değerlerini belirtir; sistem bunları cihazın API seviyesiyle karşılaştırır ve uygulamanın kurulup kurulamayacağına ve nasıl davranacağına karar verir. API seviyesi ne kadar yüksekse, özellikler o kadar yenidir; çok yüksek bir minSdkVersion, eski cihazlarda kurulumu engeller.

Kendi API Seviyenizi Nasıl Öğrenirsiniz — 5 Pratik Yöntem

1. "Ayarlar" Üzerinden (Hızlı)

• Ayarlar → Telefon Hakkında → Android Sürümü yolunu izleyin. Genellikle yalnızca sürümü gösterir (örneğin, 10); bunu API ile eşleştirin (örneğin, Android 10 → API 29).

2. ADB Üzerinden (Kesin, geliştiriciler için)

• Cihazı USB ile bağlayın veya emülatör kullanın ve şu komutu çalıştırın:

adb shell getprop ro.build.version.sdk

Komut bir tam sayı döndürür — API seviyesi (örneğin, 29). Daha ayrıntılı bilgi için tüm özellikleri görüntüleyebilirsiniz: adb shell getprop.

3. Manifesto veya Proje Gradle Dosyasında (Uygulamalar için)

• AndroidManifest.xml veya build.gradle dosyasında minSdkVersion / targetSdkVersion değerlerine bakın. Gradle örneği:

android {
  defaultConfig {
    minSdkVersion 21
    targetSdkVersion 33
  }
}

Bu, uygulamanın hangi API'leri hedeflediğini gösterir.

4. Android Studio / Device Manager Üzerinden

• IDE'de cihazı bağlayın — Device Manager'da veya Run/Logcat penceresinde sürüm görünür. Yerleşik terminali açıp adb kullanabilirsiniz.

5. Firmware Dosyaları Üzerinden (İleri düzey kullanıcılar için)

• Root erişimi olan bir cihazda veya imajda /system/build.prop dosyasını veya özellikleri kontrol edin:

adb shell cat /system/build.prop | grep ro.build.version

ro.build.version.sdk ve ro.product.first_api_level değerlerine dikkat edin.

API 1 — Bu Ne Anlama Gelir ve Neden Bilmek Önemlidir

API 1, Android 1.0 sürümüne (ilk ticari sürüm) karşılık gelir. Günümüzde API 1'i destekleyen neredeyse hiç modern cihaz veya uygulama yoktur — modern kütüphaneler çok daha yüksek API seviyeleri gerektirir. Bir cihaz API 1 döndürüyorsa, bu ya eski bir emülatör/imaj ya da özel bir derlemedir.

Pratik tespit örneği:

1. Cihazı bağlayın.
2. Şu komutu çalıştırın:

adb shell getprop ro.build.version.sdk

3. Çıktı "1" ise, bu API 1 demektir — cihaz en erken API setini kullanıyor.

Sık Yapılan Hatalar

• Ayarlardaki "Android sürümü"nün her zaman API seviyesine eşit olduğunu varsaymak — her zaman böyle değildir.
• Özel firmware'leri analiz ederken ro.product.first_api_level değerini göz ardı etmek.
• Gerçek hedef kitleyi dikkate almadan minSdkVersion değerini çok yüksek ayarlamak.

SSS

• Android sürümü ile API arasında nasıl eşleştirme yapılır?
  — Her halka açık Android sürümüne karşılık gelen bir API seviyesi vardır (örneğin, Android 10 → 29, Android 14 → 34). Şüpheniz varsa resmi eşleştirme tablosunu kullanın.

• Cihazın API seviyesi değiştirilebilir mi?
  — Hayır — API, sistem/firmware tarafından belirlenir. Sadece farklı API içeren başka bir firmware/imaj yükleyebilirsiniz.

• API nedeniyle uygulama kurulmuyorsa ne yapılmalı?
  — Uygulama derlemesindeki minSdkVersion değerini ve cihazın API seviyesini kontrol edin. Eski cihazları desteklemek için minSdkVersion değerini düşürebilir ve çalışma zamanı kontrolleri ekleyebilirsiniz, ancak bu test gerektirir.

Kısa özet: API Seviyesi, mevcut Android API setini belirleyen bir sayıdır; hızlıca Ayarlar'da, kesin olarak ise adb getprop ro.build.version.sdk ile kontrol edilebilir.