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

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

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

31 Ağustos 2024'ten itibaren:

Yeni uygulama ve uygulama güncellemelerinin Google Play'e gönderilebilmesi için Android 14 (API düzeyi 34) veya sonraki sürümleri hedeflemesi gerekir (Android 13 (API düzeyi 33) veya sonraki sürümleri hedeflemesi gereken Wear OS ve Android TV uygulamaları hariç.
Mevcut uygulamaların, uygulamanızın hedef API düzeyinden daha yüksek Android OS çalıştıran cihazların yeni kullanıcıları tarafından her zaman olduğu gibi bulunabilmesi için Android 13 (API düzeyi 33) veya sonraki sürümleri hedeflemesi gerekir. Wear OS ve Android 11 (API düzeyi 30) veya Android TV için Android 12 (API düzeyi 31) veya önceki sürümleri (Android 10 (API düzeyi 29) veya önceki sürümleri) hedefleyen uygulamalar, yalnızca uygulamanızın hedef API düzeyiyle aynı veya daha düşük Android OS çalıştıran cihazlarda bulunabilir.

Uygulamanızı güncellemek için daha fazla zamana ihtiyacınız varsa 1 Kasım 2024'e kadar ek süre isteyebilirsiniz. Bu yılın ilerleyen dönemlerinde uygulamanızın uzantı formlarına Play Console'da 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.
Android Automotive OS'i hedefleyen veya Android Automotive OS'i hedefleyen APK'larla paket halinde sunulan uygulamalar

Neden daha 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ı, kullanıcıların bu iyileştirmelerden yararlanabilmesini sağlarken uygulamanız eski Android sürümlerinde çalışmaya devam edebilir. Yeni bir API seviyesini hedeflemek, uygulamanızın platformun en son özelliklerinden yararlanmasına da olanak tanır. Bu sayede kullanıcılarınızı memnun edebilirsiniz. Ayrıca, Android 10'dan (API düzeyi 29) itibaren bir 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 koşulunu karşılamak üzere hedef API düzeyinizi güncellerken bilmeniz gereken önemli noktalar vurgulanmaktadır. Taşıma işlemini 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çme

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

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

Güvenlik ve İzinler

Bluetooth: BLUETOOTH ve BLUETOOTH_ADMIN izinlerini BLUETOOTH_SCAN, BLUETOOTH_ADVERTISE veya BLUETOOTH_CONNECT izinleriyle değiştirmeniz gerekir. Bluetooth işlemleri için artık LOCATION çalışma zamanında izin isteğinde bulunmanıza gerek yoktur.
Konum: Kullanıcılar, uygulamalardan yalnızca yaklaşık konum bilgilerini almasını isteyebilir. ACCESS_FINE_LOCATION isteğinde bulunduğunuzda her zaman ACCESS_COARSE_LOCATION iznini istemeniz gerekir.
- Amaç filtreleri: Uygulamanız amaç filtreleri kullanan etkinlikler, hizmetler veya yayın alıcıları içeriyorsa bu bileşenler için android:exported özelliğini açıkça beyan etmeniz gerekir.
Hazırda bekleme: Uygulamalar uzun bir süre boyunca kullanılmazsa hazırda bekleme moduna alınabilir. Hazırda bekleme modunda uygulamanızın çalışma zamanı izinleri ve önbelleği sıfırlanır, iş veya uyarı çalıştıramazsınız. Uygulamanızın hazırda bekleme durumunu kontrol edebilirsiniz.
Beklemedeki amaç 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ümlerine sahip bildirimler, artık bildirim alanının tamamını kullanmaz. Bunun yerine sistem, standart bir şablon uygular. Bu şablon, özel bildirimlerin tüm durumlarda diğer bildirimlerle aynı dekorasyona 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 Link 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 bir ön plan hizmeti başlatmaya çalışırsa istisna oluşur (birkaç özel durum hariç).

Uygulamanız arka planda çalışırken hızlı çalışma planlamak ve başlatmak için WorkManager'ı kullanabilirsiniz. Kullanıcının istediği zaman açısından hassas işlemleri tamamlamak için ön plan hizmetlerini tam bir 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şeni başlatarak yanıt verir. Bu uygulama bileşeni, bildirim trambolini olarak bilinir.

Uygulamalar, bildirim trambolinleri 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ı içinde startActivity() öğesini arayamaz.

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 bir sürümden veri taşıma

Taşıma yapacağınız Android sürümünü seçin:

Android 5'e (API düzeyi 21) taşıma

Uygulamanızın bu sürümlerde yapılan değişiklikleri hesaba kattığı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) taşıma

Aşağıdaki noktalar, platformun Android 6.0 ve sonraki 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 etmesi için başka bir yol bulunduğ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) taşıma

Aşağıdaki noktalar, platformun Android 7.0 ve sonraki 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 Bekletme 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 FileUriExposedException tetikler. Uygulamanızın dışında dosya paylaşmanız gerekiyorsa FileProvider kodunu 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) taşıma

Aşağıdaki noktalar, platformun Android 8.0 ve sonraki 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() yasaklanmış olduğu halde bir uygulama tarafından çağrılmaya çalışıldığında startService() artık istisna oluşturuyor.
  - Ön plan hizmetlerini başlatmak için bir uygulamanın startForeground() ve startForegroundService() kullanmaları gerekir.
  - Android 8.0 (API düzeyi 26) Davranış Değişiklikleri sayfasında açıklandığı gibi, JobScheduler API'sinde yapılan değişiklikleri dikkatlice inceleyin.
  - Firebase Cloud Messaging, Google Play Hizmetleri SDK'sının 10.2.1 veya daha sonraki bir sürümünü gerektirir.
  - Firebase Cloud Messaging kullanıldığında, mesaj teslimi arka plan yürütme sınırlarına tabidir. Mesaj alındığında arka plan çalışması gerektiğinde (arka plan veri senkronizasyonu gerçekleştirmek gibi) uygulamanız işleri Firebase Job Dispatcher veya JobIntentService kullanarak 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'sinin dokümanlarına bakın.
- Arka Planda Konum Sınırları
  - Arka planda çalışan uygulamalar konum verilerine sınırlı erişime sahiptir.
    - Google Play Hizmetleri olan cihazlarda, düzenli konum güncellemeleri almak için çok kaynaklı konum sağlayıcısını kullanın.
Bildirim Kanalları
- Bildirim kesintisi özelliklerini her kanal için ayrı ayrı tanımlamanız gerekir.
- Bildirimlerin görünmesi için bir kanala bildirim atamalısınız.
- Platformun bu sürümü NotificationCompat.Builder platformunu destekliyor.
Gizlilik
- ANDROID_ID her uygulama imzalama anahtarı için belirlenir.

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) geçiş

Güç Yönetimi
- Uygulama Bekleme paketleri; ertelenen 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 uygulamayı bekleme uygulamalarındaki sınırlamaları artırır
Ön plan hizmeti izni
- FOREGROUND_SERVICE normal izninin (çalışma zamanında istenen izin değil) istenmesi gerekir
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 bilgilere erişim kısıtlı

Android 9.0'da (API seviyesi 28) kullanıma sunulan 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ş

Tam ekran intent içeren bildirimler
- Normal iznin USE_FULL_SCREEN_INTENT istenmesi gerekir (çalışma zamanında istenen izin değil).
Katlanabilir cihazlar ve büyük ekranlı cihazlar için destek
- Artık birden çok etkinlik aynı anda "devam ettirildi" durumunda olabilir ancak gerçekten yalnızca birine odaklanılmıştır.
  - Bu değişiklik onResume() ve onPause() davranışını etkiler.
  - "En üstte devam ettirilen" yeni yaşam döngüsü kavramı, onTopResumedActivityChanged() abonesi olarak algılanabilir.
    - Yalnızca bir etkinlik "en üstte devam ettirilebilir".
- resizeableActivity, false olarak ayarlandığında uygulamalar ayrıca bir minAspectRatio belirtebilir. Bu özellik, uygulamaya daha dar en boy oranlarında otomatik olarak sinemaskop efekti ekler.
Gizlilikle ilgili değişiklikler
- Kapsamlı depolama
  - Harici depolama erişimi yalnızca uygulamaya özel bir dizinle ve uygulamanın oluşturduğu belirli medya türleriyle sınırlıdır.
- Uygulama arka plandayken konuma erişim kısıtlıdır. ACCESS_BACKGROUND_LOCATION izni gerekir.
- IMEI ve seri numarası gibi sıfırlanamayan tanımlayıcılara erişim kısıtlandı.
- Kullanıcının adım sayısı gibi fiziksel aktivite bilgilerine erişimin kısıtlı olması. ACTIVITY_RECOGNITION izni verilmesi gerekir.
- Bazı telefon, Bluetooth ve kablosuz ağ API'lerine erişim kısıtlanarak ACCESS_FINE_LOCATION izni gerekecek.
- Kablosuz ağ ayarlarına erişim kısıtlı
  - Uygulamalar artık kablosuz bağlantıyı doğrudan etkinleştiremez veya devre dışı bırakamaz ve bunu ayar panellerini kullanarak yapmaları gerekir.
  - WifiNetworkSpecifier veya WifiNetworkSuggestion kullanılması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) geçiş

Gizlilik
- Kapsamlı depolama alanı yaptırımı : Uygulamalar; uygulamaya özgü, medya ve diğer dosya türlerinin kaydedildiği ve özel konumlar kullanılarak erişildiği, kapsamlı depolama modelini benimsemelidir.
- İzinleri otomatik sıfırlama: Kullanıcılar birkaç aydır bir uygulamayla etkileşimde bulunmadıysa sistem, uygulamanın hassas izinlerini otomatik olarak sıfırlar. Bu durum çoğu uygulamayı etkilemez. 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 konuma erişim izni verme işlemi, çalışma zamanında istenen izin iletişim kutuları yerine yalnızca uygulama ayarlarından yapılabilir.
- Paket Görünürlüğü: Bir uygulama, cihazda yüklü uygulama 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 gereklidir. Geriye dönük uyumluluk nedeniyle geliştiriciler de APK İmza Şeması v1 ile imzalamaya devam etmelidir.
- SDK dışı arayüz kısıtlaması. API düzeyi 30'u hedefleyen uygulamalarda SDK dışı arayüzlerin kullanılması önerilmez. Bunun nedeni, bu SDK dışı arayüzlerin bazılarının artık engellenmesidir. Engellenen SDK olmayan arayüzlerin kapsamlı listesi için Android 11'de artık engellenen SDK olmayan arayüzler bölümüne bakın.

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ü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.

Kameradan en iyi şekilde yararlanmak için Beta sürümündeki KameraX'i kullanmayı düşünün.
En iyi uygulamaları takip etmenize yardımcı olması, sizi ortak kod yazma zorunluluğundan kurtaracak ve karmaşık görevleri basitleştirerek sizin için önemli olan koda odaklanmanıza yardımcı olacak Jetpack bileşenlerini kullanın.
Daha az kodla daha hızlı 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) yeni 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, mevcut ekran alanını dolduracak şekilde yeniden boyutlandırıldığından 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 Beyanı bölümüne bakın.
- Uygulamanızın verimliliği artırmasına ve birden fazla ekranı yönetmesine yardımcı olmak için çoklu pencere desteği ekleyin.
- Küçültülmüş harika bir uygulama deneyimi kullanıcı deneyimini iyileştirecekse Pencere İçinde Pencere desteği 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 kullanın. Daha fazla bilgi için droidcon NYC 2017 videosunu izleyin.
  - Uygulamanın tüm pencereyi kapladığını varsaymayın. Bunun yerine, View.getLocationOnScreen() yerine View.getLocationInWindow() kullanarak konumun konumunu onaylayın. * MotionEvent ile çalışırken MotionEvent.getRawX() yerine MotionEvent.getX() ve MotionEvent.getY() kullanın, MotionEvent.getRawY().

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ınlarken bazıları ek inceleme 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 politikasının ö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ı bölümüne bakın.

Ayrıca, kullandığınız 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ünden daha 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 tam kapsamlı değildir ancak test sürecinize rehberlik etmeyi amaçlar. 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 yönelik bir strateji uyguluyor. 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ı 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ı doğru bir şekilde işlediğinden (diğer bir deyişle, JobScheduler işlerine taşındı) kontrol edin.
- Bu etkinliklere bağlı olan kritik kullanım alanlarının hâlâ çalıştığından emin olun.
Diğer uygulamalarla dosya paylaşma işleyicisi - Başka bir uygulamayla (aynı geliştiricinin başka bir uygulamasıyla) dosya verisi paylaşan kullanım alanlarını test edin
- İçeriğin diğer uygulamada görünür olup olmadığını ve kilitlenmeleri tetiklemediğini test edin.

Daha fazla bilgi

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