<uses-sdk>

Google Play, uygulamanızı platform sürümü şartlarını karşılamayan cihazlardan filtrelemek için uygulama manifestinizde beyan edilen <uses-sdk> özelliklerini kullanır. Bu özellikleri ayarlamadan önce Google Play filtrelerini anladığınızdan emin olun.

söz dizimi:
<uses-sdk android:minSdkVersion="integer"
          android:targetSdkVersion="integer"
          android:maxSdkVersion="integer" />
Şurada yer alır:
<manifest>
description:

Bir uygulamanın Android platformunun bir veya daha fazla sürümüyle uyumluluğunu bir API düzeyi tam sayısı aracılığıyla ifade etmenizi sağlar. Bir uygulama tarafından ifade edilen API düzeyi, belirli bir Android sisteminin API düzeyiyle karşılaştırılır. Bu düzey, farklı Android cihazlar arasında değişiklik gösterebilir.

Adına rağmen bu öğe, yazılım geliştirme kitinin (SDK) veya Android platformunun sürüm numarasını değil, API düzeyini belirtmek için kullanılır. API düzeyi her zaman tek bir tam sayıdır. API düzeyini, ilişkili Android sürüm numarasından türetemezsiniz. Örneğin, ana sürümle veya ana ve alt sürümlerin toplamıyla aynı değildir.

Bir uygulamanın alt SDK sürümünü hedeflediğini veya gerektirdiğini belirtmek mümkün değildir.

Ayrıca uygulamalarınızın sürümünü oluşturma ile ilgili belgeyi de okuyun.

özellikler:
android:minSdkVersion
Uygulamanın çalışması için gereken minimum API düzeyini belirten bir tam sayı. Sistemin API düzeyi bu özellikte belirtilen değerden düşükse Android sistemi, kullanıcının uygulamayı yüklemesini engeller. Bu özelliği her zaman beyan edin.

Dikkat: Bu özelliği bildirmezseniz sistem, varsayılan değerin "1" olduğunu varsayar. Bu da uygulamanızın tüm Android sürümleriyle uyumlu olduğunu gösterir. Uyumlu değilse ve doğru minSdkVersion değerini beyan etmediyseniz uygulama, uyumsuz bir API düzeyine sahip bir sisteme yüklendiğinde, kullanılamayan API'lere erişmeye çalışırken çalışma zamanında kilitlenir. Bu nedenle, minSdkVersion özelliğinde uygun API düzeyini belirttiğinizden emin olun.

android:targetSdkVersion
Uygulamanın hedeflediği API düzeyini belirten bir tam sayı. Ayarlanmazsa varsayılan değer, minSdkVersion için verilen değere eşit olur.

Bu özellik, sisteme hedef sürümle test yaptığınızı bildirir ve sistem, uygulamanızın hedef sürümle ileriye dönük uyumluluğunu korumak için herhangi bir uyumluluk davranışını etkinleştirmez. Uygulama daha eski sürümlerde (minSdkVersion sürümüne kadar) çalışmaya devam edebilir.

Android her yeni sürümde geliştiğinden bazı davranışlar, hatta görünümler bile değişebilir. Ancak platformun API düzeyi, uygulamanızın targetSdkVersion tarafından beyan edilen sürümden daha yüksekse sistem, uyumluluk davranışlarını etkinleştirerek uygulamanızın beklediğiniz şekilde çalışmaya devam etmesini sağlayabilir. Çalıştığı platformun API düzeyine uyması için targetSdkVersion değerini belirterek bu tür uyumluluk davranışlarını devre dışı bırakabilirsiniz.

Örneğin, bu değeri "11" veya daha yüksek bir değere ayarlamak, sistemin Android 3.0 veya daha yüksek bir sürümde çalışırken Holo varsayılan temasını uygulamanıza uygulamasını sağlar ve daha büyük ekranlarda çalışırken ekran uyumluluk modunu devre dışı bırakır. Bunun nedeni, API düzeyi 11 desteğinin daha büyük ekranları dolaylı olarak desteklemesidir.

Sistem, bu özellik için ayarladığınız değere göre birçok uyumluluk davranışını etkinleştirebilir. Bu davranışlardan bazıları, Build.VERSION_CODES referansındaki ilgili platform sürümleri tarafından açıklanmıştır.

Uygulamanızı her Android sürümüyle uyumlu tutmak için bu özelliğin değerini en son API düzeyine uyacak şekilde artırın, ardından uygulamanızı ilgili platform sürümünde kapsamlı bir şekilde test edin.

Kullanıma sunulduğu sürüm: API düzeyi 4

android:maxSdkVersion
Uygulamanın çalışmak üzere tasarlandığı maksimum API düzeyini belirten bir tam sayı.

Android 1.5, 1.6, 2.0 ve 2.0.1'de sistem, bir uygulama yüklerken ve sistem güncellemesinden sonra uygulamayı yeniden doğrularken bu özelliğin değerini kontrol eder. Her iki durumda da uygulamanın maxSdkVersion özelliği, sistemin kullandığı API düzeyinden düşükse sistem uygulamanın yüklenmesine izin vermez. Sistem güncellemesinden sonra yeniden doğrulama yapılması durumunda bu, uygulamanızı cihazdan etkili bir şekilde kaldırır.

Bu özelliğin, sistem güncellemelerinden sonra uygulamanızı nasıl etkileyebileceğini göstermek için aşağıdaki örneği inceleyin:

Manifest dosyasında maxSdkVersion="5" beyan eden bir uygulama Google Play'de yayınlanır. Cihazında Android 1.6 (API düzeyi 4) çalıştıran bir kullanıcı, uygulamayı indirip yükler. Birkaç hafta sonra kullanıcı, kablosuz sistem güncellemesiyle Android 2.0'a (API düzeyi 5) geçer. Güncelleme yüklendikten sonra sistem, uygulamanın maxSdkVersion değerini kontrol eder ve başarıyla yeniden doğrular.

Uygulama normal şekilde çalışır. Ancak bir süre sonra cihaz, bu kez Android 2.0.1'e (API düzeyi 6) başka bir sistem güncellemesi alır. Güncellemeden sonra sistem, uygulamanın geçerliliğini yeniden doğrulayamaz çünkü sistemin kendi API düzeyi (6) artık uygulamanın desteklediği maksimum düzeyden (5) daha yüksektir. Sistem, uygulamanın kullanıcı tarafından görülmesini engeller ve uygulamayı cihazdan kaldırır.

Uyarı: Bu özelliği bildirmenizi önermiyoruz. İlk olarak, Android platformunun yeni sürümleri yayınlandıkça uygulamanızın bu sürümlere dağıtımını engellemek için bu özelliği ayarlamanız gerekmez. Platformun yeni sürümleri, tasarım gereği geriye dönük olarak tamamen uyumludur. Uygulamanız yalnızca standart API'leri kullandığı ve geliştirme ile ilgili en iyi uygulamalara uyduğu sürece yeni sürümlerde düzgün çalışır. İkinci olarak, bazı durumlarda bu özelliğin bildirilmesi, daha yüksek bir API düzeyine yapılan sistem güncellemesinden sonra uygulamanızın kullanıcıların cihazlarından kaldırılmasına neden olabilir. Uygulamanızın yüklenebileceği çoğu cihaz, kablosuz bağlantı üzerinden düzenli sistem güncellemeleri alır. Bu nedenle, bu özelliği ayarlamadan önce bu güncellemelerin uygulamanız üzerindeki etkisini göz önünde bulundurun.

Kullanıma sunulduğu sürüm: API düzeyi 4

Android'in bazı sürümleri (Android 2.0.1'den sonraki sürümler), yükleme veya yeniden doğrulama sırasında maxSdkVersion özelliğini kontrol etmez ya da zorunlu kılmaz. Ancak Google Play, kullanıcılara indirilebilecek uygulamaları sunarken bu özelliği filtre olarak kullanmaya devam eder.
tanıtıldığı oyun:
API düzeyi 1

API düzeyi nedir?

API düzeyi, Android platformunun bir sürümü tarafından sunulan çerçeve API düzeltmesini benzersiz şekilde tanımlayan bir tam sayı değeridir.

Android platformu, uygulamaların temel Android sistemiyle etkileşim kurmak için kullanabileceği bir çerçeve API'si sağlar. Çerçeve API'si şunlardan oluşur:

  • Temel paket ve sınıf grubu
  • Manifest dosyası bildirmek için kullanılan XML öğeleri ve özellikleri grubu
  • Kaynakları bildirmek ve kaynaklara erişmek için kullanılan bir dizi XML öğesi ve özelliği
  • Bir dizi niyet
  • Uygulamaların isteyebileceği bir dizi izin ve sistemde yer alan izin yaptırımları

Android platformunun her yeni sürümü, sunduğu Android uygulama çerçevesi API'siyle ilgili güncellemeler içerebilir.

Çerçeve API'sinde yapılan güncellemeler, yeni API'nin API'nin önceki sürümleriyle uyumlu kalmasını sağlayacak şekilde tasarlanmıştır. Yani API'deki çoğu değişiklik ek niteliğindedir ve yeni veya alternatif işlevler sunar. API'nin bazı bölümleri yükseltildiğinde, değiştirilen eski bölümler kullanımdan kaldırılır ancak mevcut uygulamaların bunları kullanmaya devam edebilmesi için kaldırılmaz.

Çok az sayıda durumda API'nin bazı bölümleri değiştirilir veya kaldırılır. Ancak bu tür değişiklikler genellikle yalnızca API'nin sağlamlığını ve uygulama veya sistem güvenliğini desteklemek için gereklidir. Önceki düzeltmelerdeki diğer tüm API bölümleri değişiklik yapılmadan taşınır.

Android platformunun sunduğu çerçeve API'si, API düzeyi adı verilen bir tam sayı tanımlayıcı kullanılarak belirtilir. Her Android platformu sürümü tam olarak bir API düzeyini destekler. Ancak önceki tüm API düzeyleri (API düzeyi 1'e kadar) için destek örtüktür. Android platformunun ilk sürümü API düzeyi 1'i sağlamış, sonraki sürümler ise API düzeyini artırmıştır. Platform kararlılığına ulaşmamış ön sürüm önizleme SDK'larında kullanıma sunulan veya desteği sonlandırılan API'ler, API düzeyi numarası yerine "Geliştirme aşamasındaki API" olarak işaretlenir.

Aşağıdaki tabloda, Android platformunun her sürümü tarafından desteklenen API düzeyi belirtilmiştir. Her bir sürümü çalıştıran cihazların göreceli sayıları hakkında bilgi edinmek için Dağıtım kontrol paneline bakın.

Platform SürümüAPI seviyesiVERSION_CODENotlar
Android 17 37 CINNAMON_BUN Platformda Öne Çıkanlar
Android 16 36 BAKLAVA Platformda Öne Çıkanlar
Android 15 35 VANILLA_ICE_CREAM Platformda Öne Çıkanlar
Android 14 34 UPSIDE_DOWN_CAKE Platformda Öne Çıkanlar
Android 13 33 TIRAMISU Platformda Öne Çıkanlar
Android 12 32 S_V2 Platformda Öne Çıkanlar
31 S Platformda Öne Çıkanlar
Android 11 30 R Platformda Öne Çıkanlar
Android 10 29 Q Platformda Öne Çıkanlar
Android 9 28 P Platformda Öne Çıkanlar
Android 8.1 27 O_MR1 Platformda Öne Çıkanlar
Android 8.0 26 O Platformda Öne Çıkanlar
Android 7.1.1
Android 7.1
25 N_MR1 Platformda Öne Çıkanlar
Android 7.0 24 N Platformda Öne Çıkanlar
Android 6.0 23 M Platformda Öne Çıkanlar
Android 5.1 22 LOLLIPOP_MR1 Platformda öne çıkanlar
Android 5.0 21 LOLLIPOP
Android 4.4W 20 KITKAT_WATCH Yalnızca Giyilebilir Cihazlar İçin KitKat
Android 4.4 19 KITKAT Platformda öne çıkanlar
Android 4.3 18 JELLY_BEAN_MR2 Platformda öne çıkanlar
Android 4.2, 4.2.2 17 JELLY_BEAN_MR1 Platformda öne çıkanlar
Android 4.1, 4.1.1 16 JELLY_BEAN Platformda öne çıkanlar
Android 4.0.3, 4.0.4 15 ICE_CREAM_SANDWICH_MR1 Platformda öne çıkanlar
Android 4.0, 4.0.1, 4.0.2 14 ICE_CREAM_SANDWICH
Android 3.2 13 HONEYCOMB_MR2
Android 3.1.x 12 HONEYCOMB_MR1 Platformda Öne Çıkanlar
Android 3.0.x 11 HONEYCOMB Platformda Öne Çıkanlar
Android 2.3.4
Android 2.3.3
10 GINGERBREAD_MR1 Platformda öne çıkanlar
Android 2.3.2
Android 2.3.1
Android 2.3
9 GINGERBREAD
Android 2.2.x 8 FROYO Platformda Öne Çıkanlar
Android 2.1.x 7 ECLAIR_MR1 Platformda öne çıkanlar
Android 2.0.1 6 ECLAIR_0_1
Android 2.0 5 ECLAIR
Android 1.6 4 DONUT Platformda Öne Çıkanlar
Android 1.5 3 CUPCAKE Platformda Öne Çıkanlar
Android 1.1 2 BASE_1_1
Android 1.0 1 BASE

Geliştirme aşamasındaki API'ler

Android API referans belgelerinde, yayın öncesi SDK'ya eklenen veya bu SDK'da desteği sonlandırılan API'ler, API düzeyi numarası yerine "Geliştirme aşamasındaki API" olarak işaretlenir. Bu etiket, SDK platform kararlılığına ulaşıp nihai bir ana veya alt API seviyesi alana kadar hem "Eklendiği sürüm" hem de "Desteğinin sonlandırıldığı sürüm" bildirimleri için geçerlidir. Geliştirme aşamasındaki API'ler aşağıdaki özelliklere sahiptir:

  • Yayın öncesi önizleme durumu: API ekleme veya desteği sonlandırma, API düzeyi kesinleştirilmeden önce etkin bir Beta veya Canary önizleme SDK sürümünün parçasıdır.
  • Kararlılık garantisi yoktur: Yayınlanan API'lerin aksine (kalıcı bir API düzeyine sahip olan ve gelecekteki sürümlerde geriye dönük uyumlu olan), geliştirme aşamasındaki API'ler imza değiştirebilir, yeniden adlandırılabilir veya önizleme SDK sürümleri arasında tamamen kaldırılabilir.

Çalışma zamanında geliştirme aşamasındaki API'leri kontrol etme (PREVIEW_SDK_INT)

Geliştirme aşamasındaki API'ler önizleme sürümleri arasında değişebileceği veya kaybolabileceği için yayınlanmamış API'lere yapılan çağrıları korumak amacıyla hiçbir zaman büyük veya eşit kontrolü (>=) kullanmayın. Önizleme 1'de bulunan bir API, önizleme 2'de değiştirilebilir veya kaldırılabilir.

Bunun yerine, özellik önizlemelerini deneyen uygulamalar, uygulamanın derlendiği tam önizleme düzeltmesiyle tam eşitlik (==) için Build.VERSION.PREVIEW_SDK_INT değerini kontrol etmelidir:

  • Nihai, üretim derlemeleri ve sürümlerinde Build.VERSION.PREVIEW_SDK_INT her zaman 0 olur.
  • Önizleme derlemelerinde PREVIEW_SDK_INT her sürüm için benzersizdir.

Android'de API düzeyinin kullanımları

API düzeyi tanımlayıcısı, kullanıcılara ve uygulama geliştiricilere mümkün olan en iyi deneyimi sunmada önemli bir rol oynar:

  • Android platformunun, desteklediği maksimum çerçeve API düzeltmesini tanımlamasına olanak tanır.
  • Uygulamaların, ihtiyaç duydukları çerçeve API düzeltmesini tanımlamasına olanak tanır.
  • Sistemin, kullanıcının cihazına uygulama yükleme işlemini yönetmesine olanak tanır. Böylece, sürümle uyumlu olmayan uygulamalar yüklenmez.

Her Android platformu sürümü, API düzeyi tanımlayıcısını dahili olarak Android sisteminin kendisinde depolar.

Uygulamalar, çalışabilecekleri minimum ve maksimum API düzeylerinin yanı sıra desteklemek üzere tasarlandıkları tercih edilen API düzeyini açıklamak için çerçeve API'si (<uses-sdk>) tarafından sağlanan bir manifest öğesini kullanabilir. Öğe üç temel özellik sunar:

  • android:minSdkVersion: Uygulamanın çalışabileceği minimum API düzeyi. Varsayılan değer "1"dir.
  • android:targetSdkVersion: Uygulamanın çalışmak üzere tasarlandığı API düzeyi. Bazı durumlarda bu, uygulamanın yalnızca minimum API düzeyi için tanımlananlarla sınırlı kalmak yerine hedef API düzeyinde tanımlanan manifest öğelerini veya davranışları kullanmasına olanak tanır.
  • android:maxSdkVersion: Uygulamanın çalışabileceği maksimum API düzeyi. Önemli: Bu özelliği kullanmadan önce bu sayfadaki özellik hakkındaki bilgileri okuyun.

Örneğin, bir uygulamanın çalışması için gereken minimum sistem API düzeyini belirtmek üzere uygulama, manifest dosyasında android:minSdkVersion özelliğine sahip bir <uses-sdk> öğesi içerir. android:minSdkVersion değeri, uygulamanın çalışabileceği Android platformunun en eski sürümünün API düzeyine karşılık gelen tam sayıdır.

Kullanıcı bir uygulama yüklemeye çalıştığında veya bir sistem güncellemesinden sonra bir uygulamayı yeniden doğrularken Android sistemi önce uygulamanın manifest dosyasındaki <uses-sdk> özelliklerini kontrol eder ve değerleri kendi dahili API düzeyiyle karşılaştırır. Sistem, yalnızca aşağıdaki koşullar karşılandığında yüklemenin başlamasına izin verir:

  • android:minSdkVersion özelliği tanımlanmışsa değeri, sistemin API düzeyi tam sayısından küçük veya ona eşit olmalıdır. Bildirilmezse sistem, uygulamanın API düzeyi 1'i gerektirdiğini varsayar.
  • android:maxSdkVersion özelliği tanımlanmışsa değeri, sistemin API düzeyi tam sayısına eşit veya ondan büyük olmalıdır. Bildirilmezse sistem, uygulamanın maksimum API düzeyinin olmadığını varsayar. Sistemin bu özelliği nasıl işlediği hakkında daha fazla bilgi için bu özelliğin açıklamasını okuyun.

Bir uygulamanın manifest dosyasında bildirildiğinde <uses-sdk> öğesi şu şekilde görünebilir:

<manifest>
  <uses-sdk android:minSdkVersion="5" />
  ...
</manifest>

Bir uygulamanın android:minSdkVersion içinde API düzeyi beyan etmesinin temel nedeni, Android sistemine, belirtilen API düzeyinde kullanıma sunulan API'leri kullandığını bildirmektir.

Uygulama bir şekilde daha düşük API düzeyine sahip bir platforma yüklenirse mevcut olmayan API'lere erişmeye çalıştığında çalışma zamanında kilitlenir. Sistem, uygulamanın gerektirdiği en düşük API düzeyi hedef cihazdaki platform sürümünden daha yüksekse uygulamanın yüklenmesine izin vermeyerek bu sonucu önler.

Geliştirme ile ilgili dikkat edilmesi gereken noktalar

Aşağıdaki bölümlerde, uygulamanızı geliştirirken dikkate almanız gereken API düzeyiyle ilgili bilgiler verilmiştir.

Uygulama ileriye dönük uyumluluğu

Android uygulamaları genellikle Android platformunun yeni sürümleriyle ileriye dönük uyumludur.

Framework API'de yapılan değişikliklerin neredeyse tamamı eklemeli olduğundan, API düzeyine göre belirtilen herhangi bir API sürümü kullanılarak geliştirilen Android uygulamaları, Android platformunun sonraki sürümleri ve daha yüksek API düzeyleriyle ileriye dönük olarak uyumludur. Uygulama, Android platformunun sonraki tüm sürümlerinde çalışabilir. Ancak uygulamanın, API'nin daha sonra herhangi bir nedenle kaldırılan bir bölümünü kullandığı istisnai durumlar bunun dışındadır.

Android destekli birçok cihaz kablosuz (OTA) sistem güncellemeleri aldığından ileriye dönük uyumluluk önemlidir. Kullanıcı, uygulamanızı yükleyip başarıyla kullanabilir, daha sonra Android platformunun yeni bir sürümüne OTA güncellemesi alabilir. Güncelleme yüklendikten sonra uygulamanız, ortamın yeni bir çalışma zamanı sürümünde çalışır ancak bu sürüm, uygulamanızın bağlı olduğu API ve sistem özelliklerini korur.

API'nin altındaki değişiklikler (ör. temel sistemin kendisindeki değişiklikler), yeni ortamda çalıştırıldığında uygulamanızı etkileyebilir. Uygulama geliştiricisi olarak, uygulamanın her sistem ortamında nasıl göründüğünü ve davrandığını anlamanız önemlidir.

Uygulamanızı Android platformunun çeşitli sürümlerinde test etmenize yardımcı olmak için Android SDK'da indirebileceğiniz birden fazla platform bulunur. Her platform, uygulamanızı test etmek için bir AVD'de çalıştırabileceğiniz uyumlu bir sistem görüntüsü içerir.

Uygulama geriye dönük uyumluluğu

Android uygulamaları, derlendikleri sürümden daha eski Android platformu sürümleriyle geriye dönük uyumlu olmayabilir.

Android platformunun her yeni sürümü, uygulamalara yeni platform özelliklerine erişim sağlayan veya mevcut API parçalarının yerini alan yeni çerçeve API'leri içerebilir. Yeni API'lere, yeni platformda ve platformun sonraki sürümlerinde çalışan uygulamalar tarafından erişilebilir. Bu durum, API düzeyiyle belirtilir. Ancak platformun önceki sürümleri yeni API'leri içermediğinden, yeni API'leri kullanan uygulamalar bu platformlarda çalışamaz.

Android destekli bir cihazın platformun önceki bir sürümüne düşürülmesi pek olası olmasa da, platformun önceki sürümlerini çalıştıran birçok cihazın sahada bulunabileceğini unutmamak önemlidir. OTA güncellemelerini alan cihazlar arasında bile bazıları gecikebilir ve önemli bir süre boyunca güncelleme almayabilir.

Platform sürümü ve API düzeyi seçme

Uygulamanızı geliştirirken, uygulamayı derleyeceğiniz platform sürümünü seçersiniz. Genel olarak, uygulamanızı destekleyebileceği en düşük platform sürümüne göre derleyin.

Uygulamayı sırayla daha düşük derleme hedeflerine göre derleyerek mümkün olan en düşük platform sürümünü belirleyebilirsiniz. En düşük sürümü belirledikten sonra ilgili platform sürümünü ve API düzeyini kullanarak bir AVD oluşturun ve uygulamanızı tam olarak test edin. Uygulamanın manifest dosyasında bir android:minSdkVersion özelliği beyan ettiğinizden ve değerini platform sürümünün API düzeyine ayarladığınızdan emin olun.

Minimum API düzeyini beyan etme

En son platform sürümünde sunulan API'leri veya sistem özelliklerini kullanan bir uygulama geliştiriyorsanız android:minSdkVersion özelliğini en son platform sürümünün API düzeyine ayarlayın. Böylece kullanıcılar, uygulamanızı yalnızca cihazlarında Android platformunun uyumlu bir sürümü çalışıyorsa yükleyebilir. Bu da uygulamanızın kullanıcıların cihazlarında düzgün çalışmasını sağlar.

Uygulamanız, platformun en yeni sürümünde kullanıma sunulan API'leri kullanıyor ancak android:minSdkVersion özelliğini bildirmiyorsa platformun en yeni sürümünü çalıştıran cihazlarda düzgün çalışır ancak platformun önceki sürümlerini çalıştıran cihazlarda çalışmaz. İkinci durumda, uygulama, önceki sürümlerde bulunmayan API'leri kullanmaya çalıştığında çalışma zamanında kilitlenir.

Daha yüksek API düzeylerinde test etme

Uygulamanızı derledikten sonra, uygulamanın android:minSdkVersion özelliğinde belirtilen platformda test ettiğinizden emin olun. Bunun için uygulamanızın gerektirdiği platform sürümünü kullanan bir AVD oluşturun. Ayrıca, ileriye dönük uyumluluğu kontrol etmek için uygulamayı, uygulamanızın kullandığından daha yüksek bir API düzeyi kullanan tüm platformlarda çalıştırıp test edin.

Android SDK'sı, en yeni sürüm de dahil olmak üzere kullanabileceğiniz birden fazla platform sürümü içerir ve gerektiğinde diğer platform sürümlerini indirmek için kullanabileceğiniz bir güncelleme aracı sağlar.

Güncelleyiciye erişmek için <sdk>/tools dizininde bulunan android komut satırı aracını kullanın. android sdk komutunu çalıştırarak SDK güncelleyiciyi başlatabilirsiniz. android.bat (Windows) veya android (OS X/Linux) dosyasını çift tıklayarak da açabilirsiniz.

Uygulamanızı emülatörde farklı platform sürümlerine karşı çalıştırmak için test etmek istediğiniz her platform sürümü için bir AVD oluşturun. AVD'ler hakkında daha fazla bilgi için Sanal cihaz oluşturma ve yönetme başlıklı makaleyi inceleyin. Test için fiziksel bir cihaz kullanıyorsanız cihazın çalıştığı Android platformunun API düzeyini bildiğinizden emin olun. Platform sürümlerinin ve API düzeylerinin listesi için bu dokümandaki tabloya bakın.

Referans belgelerini API düzeyine göre filtreleme

Android platformu referans doküman sayfalarının sol üst kısmında "API düzeyi" kontrolü bulunur. Uygulamanızın manifesto dosyasındaki android:minSdkVersion özelliğinde belirttiği API düzeyine göre, yalnızca uygulamanızın erişebileceği API bölümlerinin belgelerini göstermek için bu kontrolü kullanabilirsiniz.

Filtrelemeyi kullanmak için menüden uygulamanız tarafından belirtilen API düzeyini seçin. Daha sonraki bir API düzeyinde kullanıma sunulan API'ler, uygulamanız tarafından erişilemediği için devre dışı bırakılır ve içerikleri maskelenir.

Belgelerde API düzeyine göre filtreleme yapıldığında her API düzeyindeki yenilikler veya eklenen özellikler gösterilmez. Bu sayede, belirli bir API düzeyiyle ilişkili API'nin tamamını görüntüleyebilir ve daha sonraki API düzeylerinde kullanıma sunulan API öğelerini hariç tutabilirsiniz.

Belgelerin tamamını görüntülemeye dönmek için API düzeyi menüsünün üst kısmındaki REL'i seçin. Varsayılan olarak API düzeyi filtreleme devre dışıdır. Böylece, API düzeyinden bağımsız olarak tam çerçeve API'yi görüntüleyebilirsiniz.

Her bir API öğesi için referans belgeleri, her öğenin kullanıma sunulduğu veya kullanımdan kaldırıldığı API düzeyini belirtir. Paketlerin ve sınıfların API düzeyi, her doküman sayfasındaki içerik alanının sağ üst köşesinde "API düzeyinde eklendi" ve geçerli olduğunda "API düzeyinde desteği sonlandırıldı" olarak belirtilir. Sınıf üyelerinin API düzeyi, ayrıntılı açıklama başlıklarının sağ kenar boşluğunda belirtilir. Platform kararlılığına ulaşmamış yayın öncesi API eklemeleri veya desteği sonlandırmaları için bu konumlarda API düzeyi numarası yerine "API geliştirme aşamasında" ifadesi gösterilir.