Google Play'in hedef API düzeyi şartını karşılayın

Yüklediğiniz APK'ların Google Play'in hedef API düzeyi şartlarını karşılaması gerekir.

31 Ağustos 2026'dan itibaren:

  • Yeni uygulamaların ve uygulama güncellemelerinin, Google Play'e gönderilebilmesi için Android 16'yı (API düzeyi 36) veya sonraki sürümleri hedeflemesi gerekir. Wear OS ve Android Automotive OS uygulamaları Android 15'i (API düzeyi 35) veya sonraki sürümleri, Android TV ve Android XR uygulamaları ise Android 14'ü (API düzeyi 34) veya sonraki sürümleri hedeflemelidir.
  • Mevcut uygulamaların, uygulamanızın hedef API düzeyinden daha yüksek Android OS sürümlerinin yüklü olduğu cihazların yeni kullanıcıları tarafından her zamanki gibi bulunabilmesi için Android 15 (API düzeyi 35) veya sonraki sürümleri hedeflemesi gerekir. Wear OS, Android TV ve Android XR için Android 13 (API düzeyi 33) veya önceki sürümler, Android Automotive OS için ise Android 12 (API düzeyi 31) veya önceki sürümler de dahil olmak üzere Android 14 (API düzeyi 34) veya önceki sürümleri hedefleyen uygulamalar, yalnızca uygulamanızın hedef API düzeyiyle aynı veya önceki Android OS sürümlerinin yüklü olduğu cihazlarda kullanılabilir.

Uygulamanızı güncellemek için daha fazla zamana ihtiyacınız varsa 1 Kasım 2026'ya kadar ek süre talep edebilirsiniz. Play Console'da uygulamanızın uzantı formlarına bu yılın ilerleyen dönemlerinde erişebilirsiniz.

Bu şartlarla ilgili istisnalar şunlardır:

  • Belirli bir kuruluştaki kullanıcılarla sınırlı olan ve yalnızca şirket içi dağıtım için tasarlanmış kalıcı olarak özel uygulamalar.

Neden daha yeni SDK'ları hedeflemelisiniz?

Her yeni Android sürümü, güvenlik ve performans iyileştirmeleri sağlamanın yanı sıra Android kullanıcı deneyimini geliştiren değişiklikler sunar. Bu değişikliklerden bazıları yalnızca targetSdkVersion manifest özelliği (hedef API düzeyi olarak da bilinir) aracılığıyla desteği açıkça beyan eden uygulamalar için geçerlidir.

Uygulamanızın yeni bir API düzeyini hedefleyecek şekilde yapılandırılması, kullanıcıların bu iyileştirmelerden yararlanabilmesini sağlarken uygulamanızın daha eski Android sürümlerinde çalışmaya devam etmesine olanak tanır. Yeni bir API düzeyini hedeflemek, uygulamanızın platformun en yeni özelliklerinden yararlanarak kullanıcılarınızı memnun etmesini de sağlar. Ayrıca Android 10 (API düzeyi 29) itibarıyla, Android 5.1 (API düzeyi 22) veya daha eski sürümleri hedefleyen bir uygulamayı ilk kez başlatan kullanıcılar bir uyarı görür.

Bu belgede, Google Play şartını karşılamak için hedef API düzeyinizi güncellerken bilmeniz gereken önemli noktalar vurgulanmaktadır. Geçiş yaptığınız sürüme bağlı olarak aşağıdaki bölümlerde yer alan talimatları inceleyin.

Android 12 ve sonraki sürümlerden (API düzeyi 31) daha yeni bir sürüme geçiş yapma

Uygulamanızı Android'in daha yeni bir sürümünü hedefleyecek şekilde güncellemek için ilgili davranış değişiklikleri listesini inceleyin:

Android 11'den (API düzeyi 30) Android 12'ye (API düzeyi 31) geçiş

Güvenlik ve İzinler

Kullanıcı Deneyimi

  • Özel bildirimler: Özel içerik görünümlerine sahip bildirimler artık bildirim alanının tamamını kullanmayacak. Bunun yerine sistem, standart bir şablon uygulayacak. Bu şablon, özel bildirimlerin tüm durumlarda diğer bildirimlerle aynı parametreye sahip olmasını sağlar. Bu davranış, Notification.DecoratedCustomViewStyle davranışıyla neredeyse aynıdır.
  • Android App Links doğrulama değişiklikleri: Android App Links doğrulamasını kullanırken intent filtrelerinizin BROWSABLE kategorisini içerdiğinden ve HTTPS şemasını desteklediğinden emin olun.

Performans

  • Ön plan hizmeti başlatma kısıtlamaları: Android 12 veya sonraki sürümleri hedeflemek için uygulamanız, birkaç özel durum dışında arka planda çalışırken ön plan hizmetlerini başlatamaz. Bir uygulama arka planda çalışırken ön plan hizmeti başlatmaya çalışırsa istisna oluşur (birkaç özel durum hariç).

    Uygulamanız arka planda çalışırken yüksek öncelikli işleri planlamak ve başlatmak için WorkManager'ı kullanabilirsiniz. Kullanıcının istediği zamana duyarlı işlemleri tamamlamak için kesin zamanlı alarm içinde ön plan hizmetlerini başlatın.

  • Bildirim trambolini kısıtlamaları: Kullanıcılar bildirimlere dokunduğunda bazı uygulamalar, kullanıcının gördüğü ve etkileşimde bulunduğu etkinliği başlatan bir uygulama bileşeni başlatarak yanıt verir. Bu uygulama bileşeni, bildirim trambolini olarak bilinir.

    Uygulamalar, bildirim trampolini olarak kullanılan hizmetlerden veya yayın alıcılarından etkinlik başlatmamalıdır. Kullanıcı bir bildirime veya bildirimdeki işlem düğmesine dokunduktan sonra uygulamanız bir hizmet veya yayın alıcı içinde startActivity() yöntemini çağıramaz.

Android 12'yi (API düzeyi 31) hedefleyen uygulamaları etkileyen değişikliklerin tam listesini görüntüleyin.

Android 11'den (API düzeyi 30) önceki sürümlerden taşıma

Verileri taşıyacağınız Android sürümünü seçin:

Android 5'e (API düzeyi 21) geçiş

Uygulamanızın aşağıdaki sürümlerde yapılan değişiklikleri dikkate aldığından emin olmak için her bir sürümün Davranış Değişiklikleri sayfasını inceleyin:

Bir sonraki bölümde bulunan talimatları izleyerek devam edin.

Android 6'ya (API düzeyi 23) geçiş yapın

Android 6.0 ve platformun sonraki sürümlerini hedefleyen uygulamalar için aşağıdaki hususlar geçerlidir:

  • Çalışma zamanında istenen izinler

    • Tehlikeli izinler sadece çalışma zamanında verilir. Kullanıcı arayüzü akışlarınız, bu izinleri vermek için olanaklar sağlamalıdır.

    • Mümkün olan her durumda uygulamanızın izin isteklerinin reddedilmesini işleyecek şekilde hazırlandığından emin olun. Örneğin, bir kullanıcı cihazın GPS'ine erişim isteğini reddederse uygulamanızın devam etmek için başka bir yolu olduğundan emin olun.

Android 6.0'da (API düzeyi 23) yapılan değişikliklerin kapsamlı bir listesi için platformun bu sürümüne ait Davranış Değişiklikleri sayfasını inceleyin.

Bir sonraki bölümde bulunan talimatları izleyerek devam edin.

Android 7'ye (API düzeyi 24) geçiş

Android 7.0 ve platformun sonraki sürümlerini hedefleyen uygulamalar için aşağıdaki hususlar geçerlidir:

  • Doz ve Uygulamayı Beklemeye Alma

    Doze ve Uygulamayı Beklemeye Alma için optimizasyon bölümünde açıklanan davranışlara göre tasarım yapın. Bu bölüm, çeşitli platform sürümlerinde yapılan artımlı değişiklikleri kapsar.

    Cihaz, Doze ve Uygulamayı Beklemeye Alma modundayken sistem aşağıdaki gibi davranır:

    • Ağ erişimini kısıtlar
    • Alarmları, senkronizasyonları ve işleri erteler.
    • GPS ve kablosuz ağ taramalarını kısıtlar.
    • Normal öncelikli Firebase Cloud Messaging mesajlarını kısıtlar.

  • İzin Değişiklikleri

    • Sistem, uygulamaya özel dizinlere erişimi kısıtlar.
    • Uygulamanızın dışında bir file:// URI'si göstermek FileUriExposedException hatasını tetikler. Uygulamanızın dışında dosya paylaşmanız gerekiyorsa FileProvider uygulayın.

  • Sistem, NDK dışı kitaplıklara bağlantı oluşturulmasına izin vermez.

Android 7.0'da (API düzeyi 24) yapılan değişikliklerin kapsamlı bir listesi için platformun ilgili sürümüne ait Davranış Değişiklikleri sayfasını inceleyin.

Bir sonraki bölümde bulunan talimatları izleyerek devam edin.

Android 8'e (API düzeyi 26) geçiş

Aşağıdaki hususlar, Android 8.0 ve platformun sonraki sürümlerini hedefleyen uygulamalar için geçerlidir:

Android 8.0'da (API düzeyi 26) yapılan değişikliklerin kapsamlı bir listesi için platformun bu sürümüne ait Davranış Değişiklikleri sayfasını inceleyin.

Android 8'den (API 26) Android 9'a (API 28) geçiş

Android 9.0'da (API düzeyi 28) yapılan değişikliklerin kapsamlı bir listesi için davranış değişiklikleri bölümüne bakın.

Android 9'dan (API düzeyi 28) Android 10'a (API düzeyi 29) geçiş

Android 10'dan (API düzeyi 29) Android 11'e (API düzeyi 30) geçiş

Android 11'de (API düzeyi 30) yapılan değişikliklerin kapsamlı bir listesi için Davranış Değişiklikleri sayfasını inceleyin.

Önceki bölümdeki talimatları uygulayarak API 31'e güncellemeye devam edin.

Uygulamalarınızı modernize edin

Uygulamalarınız için hedef API seviyesini güncellediğinizde, uygulamalarınızı modernize ederek kullanıcılarınızı memnun etmek için en son platform özelliklerini kullanmayı düşünün.

SDK'larınızı ve kitaplıklarınızı kontrol edip güncelleme

Üçüncü taraf SDK bağımlılıklarınızın API 31'i desteklediğinden emin olun: Bazı SDK sağlayıcıları bunu manifest dosyalarında yayınlar, diğerleri için ise ek araştırma yapılması gerekir. API 31'i desteklemeyen bir SDK kullanıyorsanız sorunu çözmek için SDK sağlayıcısıyla çalışmaya öncelik verin.

Ayrıca, uygulamanızın veya oyununuzun targetSdkVersion değerinin, özel Android platform kitaplıklarına erişimi kısıtlayabileceğini unutmayın. Ayrıntılar için Platform Kitaplıklarına Bağlanan NDK Uygulamaları başlıklı makaleyi inceleyin.

Ayrıca, kullandığınız Android Destek Kitaplığı sürümünde geçerli olabilecek kısıtlamaları da doğrulamanız gerekir. Her zaman olduğu gibi, Android Destek Kitaplığı'nın ana sürümü ile uygulamanızın compileSdkVersion sürümü arasında uyumluluk olduğundan emin olmanız gerekir.

Destek Kitaplığı'nın ana sürümünden küçük veya ona eşit bir targetSdkVersion seçmenizi öneririz. En son uyumluluk özelliklerinden ve hata düzeltmelerinden yararlanmak için yakın zamanda yayınlanmış uyumlu bir Destek Kitaplığı'na güncelleme yapmanızı öneririz.

Uygulamanızı test etme

Uygulamanızın API düzeyini ve özelliklerini uygun şekilde güncelledikten sonra bazı temel kullanım alanlarını test etmeniz gerekir. Aşağıdaki öneriler kapsamlı olmasa da test sürecinizde size yol göstermeyi amaçlar. Test yaparak aşağıdakilerden emin olmanızı öneririz:

  • Uygulamanızın API 29'da hata veya uyarı olmadan derlendiğini doğrulayın.

  • Uygulamanızın, kullanıcının izin isteklerini reddettiği durumlar için bir stratejisi olmalı ve kullanıcıdan izin istemelidir. Bunu yapmak için:

    • Uygulamanızın Uygulama Bilgileri ekranına gidin ve her bir izni devre dışı bırakın.
    • Uygulamayı açın ve kilitlenme olmadığından emin olun.
      • Temel kullanım alanı testlerini gerçekleştirin ve gerekli izinlerin yeniden istendiğinden emin olun.

  • Doz'u, hiç hata olmadan beklenen sonuçlarla uyguluyor.

    • adb'yi kullanarak uygulamanız çalışırken test cihazınızı Doze moduna alın.
      • Firebase Cloud Messaging mesajları tetikleyen kullanım durumlarını test edin.
      • Alarmlar veya İşler kullanan kullanım durumlarını test edin.
      • Arka plan hizmetlerine olan bağımlılıkları ortadan kaldırın.
    • Uygulamanızı Uygulamayı Beklemeye Alma moduna geçirme
      • Firebase Cloud Messaging mesajları tetikleyen kullanım durumlarını test edin.
      • Alarmlar veya İşler kullanan kullanım durumlarını test edin.

  • Çekilen yeni fotoğrafları / videoları işliyor

    • Uygulamanızın kısıtlanmış ACTION_NEW_PICTURE ve ACTION_NEW_VIDEO yayınlarını doğru şekilde işlediğinden (yani JobScheduler işlerine taşındığından) emin olun.
    • Bu etkinliklere bağlı olan tüm kritik kullanım alanlarının hâlâ çalıştığından emin olun.

  • Dosyaların diğer uygulamalarla paylaşılmasını yönetir - Dosya verilerini başka bir uygulamayla (aynı geliştiricinin başka bir uygulaması bile olsa) paylaşan tüm kullanım alanlarını test edin.

    • İçeriğin diğer uygulamada göründüğünü ve kilitlenmelere neden olmadığını test edin.

Daha fazla bilgi

Aylık iş ortağı bültenimiz de dahil olmak üzere Android ve Google Play'den önemli güncellemeleri ve duyuruları size gönderebilmemiz için Google Play Console'da e-posta listesine kaydolun.