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

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

31 Ağustos 2023'ten itibaren:

  • Yeni uygulamalar, Android 11 (API düzeyi 30) ile Android 13 (API düzeyi 33) arasındaki sürümleri hedeflemesi gereken Wear OS uygulamaları hariç olmak üzere Android 13 (API düzeyi 33) veya sonraki sürümleri hedeflemelidir.

  • Uygulama güncellemeleri Android 13 veya sonraki sürümleri hedeflemeli ve Android 13'teki davranış değişikliklerine göre ayarlamalıdır. Wear OS uygulamaları ise Android 11'i hedeflemelidir.

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ın hedef API düzeyi gereksinimlerini karşılaması gerekmez.

Not: 2022'den itibaren güncel olmayan bazı uygulamalar, Android'in yeni sürümlerini çalıştıran cihazların yeni kullanıcıları tarafından kullanılamayacaktır.

Neden yeni SDK'ları hedeflemelisiniz?

Her yeni Android sürümü, güvenlik ve performans iyileştirmeleri sağlayan ve Android kullanıcı deneyimini geliştiren değişiklikler sunar. Bu değişikliklerden bazıları yalnızca targetSdkVersion manifest özelliğiyle (hedef API düzeyi olarak da bilinir) açıkça destek veren uygulamalar için geçerlidir.

Uygulamanızın yeni bir API düzeyini hedeflemek üzere yapılandırılması, uygulamanızın eski Android sürümlerinde çalışmaya devam etmesine olanak tanırken kullanıcıların bu iyileştirmelerden yararlanabilmesini sağlar. Yeni bir API seviyesini hedeflemek, aynı zamanda uygulamanızın platformun en son özelliklerinden yararlanmasına olanak tanır. Bu da kullanıcılarınızı memnun edecektir. Ayrıca, Android 10 (API düzeyi 29) sürümünden itibaren, uygulama Android 5.1 (API düzeyi 22) veya önceki sürümleri hedefliyorsa kullanıcılar bir uygulamayı ilk kez başlatırken bir uyarı görürler.

Bu dokümanda, Google Play gereksinimini karşılamak için hedef API seviyenizi güncellerken bilmeniz gereken önemli noktalar vurgulanmaktadır.

Eski sürümlerden taşıma işlemi gerçekleştirirken lütfen değişikliklerin tam listesini inceleyin.

Not: Gradle dosyanız manifest girişleri içeriyorsa Derlemenizi yapılandırma bölümünde açıklandığı gibi uygulamanızın Gradle dosyasında geçerli targetSdkVersion değerini onaylayabilir veya değiştirebilirsiniz. Alternatif olarak, <uses-sdk> manifest öğesinin dokümanlarında açıklandığı gibi manifest dosyasındaki android:targetSdkVersion özelliğini de kullanabilirsiniz.

Android 12'den (API düzeyi 31) Android 13'e (API düzeyi 33) geçiş

Uygulamanızı Android 13'ü hedefleyecek şekilde güncellemek için davranış değişiklikleri listesini uygulayın.

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ümleri içeren bildirimler artık bildirim alanının tamamını kullanmayacak; bunun yerine sistem standart bir şablon uyguluyor. Bu şablon, özel bildirimlerin tüm eyaletlerdeki diğer bildirimlerle aynı süslemeye sahip olmasını sağlar. Bu davranış, Notification.DecoratedCustomViewStyle uygulamasının davranışıyla neredeyse aynıdır.
  • Android Uygulama Bağlantıları doğrulamasında değişiklikler: Android Uygulama Bağlantısı doğrulamasını kullanırken intent filtrelerinizin BROWSABLE kategorisini içerdiğinden ve HTTPS şemasını desteklediğinden emin olun.

Performans

  • Ön plan hizmetini 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 bir ön plan hizmeti başlatmaya çalışırsa bir istisna oluşur (birkaç özel durum hariç).

    Uygulamanız arka planda çalışırken daha hızlı çalışma planlamak ve başlatmak için WorkManager'ı kullanabilirsiniz. Kullanıcının istediği zamana bağlı işlemleri tamamlamak için ön plan hizmetlerini tam bir alarmda başlatın.

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

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

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

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

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

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

Uygulamanızın bu sürümlerde sunulan değişiklikleri dikkate aldığından emin olmak için aşağıdaki sürümlerin her biri için ilgili Davranış Değişiklikleri sayfasına bakın:

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

Android 6'ya (API düzeyi 23) geçme

Aşağıdaki noktalar, Android 6.0 ve platformun daha yeni sürümlerini hedefleyen uygulamalar için geçerlidir:

  • Çalışma Zamanı İzinleri

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

    • Mümkün olduğunda, uygulamanızın izin isteklerinin reddedilmesini ele almaya hazır olduğundan 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 seviyesi 23) başlatılan değişikliklerin kapsamlı bir listesi için platformun ilgili sürümünün Davranış Değişiklikleri sayfasına bakın.

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

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

Aşağıdaki noktalar, Android 7.0 ve platformun daha yeni sürümlerini hedefleyen uygulamalar için geçerlidir:

  • Doz ve Uygulamayı Beklemeye Alma

    Çeşitli platform sürümlerinde başlatılan artımlı değişiklikleri kapsayan Doz ve Uygulamayı Beklemeye Alma için Optimizasyon bölümünde açıklanan davranışlara göre tasarım yapın.

    Bir cihaz Doz ve Uygulama Bekleme Modu'ndayken 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 bir FileUriExposedException tetikler. Uygulamanızın dışında dosya paylaşmanız gerekiyorsa FileProvider uygulayın
  • Sistem, NDK olmayan kitaplıklara bağlanmayı yasaklar.

Android 7.0'da (API seviyesi 24) başlatılan değişikliklerin kapsamlı bir listesi için platformun ilgili sürümünün Davranış Değişiklikleri sayfasına bakın.

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

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

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

Android 8.0'da (API seviyesi 26) başlatılan değişikliklerin kapsamlı bir listesi için platformun ilgili sürümünün Davranış Değişiklikleri sayfasına bakın.

Android 8'den (API 26) Android 9'a (API 28) taşıma

Android 9.0'da (API seviyesi 28) başlatılan değişikliklerin kapsamlı bir listesi için davranış değişiklikleri sayfasını inceleyin.

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) başlatılan değişikliklerin kapsamlı bir listesi için Davranış Değişiklikleri sayfasına bakın.

Önceki bölümde bulunan talimatları uygulayarak API 31'e güncelleme işlemine devam edin.

Uygulamalarınızı modernize etme

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.

  • Kameradan en iyi şekilde yararlanmak için Beta sürümündeki KameraX'i kullanmayı düşünebilirsiniz.
  • En iyi uygulamaları uygulamanıza yardımcı olacak, standart kod yazmak zorunda kalmamanızı ve karmaşık görevleri basitleştirerek önem verdiğiniz koda odaklanabilmeniz için Jetpack bileşenlerini kullanın.
  • Daha az kodla daha hızlı uygulama yazmak için Kotlin'i kullanın.
  • Gizlilik gereksinimlerine ve en iyi uygulamalara uyduğunuzdan emin olun.
  • Uygulamalarınıza koyu tema desteği ekleyin.
  • Uygulamalarınıza hareketle gezinme desteği ekleyin.
  • Uygulamanızı Google Cloud Messaging'den (GCM) en son Firebase Cloud Messaging sürümüne taşıyın.
  • Gelişmiş pencere yönetiminden yararlanı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 kendi manifest dosyalarında yayınlar; diğerleri ise daha fazla araştırma gerektirir. API 31'i desteklemeyen bir SDK kullanıyorsanız sorunu çözmek için SDK sağlayıcıyla çalışmaya öncelik verin.

Ayrıca, uygulamanızın veya oyununuzun targetSdkVersion özelliğinin ö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ı konusuna bakın.

Ayrıca, kullanmakta olduğunuz Android Destek Kitaplığı sürümünde bulunabilecek 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 uyumluluğu sağlamanız gerekir.

Destek Kitaplığı'nın ana sürümüyle aynı veya ondan daha küçük 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 seviyesini ve özelliklerini uygun şekilde güncelledikten sonra, bazı temel kullanım durumlarını test etmeniz gerekir. Aşağıdaki öneriler her durumu içermez, sadece test sürecinize rehberlik etmek için verilmiştir. Test yaparak aşağıdakilerden emin olmanızı öneririz:

  • Uygulamanız hata veya uyarı olmadan API 29'a derleme yapıyor.
  • Uygulamanızda, kullanıcının izin isteklerini reddettiği ve kullanıcıdan izin istendiği durumlara ilişkin bir strateji uyguluyor. Bunun 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 durumu testlerini gerçekleştirin ve gerekli izinlerin tekrar istendiğinden emin olun.

  • Doz'u, hiç hata olmadan beklenen sonuçlarla uyguluyor.
    • Adb'yi kullanarak, uygulamanız çalışırken test cihazınızı Doz'a yerleştirin.
      • 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 ayarlayın
      • 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 bir şekilde işlediğinden (yani JobScheduler işlerine taşındığından) emin olun.
    • Bu etkinliklere bağlı olan kritik kullanım durumlarının hala çalıştığından emin olun.
  • Diğer uygulamalarla dosya paylaşma işlemlerini yapıyor
    • Başka herhangi bir uygulama (aynı geliştirici tarafından başka bir uygulama da olabilir) ile dosya verilerini paylaşan kullanım durumlarını test edin
    • İçeriğin diğer uygulamada görünür olup olmadığını ve kilitlenme tetikleyip tetiklemediğini test edin.

Daha fazla bilgi

Size aylık iş ortağı bültenimizle birlikte Android ve Google Play'den önemli güncellemeler ile duyuruları gönderebilmemiz için Google Play Console'da e-postalara kaydolun.