<uses-sdk>

Google Play, <uses-sdk> özelliğini kullanır uygulamanızı cihazlardan filtrelemek için uygulama manifestinizde belirtilen özellikler yeni sürüm URL'leri oluşturabilirsiniz. Bunları ayarlamadan önce özelliklerini anladığınızdan emin olun. Google Play filtreleri.

söz dizimi:

<uses-sdk android:minSdkVersion="integer"
          android:targetSdkVersion="integer"
          android:maxSdkVersion="integer" />

bulunduğu yer:

<manifest>

description:

Bir uygulamanın, Android platformunun bir veya daha fazla sürümüyle uyumluluğunu ifade etmenizi sağlar. bir tam sayı aracılığıyla erişilebilir. Bir uygulamada ifade edilen API düzeyi, Belirli bir Android sisteminin API düzeyi. Bu seviye, farklı Android cihazlara göre değişiklik gösterebilir.

Bu öğe, adına rağmen API seviyesini belirtmek için kullanılır, değil Yazılım geliştirme kiti (SDK) veya Android platformunun sürüm numarası API düzeyi her zaman tek bir tam sayıdır. API düzeyini şuradan elde edemezsiniz: cihazın ilişkili Android sürüm numarası. Örneğin, ana sürüm ya da ana ve alt sürümlerin toplamıdır.

Ayrıca şu konuyla ilgili belgeyi okuyun: uygulamalarınız için sürüm oluşturma hakkında daha fazla bilgi edinin.

özellikler:

android:minSdkVersion

Gereken minimum API düzeyini belirten bir tam sayı yeniden tasarladık. Android sistemi, kullanıcının yükleme yapmasını engelliyor değeri, söz konusu değerden düşük olması durumunda uygulamanın bu özelliği kullanabilirsiniz. Bu özelliği her zaman bildir.

Dikkat: Bunu beyan etmezseniz özelliği ile birlikte, sistem varsayılan olarak "1" değerini varsayar. Bu değer, Android'in tüm sürümleriyle uyumludur. Eğer değil ve doğru minSdkVersion değerini bildirmediyseniz, Uyumsuz API düzeyi olan bir sisteme yüklendiğinde, kullanılamayan API'lere erişmeye çalışırken kilitlenme yaşanıyor. Örneğin, Bu nedenle, minSdkVersion özelliği için de kullanılmaktadır.

android:targetSdkVersion

Uygulamanın hedeflediği API düzeyini belirten bir tam sayı. Ayarlanmazsa varsayılan değer, minSdkVersion öğesine verilen değere eşit.

Bu özellik, sisteme hedef sürümle karşılaştırarak test ettiğiniz ve sisteminin, uygulamanızın ileriye dönük uyumluluğunu korumak için herhangi bir uyumluluk davranışını etkinleştirmemesi hedef sürümle ilişkilendirilir. Uygulama daha düşük 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 belirtilen sürümden yüksekse sistem, uyumluluk davranışlarını etkinleştirebilir. Böylece uygulamanız, beklediğiniz gibi çalışmaya devam eder. Bu tür uyumluluğu devre dışı bırakabilirsiniz davranışları için, API ile eşleşmesi için targetSdkVersion öğesini belirtin. çalıştığı platformun düzeyine bağlıdır.

Örneğin, bu değerin "11" olarak ayarlanması veya üzeri Android 3.0 veya sonraki sürümlerde çalışırken sistemin varsayılan Holo temasını uygulamanıza uygulamasını sağlar. daha yüksek olur ve ayrıca ekranı API düzeyi 11 için dolaylı olarak destek sağladığından, büyük ekranlarda çalışırken uyumluluk modu daha büyük ekranları destekler.

Sistemin, ayarladığınız değere bağlı olarak etkinleştirebileceği pek çok uyumluluk davranışı vardır seçin. Bu davranışların birkaçı ilgili platform sürümlerinde açıklanmıştır. Build.VERSION_CODES referansında.

Uygulamanızı her Android sürümüyle birlikte kullanmaya devam etmek için en son API düzeyiyle eşleşecek şekilde değiştirin ve ardından uygulamanızı ilgili platform sürümünü kullanın.

Kullanıma sunulduğu uygulama: API düzeyi 4

android:maxSdkVersion

Uygulamanın maksimum API düzeyini belirten bir tam sayı çalışacak şekilde tasarlanmıştır.

Android 1.5, 1.6, 2.0 ve 2.0.1'de sistem, bu sürümün özelliğini kullanarak doğrulayabilirsiniz. sistem güncellemesinden sonra. Her iki durumda da, uygulama maxSdkVersion özelliği, tarafından kullanılan API düzeyinden daha düşük sistem, uygulamanın yüklenmesine izin vermez. Sistem güncellemesinden sonra yeniden doğrulamada, bu işlem uygulamanızı cihazdan kaldırır.

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

maxSdkVersion="5" beyan eden bir uygulama manifesto Google Play'de yayınlanır. Cihazı Android çalıştıran bir kullanıcı 1.6 (API düzeyi 4) sürümü, uygulamayı indirir ve yükler. Kullanıcı birkaç hafta sonra Android 2.0 (API düzeyi 5) sürümüne kablosuz sistem güncellemesi alır. güncelleme yüklendiğinde sistem, uygulamanın maxSdkVersion ve başarılı bir şekilde yeniden doğrular.

İlgili içeriği oluşturmak için kullanılan normal şekilde çalışmaya devam etmesini sağlar. Ancak, bir süre sonra cihaz bu sefer Android 2.0.1 (API düzeyi 6) sürümüne güncelleyin. sistem artık uygulamayı yeniden doğrulayamaz. Bunun nedeni, kendi API düzeyiniz (6), artık uygulamanın desteklediği maksimum düzeyin üzerinde (5). Sistem, tarayıcı içinde uygulamanın kullanıcı tarafından görülmesini engeller. etkisi büyüktür.

Uyarı: Bunu beyan etmenizi önermeyiz özelliğini gönderin. Öncelikle, özelliği bir engelleme aracı olarak ayarlamanıza uygulamanızı Android platformunun yeni sürümlerine dağıtarak emin olun. Platformun yeni sürümleri, tasarımları gereği geriye dönük olarak uyumlu. Uygulamanız yeni sürümlerde düzgün çalışıyor, yalnızca standart API'ler kullanması ve geliştirmeyle ilgili en iyi uygulamaları izlemesi koşuluyla çalışır. İkinci olarak, bazı durumlarda özelliğin bildirilmesi uygulamanızın kullanıcıların cihazlardan sonra daha yüksek bir API düzeyine güncelleyin. Uygulamanızın yer aldığı çoğu cihaz düzenli olarak sistem güncellemeleri alır. Bu nedenle, bunu ayarlamadan önce, bunların uygulamanız üzerindeki etkisini göz önünde bulundurun özelliğini gönderin.

Kullanıma sunulduğu uygulama: API düzeyi 4

Android'in bazı sürümlerinde (Android 2.0.1'den sonraki sürümler) sırasında maxSdkVersion özelliğini kontrol edin veya zorunlu kılın doğrulamadan geçebilir. Google Play, filtreler olarak kullanabilirsiniz, ancak kullanıcılara indirin.

tanıtıldığı yer:

API düzeyi 1

API düzeyi nedir?

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

Android platformu, uygulamaların aşağıdakileri yapmak için kullanabileceği bir çerçeve API'si sağlar: Android sistemiyle etkileşime geçmelisiniz. Çerçeve API'si şunlardan oluşur:

• Temel paket ve sınıf grubu
• Manifest dosyasını tanımlamak için kullanılan XML öğeleri ve özellik grubu
• Kaynakları tanımlamak ve bunlara erişmek için kullanılan bir dizi XML öğesi ve özelliği
• Amaçlar grubu
• Uygulamaların isteyebileceği birtakım izinler yaptırımlar dahil, ancak bunlarla sınırlı

Android platformunun birbirini izleyen her sürümü, Android uygulama çerçevesi API'si.

Çerçeve API'sinde yapılan güncellemeler, yeni API'nin sürekli olarak API'nin önceki sürümleriyle uyumludur. Yani API'deki değişikliklerin çoğu Bunlar, katkı sağlamalı ve yeni veya ikame işlev sunmalısınız. API'nin bir parçası olarak yükseltildiğinde, eski değiştirilmiş parçalar kullanımdan kaldırılır ancak kaldırılmaz. kullanmaya devam edebileceğinden emin olmak isteriz.

Nadiren de olsa API'nın bazı bölümleri değiştirilir veya kaldırılır, ancak bu tür değişiklikler genellikle Yalnızca API sağlamlığını ve uygulama veya sistem güvenliğini desteklemek için gereklidir. Tümü önceki revizyonların diğer API bölümleri ise tıklayın.

Bir Android platformunun sunduğu çerçeve API'si, API düzeyi adı verilen tam sayı tanımlayıcısı. Her Android platform sürümü destekler tam olarak bir API düzeyi vardır, ancak daha önceki tüm API düzeyleri için destek dolaylıdır (API düzeyi 1'e kadar). Sağlanan Android platformunun ilk sürümü API düzeyi 1 ve sonraki sürümlerde API düzeyi artırıldı.

Aşağıdaki tabloda, Android platformu. Android cihazınızda kullanılan cihazların göreli her sürümü çalıştırıyorsanız Dağıtım kontrol paneline bakın.

Android'de API düzeyinin kullanımı

API düzeyi tanımlayıcısı, kullanıcılara en iyi deneyimi sunmak için kullanıcılara ve uygulama geliştiricilere yönelik olası deneyim sunar:

• Android platformunun maksimum çerçeve API revizyonunu açıklamasını sağlar destekler.
• Uygulamaların, Google Store API revizyonunu gerekir.
• Uygulamanın, kullanıcının cihazında yüklü olmayan uygulamaları yükleyin.

Her Android platform sürümü kendi API düzeyi tanımlayıcısını dahili olarak depolar. Android sisteminin kendisidir.

Uygulamalar, çerçeve tarafından sağlanan bir manifest öğesini kullanabilir API — <uses-sdk> - minimum ve maksimum API'yi açıklar düzeylerin yanı sıra bu seviyenin altında çalışabilecekleri olacak şekilde tasarlanır. Bu öğenin üç temel özelliği vardır:

• android:minSdkVersion: Minimum API düzeyi izin modudur. Varsayılan değer "1"dir.
• android:targetSdkVersion: API düzeyi üzerinde çalışmak için tasarlandığını unutmayın. Bazı durumlarda bu, hedefte tanımlanan manifest öğelerini veya davranışları kullanır Yalnızca tanımlananları kullanmakla sınırlı olmak yerine API düzeyi seçin.
• android:maxSdkVersion: Maksimum API düzeyi izin modudur. Önemli: Şu makaleyi okuyun: bu özellikle ilgili bilgileri bu sayfada bulabilirsiniz.

Örneğin, bir uygulamanın kullanması gereken minimum sistem API düzeyini belirtmek için çalışması için uygulama manifest dosyasına bir android:minSdkVersion içeren <uses-sdk> öğesi özelliğini gönderin. android:minSdkVersion değeri tam sayıdır Android platformunun ilk sürümünün API düzeyine karşılık gelir altında çalışabileceği anlamına gelir.

Kullanıcı bir uygulama yüklemeyi denediğinde veya bir uygulamayı yeniden doğrularken sistem güncellemesinden sonra, Android sistemi ilk olarak Uygulamanın manifest dosyasındaki <uses-sdk> özellikleri ve değerleri kendi dahili API düzeyiyle karşılaştırır. Sistem, kurulum işlemi yalnızca şu koşullar karşılandığında başlar:

• Bir android:minSdkVersion özelliği tanımlanırsa değeri sistemin API düzeyindeki tam sayısından küçük veya bu değere eşittir. Beyan edilmemişse sistem, uygulamanın API düzeyi 1 gerektirdiğini varsayar.
• Bir android:maxSdkVersion özelliği tanımlanırsa değeri sistemin API düzeyindeki tamsayısına eşit veya bundan daha büyüktür. Beyan edilmezse sistem, uygulamanın Maksimum API düzeyi yok. Şunu okuyun: bu özelliğin açıklamasını inceleyin: ele alacağız.

Bir uygulamanın manifest dosyasında belirtildiğinde <uses-sdk> öğesi aşağıdaki gibi görünebilir:

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

Bir uygulamanın android:minSdkVersion, Android sistemine şunu söyleyecek: belirtilen API düzeyinde sunulan API'leri kullanır.

Öğe uygulama, daha düşük API düzeyine sahip bir platforma yüklenir. var olmayan API'lere erişmeye çalıştığında çalışma zamanında kilitleniyor. Sistem, uygulamanın sisteme izin vermeyerek bu sonucu önler için gereken en düşük API düzeyi, hedef cihazdaki platform sürümü.

Geliştirme konusunda dikkat edilmesi gereken noktalar

Aşağıdaki bölümlerde, API düzeyiyle ilgili olarak, Google Ads'de kullandığınız göz önünde bulundurmanız gerekir.

Uygulama yönlendirme uyumluluğu

Android uygulamaları genellikle Android platformu.

Framework API'de yapılan neredeyse tüm değişiklikler ekleme amaçlı olduğundan Android Google Ads Programı'nın, API'nin belirli bir sürümü kullanılarak geliştirilen uygulama Android platformunun sonraki sürümleriyle ileriye dönük olarak uyumludur ve daha yüksek API düzeyleri. Uygulama sonraki tüm sürümlerde çalışabilir uygulamanın daha sonra herhangi bir nedenle kaldırılan API'nin bir parçasıdır.

Android destekli çoğu cihaz, ileriye dönük uyumluluk önemlidir. kablosuz (OTA) sistem güncellemelerini alma. Kullanıcı, o uygulamayı başarılı bir şekilde kullanmak, ardından daha sonra yeni bir OSA güncellemesi sürümü kullanılıyor. Güncelleme yüklendikten sonra uygulamanız ortamın yeni bir çalışma zamanı sürümünde çalışır ancak hâlâ API'ye sahip olan bir sürüm ve sistem özelliklerini kapsar.

API'nin altındaki değişiklikler (ör. temel alınan yeni sistemde çalıştırıldığında uygulamanızı etkileyebilir. bahsedeceğim. Bu, proje yöneticisi olarak uygulamasının her sistemde nasıl göründüğünü ve davrandığını anlamak için bahsedeceğim.

Uygulamanızı Android'in çeşitli sürümlerinde test etmenize yardımcı olmak platformuna geldiğinde Android SDK, indirebileceğiniz birden çok platform içerir. Her platformda, ortalama görüntüleme süresinde (AVD) çalıştırabileceğiniz uyumlu bir sistem görüntüsü bulunur. uygulamanızı test edin.

Uygulama geriye dönük uyumluluğu

Android uygulamaları, Derlendiği sürümden daha eski Android platformu.

Android platformunun her yeni sürümü yeni çerçeve API'leri içerebilir. Örneğin: erişim sağlayan ve yeni platformların özelliklerini mevcut API parçalarıdır. Yeni API'ler, mobil cihazlarda ve diğer platformlarda ve aynı zamanda yeni platformda API düzeyinde belirtilen şekilde, platforma bağlı olarak değişebilir. Ama önceki sürümlerde yeni API'leri içermez. Yeni API'leri kullanan uygulamalar yeni API'leri yardımcı olan bir self servis platformdur.

Android destekli bir cihazın, şu eski sürüme geçme olasılığı düşük olsa da: diğer platformlarda da mevcuttur. Bunun için de platformun alanda, API'nin önceki sürümlerini çalıştıran pek çok cihazda platformu. OTA güncellemelerini alan cihazlarda bile bazı cihazlarda gecikme yaşanabilir ve uzun bir süre boyunca güncelleme almayabilir.

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

Uygulamanızı geliştirirken uygulamayı derlediğiniz platform sürümü. İçinde uygulamanızı mümkün olan en düşük uygulamanızın destekleyebileceği platformun sürümü gereklidir.

daha düşük derleme hedeflerine karşılaştırmasını sağlar. En düşük sürümü kullanıyorsanız ilgili platformu kullanarak bir ortalama görüntüleme süresi (AVD) oluşturun. sürümünü ve API düzeyini bulup uygulamanızı tam olarak test edin. Hedef kitlenizin kim olduğunu Uygulamanın manifest dosyasındaki android:minSdkVersion özelliği ve değerini, platform sürümünün API düzeyine ayarlayın.

Minimum API düzeyi beyan etme

API'leri veya sistem özelliklerini kullanan bir uygulama derlerseniz en son platform sürümünü kullanıyorsanız android:minSdkVersion özelliğini, en güncel API düzeyiyle ilişkilendirir. platform sürümü gereklidir. Böylece, kullanıcılar yalnızca Android'in uyumlu bir sürümünü çalıştıran kullanıcılar platformu. Bu da uygulamanızın şu cihazlarda düzgün bir şekilde çalışmasını sağlar: cihazlar.

Uygulamanız en son platform sürümünde sunulan API'leri kullanıyorsa, ancak bir android:minSdkVersion özelliği bildirmiyorsa platformun en yeni sürümünü çalıştıran cihazlarda düzgün şekilde çalışır, ancak kullanmaz. İkincisinde çalışmayan API'leri kullanmaya çalıştığında, uygulama çalışma zamanında kilitlenir. eski sürümlerde mevcuttur.

Daha yüksek API seviyeleriyle test edin

Uygulamanızı derledikten sonra, uygulamanın android:minSdkVersion metninde belirtilen platform özelliğini gönderin. Bunu yapmak için en iyi yoludur. Ayrıca, ileriye dönük uyumluluğu kontrol etmek için ve uygulamayı bundan daha yüksek bir API düzeyi kullanan tüm platformlarda test ederek bir değişikliktir.

Android SDK, kullanabileceğiniz birden fazla platform sürümü içerir. içerir ve hem veri analizi hem de veri analizi için kullanabileceğiniz diğer platform sürümlerini gerektiği şekilde indirin.

Güncelleyiciye erişmek için android komut satırı aracını kullanın: <sdk>/tools dizininde bulabilirsiniz. SDK güncelleyiciyi şu şekilde başlatabilirsiniz: android sdk yürütülüyor. Şunları yapabilirsiniz: ayrıca android.bat (Windows) veya android (OS X/Linux) dosyasını çift tıklayın.

Uygulamanızı emülatörde farklı platform sürümlerinde çalıştırmak için Test etmek istediğiniz her platform sürümü için bir ortalama görüntüleme süresi (AVD) oluşturun. Daha fazla hakkında daha fazla bilgi edinmek için Sanal cihaz oluşturma ve yönetme başlıklı makaleyi inceleyin. Eğer Test için fiziksel bir cihaz kullanıyorsanız API düzeyini bildiğinizden emin olun Android platformuna ait. Bu belgedeki tabloda platform sürümleri ve API düzeyleri listesi.

Referans belgeleri API düzeyine göre filtreleyin

Android platformu referans belgeleri sayfaları "API düzeyi" denetim düğmesini tıklayın. URL parametrelerinin Google tarafından nasıl ele alınmasını istediğinizi belirtmek için API'nin yalnızca gerçekten satın alınabilen bölümlerine ait belgeleri uygulamanızın erişebileceği API düzeyini temel alır. manifest dosyasının android:minSdkVersion özelliği.

Filtrelemeyi kullanmak için API'yi seçin uygulamanız tarafından belirtilen menüden düzeyi seçin. Daha sonra kullanıma sunulan API'ler Daha sonra API düzeyi devre dışı olur ve içeriği maskelenmiş durumda olur. Çünkü erişilebilir hale getirebilirsiniz.

Belgelerde API düzeyine göre filtreleme yaptığınızda görünüm sağlanmıyor her API düzeyindeki yenilikler veya özellikler hakkında bilgi edinin. Projenin gidişatı boyunca belirli bir API düzeyiyle ilişkili API'nin tamamını görüntülemek için öğeleri dahil edeceğiz.

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

Bağımsız API öğeleri için referans belgeler her bir öğenin kullanıma sunulduğu API düzeyini belirtir. API düzeyi "API düzeyinde eklendi" olarak belirtildiğinde paketler ve sınıflar CANNOT TRANSLATE her doküman sayfasındaki içerik alanının sağ üst köşesinde yer alır. API düzeyi ayrıntılı açıklama başlıklarında belirtilir. tıklayın.