Bu sayfa, Cloud Translation API ile çevrilmiştir.

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

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

31 Ağustos 2023'ten itibaren:

Yeni uygulamalar, Android 13 (API düzeyi 33) veya sonraki sürümleri hedeflemelidir. Wear OS uygulamaları, Android 11 (API düzeyi 30) ile Android 13 (API düzeyi 33) arasındaki sürümleri hedeflemesi gereken uygulamalar hariçtir.
Uygulama güncellemeleri Android 13 veya sonraki sürümleri hedeflemeli ve Android 13'teki davranış değişikliklerine göre ayarlama yapmalı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 şartlarını 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 iyileştiren değişiklikler sunar. Bu değişikliklerden bazıları yalnızca targetSdkVersion manifest özellikleriyle (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 hedefleyecek şekilde yapılandırılması, kullanıcıların bu iyileştirmelerden yararlanmalarını sağlar. Üstelik, uygulamanız eski Android sürümlerinde çalışmaya devam edebilir. 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) itibarıyla, 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ür.

Bu dokümanda, hedef API seviyenizi Google Play şartını karşılayacak şekilde güncellerken bilmeniz gereken önemli noktalar vurgulanmaktadır.

Alt sürümlerden taşıma işlemi gerçekleştirirken lütfen aşağıdaki 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ındaki 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ş yapın

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ş yapın

Güvenlik ve İzinler

Bluetooth: BLUETOOTH ve BLUETOOTH_ADMIN izinlerine ilişkin bildirimleri BLUETOOTH_SCAN, BLUETOOTH_ADVERTISE veya BLUETOOTH_CONNECT izinleriyle değiştirmeniz gerekir. Artık Bluetooth işlemleri için LOCATION çalışma zamanı izni isteğinde bulunmanız gerekmez.
Konum: Kullanıcılar uygulamalardan yalnızca yaklaşık konum bilgilerini almalarını isteyebilir. ACCESS_FINE_LOCATION için her istekte ACCESS_COARSE_LOCATION iznini almanız gerekir.
Amaç filtreleri: Uygulamanızda amaç filtreleri kullanan etkinlikler, hizmetler veya yayın alıcıları varsa bu bileşenler için android:exported özelliğini açıkça beyan etmeniz gerekir.
Hazırda bekleme: Belirli bir süre kullanılmayan uygulamalar hazırda bekletilebilir. Hazırda bekleme modundayken uygulamanızın çalışma zamanı izinleri ve önbelleği sıfırlanır ve iş veya uyarı çalıştıramazsınız. Uygulamanızın hazırda bekleme durumunu kontrol edebilirsiniz.
Bekleyen intent değişkenliği: Uygulamanızın oluşturduğu her PendingIntent nesnesinin değişkenliğini belirtmeniz gerekir.

Kullanıcı Deneyimi

Özel bildirimler: Özel içerik görünümleri içeren bildirimler artık tüm bildirim alanını kullanmayacak; bunun yerine sistem standart bir şablonu uygulamalıdır. Bu şablon, özel bildirimlerin tüm durumlarda diğer bildirimlerle aynı süslemeye sahip olmasını sağlar. Bu davranış, Notification.DecoratedCustomViewStyle özelliğinin 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 amaç 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 bir ön plan hizmeti başlatmaya çalışırsa bir istisna oluşur (birkaç özel durum hariç).

Uygulamanız arka planda çalışırken hızlandırılmış ç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 alarm içinde başlatın.
Bildirim trambolin 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şenini başlatarak yanıt verir. Bu uygulama bileşeni, bildirim trambolini olarak bilinir.

Uygulamalar, bildirim trampolizi 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 hizmet veya yayın alıcısının içinden startActivity() işlevini çağıramaz.

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

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

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

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

Uygulamanızın bu sürümlerde sunulan değişiklikleri hesaba kattığından emin olmak için aşağıdaki sürümlerden 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çiş

Aşağıdaki noktalar, Android 6.0 ve platformun daha yüksek 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 verme işlemleri için imkan 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 yolunun olduğundan emin olun.

Android 6.0'da (API düzeyi 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çiş

Aşağıdaki noktalar, Android 7.0 ve platformun daha yüksek 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 Optimize Etme 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 düzeyi 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çiş

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

Arka Plan Yürütme Sınırları
- Sistem, ön planda çalışmayan uygulamaların hizmetlerini kısıtlar.
  - startService() yasaklıyken bir uygulama çağrılmaya çalıştığında startService() artık bir istisna bildiriyor.
  - Ön plan hizmetlerini başlatmak için bir uygulamanın startForeground() ve startForegroundService() kullanması gerekir.
  - Android 8.0 (API düzeyi 26) Davranış Değişiklikleri sayfasında açıklandığı gibi, JobScheduler API'sında yapılan değişiklikleri dikkatlice inceleyin.
  - Firebase Cloud Messaging, Google Play hizmetleri SDK'sının 10.2.1 veya sonraki bir sürümünü gerektirir.
  - Firebase Cloud Messaging kullanılırken mesaj teslimi arka plan yürütme sınırlarına tabidir. Mesaj alındıktan sonra arka plan çalışması gerektiğinde (ör. arka planda veri senkronizasyonu gerçekleştirmek için) uygulamanız, işleri Firebase İş Dispatcher veya JobIntentService aracılığıyla planlamalıdır. Daha fazla bilgi için Firebase Cloud Messaging belgelerine bakın.
- Örtülü yayınlar
  - Örtülü yayınlar kısıtlanmıştır. Arka plan etkinliklerini işleme hakkında bilgi için JobScheduler API belgelerine bakın.
- Arka Plan Konum Sınırları
  - Arka planda çalışan uygulamalar konum verilerine sınırlı erişime sahiptir.
    - Google Play Hizmetleri bulunan cihazlarda, düzenli konum güncellemeleri almak için çok kaynaklı konum sağlayıcısını kullanın.
Bildirim Kanalları
- Her kanal için bildirim kesinti özelliklerini tanımlamanız gerekir.
- Bildirimlerin görünmesi için bir kanala bildirim atamalısınız.
- Platformun bu sürümünde NotificationCompat.Builder desteği var.
Gizlilik
- ANDROID_ID her uygulama imzalama anahtarı için belirlenir.

Android 8.0'da (API düzeyi 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

Güç Yönetimi
- Uygulama Beklemeye Alma paketleri; ertelenmiş işler, alarmlar ve yüksek öncelikli mesajlardaki kotalar gibi uygulama etkileşimine dayalı yeni arka plan kısıtlamaları getirir
- Pil tasarrufu iyileştirmeleri, uygulama beklemedeki uygulamalarla ilgili sınırlamaları artırır
Ön plan hizmeti izni
- Normal izin (FOREGROUND_SERVICE) istenmesi gerekiyor (çalışma zamanında izin değil)
Gizlilikle ilgili değişiklikler
- Arka plan sensörlerine sınırlı erişim
- Arama kayıtlarına kısıtlı erişim artık CALL_LOG izin grubunda
- Telefon numaralarına erişim kısıtlandı, READ_CALL_LOG izni gerekli
- Kablosuz bilgilerine erişim kısıtlı

Android 9.0'da (API düzeyi 28) başlatı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) taşıma

Tam ekran amacı taşıyan bildirimler
- Normal izin USE_FULL_SCREEN_INTENT (çalışma zamanı izni değil) istenmelidir.
Katlanabilir cihazlar ve büyük ekranlı cihazlar için destek
- Artık birden fazla etkinlik aynı anda "devam ettirildi" durumunda olabilir, ancak gerçekte yalnızca birine odaklanılmıştır.
  - Bu değişiklik onResume() ve onPause() davranışını etkiler.
  - onTopResumedActivityChanged()'e abone olduğunuzda tespit edilebilen "en çok devam ettirilen" yeni yaşam döngüsü kavramı.
    - Yalnızca bir etkinlik "en üstte devam ettirilebilir".
- resizeableActivity false değerine ayarlandığında uygulamalar, ek olarak daha dar en boy oranlarında uygulamanın otomatik olarak sinemaskop yapmasını sağlayan bir minAspectRatio özelliği de belirtebilir.
Gizlilikle ilgili değişiklikler
- Kısıtlı depolama
  - Harici depolama erişimi, yalnızca uygulamaya özel bir dizin ve uygulamanın oluşturduğu belirli medya türleriyle sınırlıdır.
- Uygulama arka plandayken konuma erişim kısıtlandı. Bunun için ACCESS_BACKGROUND_LOCATION izni gerekiyor.
- IMEI ve seri numarası gibi sıfırlanamayan tanımlayıcılara kısıtlı erişim.
- Kullanıcının adım sayısı gibi fiziksel aktivite bilgilerine erişim kısıtlı olduğu için ACTIVITY_RECOGNITION izni gerekli.
- ACCESS_FINE_LOCATION izni gerektiren bazı telefon, Bluetooth ve kablosuz API'lere erişim kısıtlandı.
- Kablosuz ayarlarına kısıtlı erişim
  - Uygulamalar artık kablosuz bağlantıyı doğrudan etkinleştiremez veya devre dışı bırakamaz ve bunu ayar panellerini kullanarak yapması gerekir.
  - WifiNetworkSpecifier veya WifiNetworkSuggestion kullanımını gerektiren, kablosuz ağ bağlantısı başlatmayla ilgili kısıtlamalar.

Android 10'dan (API düzeyi 29) Android 11'e (API düzeyi 30) taşıma

Gizlilik
- Kapsamlı depolama alanı yaptırımı : Uygulamalar, uygulamaya özgü dosyaların, medyaların ve diğer dosya türlerinin kaydedilip özel konumlar kullanılarak kaydedildiği kapsamlı depolama alanı modelini benimsemelidir.
- İzinleri otomatik sıfırlama: Kullanıcılar birkaç aydır bir uygulamayla etkileşimde bulunmazsa sistem, uygulamanın hassas izinlerini otomatik olarak sıfırlar. Bu durum çoğu uygulamayı etkilemeyecektir. Uygulamanız çoğunlukla kullanıcı etkileşimi olmadan arka planda çalışıyorsa kullanıcılardan otomatik sıfırlamayı devre dışı bırakmalarını isteyebilirsiniz.
- Arka planda konum erişimi: Uygulamalar, ön ve arka planda konum iznini ayrı ayrı istemelidir. Arka planda konum iznine erişim verme, çalışma zamanında istenen izin iletişim kutuları yerine yalnızca uygulama ayarlarından verilebilir.
- Paket Görünürlüğü: Bir uygulama, cihazdaki yüklü uygulamaların ve hizmetlerin listesini sorguladığında, döndürülen liste filtrelenir.
  - Metin okuma veya Konuşma Tanıma hizmetlerini kullanıyorsanız manifest dosyasına hizmetler için sorgu öğeleri eklemeniz gerekir.
Güvenlik
- Sıkıştırılmış "resource.arsc" dosyaları artık desteklenmiyor
- APK İmza Şeması v2 artık gerekli. Geriye dönük uyumluluk nedeniyle geliştiriciler de APK İmza Şeması v1 ile imzalamaya devam etmelidir.
- SDK olmayan arayüz kısıtlaması. API düzeyi 30'u hedefleyen uygulamalarda SDK olmayan arayüzlerin kullanılması önerilmez. Bunun nedeni, bu SDK olmayan arayüzlerin bazıları artık engellenmiş olmasıdır. Engellenen SDK olmayan arayüzlerin kapsamlı bir listesi için Artık Android 11'de engellenen SDK olmayan arayüzler bölümüne bakın.

Android 11'de (API düzeyi 30) kullanıma sunulan değişikliklerin kapsamlı bir listesi için Davranış Değişiklikleri sayfasına bakın.

Önceki bölümde verilen talimatları uygulayarak API 31'e güncellemeye 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ünde olan KameraX'i kullanmayı düşünebilirsiniz.
En iyi uygulamaları hayata geçirmenize, standart kod yazmak zorunda kalmamanıza ve karmaşık görevleri basitleştirerek en iyi uygulamaları uygulamanıza yardımcı olacak Jetpack bileşenlerini kullanın. Böylece, önem verdiğiniz koda odaklanabilirsiniz.
Daha az kodla daha hızlı bir şekilde daha iyi uygulamalar yazmak için Kotlin'i kullanın.
Gizlilik şartlarına 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) son Firebase Cloud Messaging sürümüne taşıyın.
Gelişmiş pencere yönetiminden yararlanın.
- Donanımdaki son gelişmelerden yararlanmak için daha büyük en boy oranlarını (16:9'dan fazla) destekleyin. Uygulamanızın yeniden boyutlandırıldığında, mevcut ekran alanını doldurduğundan emin olun. Maksimum en boy oranını yalnızca son çare olarak belirtin. Maksimum en boy oranları hakkında daha fazla bilgi için Kısıtlı Ekran Desteği Bildirme bölümüne bakın.
- Uygulamanızın üretkenliği artırmasına ve birden fazla ekranı yönetmesine yardımcı olmak için çoklu pencere desteği ekleyin.
- Harika bir küçültülmüş uygulama deneyimi kullanıcı deneyimini iyileştirecekse Pencere İçinde Pencere işlevi için destek ekleyin.
- Ekran kesme özelliğine sahip cihazlar için optimize edin.
- Durum çubuğu yüksekliğini dikkate almayın. Bunun yerine WindowInsets ve View.OnApplyWindowInsetsListener araçlarını kullanın. Açıklama için bu videoyu izleyin.
- Uygulamanın tüm pencereyi kaplayacağını varsaymayın. Bunun yerine, konumunu View.getLocationOnScreen() yerine View.getLocationInWindow() kullanarak onaylayın.
- MotionEvent kullanırken MotionEvent.getRawX() yerine MotionEvent.getX() ve MotionEvent.getY() MotionEvent.getRawY() kullanı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 ise daha fazla inceleme gerektirecektir. 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ğun sağlanması gerekir.

Destek Kitaplığı'nın ana sürümüyle aynı veya ondan daha eski 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 ş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ültenimiz dahil olmak üzere Android ve Google Play'den önemli güncellemeler ile duyuruları gönderebilmemiz için Google Play Console'da e-postalara kaydolun.