Davranış değişiklikleri: Android 15 veya sonraki sürümleri hedefleyen uygulamalar

Önceki sürümlerde olduğu gibi Android 15'te de uygulamanızı etkileyebilecek davranış değişiklikleri yer alıyor. Aşağıdaki davranış değişiklikleri yalnızca Android 15 veya sonraki sürümleri hedefleyen uygulamalar için geçerlidir. Uygulamanız Android 15 veya sonraki sürümleri hedefliyorsa geçerli olduğu durumlarda uygulamanızı bu davranışları düzgün şekilde destekleyecek şekilde değiştirmeniz gerekir.

Uygulamanızın targetSdkVersion sürümünden bağımsız olarak Android 15'te çalışan tüm uygulamaları etkileyen davranış değişiklikleri listesini de incelemeyi unutmayın.

Temel işlevler

Android 15, Android sisteminin çeşitli temel özelliklerini değiştirir veya genişletir.

Ön plan hizmetlerinde yapılan değişiklikler

Android 15 ile ön plan hizmetlerinde aşağıdaki değişiklikleri yapıyoruz.

• Veri senkronizasyonu ön plan hizmeti zaman aşımı davranışı
• Yeni medya işleme ön plan hizmet türü
• Ön plan hizmetlerini başlatan BOOT_COMPLETED yayın alıcıyla ilgili kısıtlamalar
• SYSTEM_ALERT_WINDOW izni bulunan bir uygulama için ön plan hizmetlerinin başlatılmasıyla ilgili kısıtlamalar

Veri senkronizasyonu ön plan hizmeti zaman aşımı davranışı

Android 15, Android 15 (API düzeyi 35) veya sonraki sürümleri hedefleyen uygulamalar için dataSync işlevine yeni bir zaman aşımı davranışı sunuyor. Bu davranış, yeni mediaProcessing ön plan hizmet türü için de geçerlidir.

Sistem, bir uygulamanın dataSync hizmetlerinin 24 saat içinde toplam 6 saat çalışmasına izin verir. Ardından sistem, çalışan hizmetin Service.onTimeout(int, int) yöntemini (Android 15'te kullanıma sunulmuştur) çağırır. Bu sırada hizmetin Service.stopSelf()'u araması için birkaç saniye süre tanınır. Service.onTimeout() çağrıldığında hizmet artık ön plan hizmeti olarak kabul edilmez. Hizmet Service.stopSelf()'ü çağırmazsa sistem dahili bir istisna oluşturur. İstisna, Logcat'e aşağıdaki mesajla kaydedilir:

Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type dataSync did not stop within its timeout: [component name]"

Bu davranış değişikliğiyle ilgili sorun yaşamamak için aşağıdakilerden birini veya daha fazlasını yapabilirsiniz:

1. Hizmetinizin yeni Service.onTimeout(int, int) yöntemini uygulamasını sağlayın. Uygulamanız geri çağırmayı aldığında birkaç saniye içinde stopSelf() yöntemini çağırdığınızdan emin olun. (Uygulamayı hemen durdurmazsanız sistem bir hata oluşturur.)
2. Uygulamanızın dataSync hizmetlerinin herhangi bir 24 saatlik süre içinde toplam 6 saatten fazla çalışmadığından emin olun (kullanıcı uygulamayla etkileşim kurmadığı ve zamanlayıcıyı sıfırladığı sürece).
3. dataSync ön plan hizmetlerini yalnızca doğrudan kullanıcı etkileşimi sonucunda başlatabilirsiniz. Hizmet başlatıldığında uygulamanız ön planda olduğu için hizmetiniz, uygulama arka plana geçtikten sonra altı saatin tamamını kullanabilir.
4. dataSync ön plan hizmeti yerine alternatif bir API kullanın.

Uygulamanızın dataSync ön plan hizmeti son 24 içinde 6 saat çalıştıysa kullanıcı uygulamanızı ön plana getirmediği sürece başka bir dataSync ön plan hizmeti başlatamazsınız (bu durumda zamanlayıcı sıfırlanır). Başka bir dataSync ön plan hizmetini başlatmaya çalışırsanız sistem, "dataSync ön plan hizmet türü için zaman sınırı zaten aşıldı" gibi bir hata mesajıyla ForegroundServiceStartNotAllowedException oluşturur.

Test

Uygulamanızın davranışını test etmek için uygulamanız Android 15'i hedeflemese bile veri senkronizasyonu zaman aşımlarını etkinleştirebilirsiniz (uygulama Android 15 cihazda çalışıyorsa). Zaman aşımlarını etkinleştirmek için aşağıdaki adb komutunu çalıştırın:

adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name

Ayrıca, sınıra ulaşıldığında uygulamanızın nasıl davrandığını test etmeyi kolaylaştırmak için zaman aşımı süresini ayarlayabilirsiniz. Yeni bir zaman aşımı süresi ayarlamak için aşağıdaki adb komutunu çalıştırın:

adb shell device_config put activity_manager data_sync_fgs_timeout_duration duration-in-milliseconds

Yeni medya işleme ön plan hizmeti türü

Android 15, mediaProcessing adlı yeni bir ön plan hizmet türü kullanıma sunar. Bu hizmet türü, medya dosyalarının kodunu dönüştürme gibi işlemler için uygundur. Örneğin, bir medya uygulaması bir ses dosyası indirebilir ve dosyayı oynatmadan önce farklı bir biçime dönüştürmesi gerekebilir. Uygulama arka plandayken bile dönüşümün devam etmesini sağlamak için bir mediaProcessing ön plan hizmeti kullanabilirsiniz.

Sistem, bir uygulamanın mediaProcessing hizmetlerinin 24 saat içinde toplam 6 saat çalışmasına izin verir. Ardından, çalışan hizmetin Service.onTimeout(int, int) yöntemini (Android 15'te kullanıma sunulmuştur) çağırır. Şu anda hizmetin Service.stopSelf() hizmetini çağırmak için birkaç saniyesi var. Hizmet Service.stopSelf()'ü çağırmazsa sistem dahili bir istisna oluşturur. İstisna aşağıdaki mesajla Logcat'e kaydedilir:

Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type mediaProcessing did not stop within its timeout: [component name]"

İstisnayı önlemek için aşağıdakilerden birini yapabilirsiniz:

1. Hizmetinizin yeni Service.onTimeout(int, int) yöntemini uygulamasını sağlayın. Uygulamanız geri aramayı aldığında birkaç saniye içinde stopSelf()'ü aradığınızdan emin olun. (Uygulamayı hemen durdurmazsanız sistem bir hata oluşturur.)
2. Uygulamanızın mediaProcessing hizmetlerinin herhangi bir 24 saatlik süre içinde toplam 6 saatten fazla çalışmadığından emin olun (kullanıcı uygulamayla etkileşim kurmadığı ve zamanlayıcıyı sıfırladığı sürece).
3. mediaProcessing ön plan hizmetlerini yalnızca doğrudan kullanıcı etkileşimi sonucunda başlatın. Hizmetiniz başladığında uygulamanız ön planda olduğundan, uygulama arka plana geçtikten sonra hizmetiniz altı saat boyunca çalışır.
4. mediaProcessing ön plan hizmeti yerine WorkManager gibi bir alternatif API kullanın.

Uygulamanızın mediaProcessing ön plan hizmetleri son 24 saat içinde 6 saat boyunca çalıştıysa kullanıcı uygulamanızı ön plana getirmediği (bu durumda zamanlayıcı sıfırlanır) sürece başka bir mediaProcessing ön plan hizmeti başlatamazsınız. Başka bir mediaProcessing ön plan hizmetini başlatmaya çalışırsanız sistem, "mediaProcessing türündeki ön plan hizmeti için zaman sınırı zaten aşıldı" gibi bir hata mesajıyla ForegroundServiceStartNotAllowedException oluşturur.

mediaProcessing hizmet türü hakkında daha fazla bilgi için Android 15 için ön plan hizmet türlerinde yapılan değişiklikler: Medya işleme başlıklı makaleyi inceleyin.

Test

Uygulamanızın davranışını test etmek için uygulamanız Android 15'i hedeflemese bile medya işleme zaman aşımlarını etkinleştirebilirsiniz (uygulama Android 15 cihazda çalışıyorsa). Zaman aşımlarını etkinleştirmek için aşağıdaki adb komutunu çalıştırın:

adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name

Ayrıca, sınıra ulaşıldığında uygulamanızın nasıl davrandığını test etmeyi kolaylaştırmak için zaman aşımı süresini ayarlayabilirsiniz. Yeni bir zaman aşımı süresi ayarlamak için aşağıdaki adb komutunu çalıştırın:

adb shell device_config put activity_manager media_processing_fgs_timeout_duration duration-in-milliseconds

Ön plan hizmetlerini başlatan BOOT_COMPLETED yayın alıcılarıyla ilgili kısıtlamalar

Yayınlanacak BOOT_COMPLETED yayın alıcıyla ilgili yeni kısıtlamalar var ön plan hizmetlerini kullanabilirsiniz. BOOT_COMPLETED alıcıların Aşağıdaki ön plan hizmeti türleri kullanılabilir:

• dataSync
• camera
• mediaPlayback
• phoneCall
• mediaProjection
• microphone (bu kısıtlama, microphone için geçerlidir. Android 14)

Bir BOOT_COMPLETED alıcısı bu tür ön planlardan herhangi birini başlatmaya çalışırsa özelliklerini sunarsa sistem ForegroundServiceStartNotAllowedException komutunu atar.

Test

Uygulamanızın davranışını test etmek için, aşağıdaki durumlarda bile bu yeni kısıtlamaları etkinleştirebilirsiniz: Uygulama Android 15'i hedeflemiyor (uygulama Android 15 yüklü olduğu sürece) cihazda) olduğunu varsayalım. Aşağıdaki adb komutunu çalıştırın:

adb shell am compat enable FGS_BOOT_COMPLETED_RESTRICTIONS your-package-name

Cihazı yeniden başlatmadan BOOT_COMPLETED yayını göndermek için: aşağıdaki adb komutunu çalıştırın:

adb shell am broadcast -a android.intent.action.BOOT_COMPLETED your-package-name

SYSTEM_ALERT_WINDOW izni bulunan bir uygulama için ön plan hizmetlerinin başlatılmasıyla ilgili kısıtlamalar

Previously, if an app held the SYSTEM_ALERT_WINDOW permission, it could launch a foreground service even if the app was currently in the background (as discussed in exemptions from background start restrictions).

If an app targets Android 15, this exemption is now narrower. The app now needs to have the SYSTEM_ALERT_WINDOW permission and also have a visible overlay window. That is, the app needs to first launch a TYPE_APPLICATION_OVERLAY window and the window needs to be visible before you start a foreground service.

If your app attempts to start a foreground service from the background without meeting these new requirements (and it does not have some other exemption), the system throws ForegroundServiceStartNotAllowedException.

If your app declares the SYSTEM_ALERT_WINDOW permission and launches foreground services from the background, it may be affected by this change. If your app gets a ForegroundServiceStartNotAllowedException, check your app's order of operations and make sure your app already has an active overlay window before it attempts to start a foreground service from the background. You can check if your overlay window is currently visible by calling View.getWindowVisibility(), or you can override View.onWindowVisibilityChanged() to get notified whenever the visibility changes.

Testing

To test your app's behavior, you can enable these new restrictions even if your app is not targeting Android 15 (as long as the app is running on an Android 15 device). To enable these new restrictions on starting foreground services from the background, run the following adb command:

adb shell am compat enable FGS_SAW_RESTRICTIONS your-package-name

Uygulamaların Rahatsız Etmeyin modunun genel durumunu ne zaman değiştirebileceğiyle ilgili değişiklikler

Android 15'i hedefleyen uygulamalar artık cihazlarda Rahatsız Etmeyin (DND) özelliğinin genel durumunu veya politikasını değiştiremez (kullanıcı ayarlarını değiştirerek veya Rahatsız Etmeyin modunu kapatarak). Bunun yerine, uygulamalar bir AutomaticZenRule katkıda bulunmalıdır. Bu da sistem, mevcut en kısıtlayıcı politika kazanç şemasıyla global bir politika haline getirir. Daha önce genel durumu (setInterruptionFilter, setNotificationPolicy) etkileyen mevcut API'lere yapılan çağrılar, söz konusu API çağrılarının çağrı döngüsüne bağlı olarak açılıp kapatılan örtülü bir AutomaticZenRule öğesinin oluşturulması veya güncellenmesiyle sonuçlanır.

Bu değişikliğin yalnızca uygulama setInterruptionFilter(INTERRUPTION_FILTER_ALL) yöntemini çağırıyorsa ve bu çağrının, sahipleri tarafından önceden etkinleştirilmiş bir AutomaticZenRule öğesini devre dışı bırakmasını bekliyorsa gözlemlenebilir davranışı etkileyeceğini unutmayın.

OpenJDK API değişiklikleri

Android 15 continues the work of refreshing Android's core libraries to align with the features in the latest OpenJDK LTS releases.

Some of these changes can affect app compatibility for apps targeting Android 15 (API level 35):

• Changes to string formatting APIs: Validation of argument index, flags, width, and precision are now more strict when using the following String.format() and Formatter.format() APIs:

  • String.format(String, Object[])
  • String.format(Locale, String, Object[])
  • Formatter.format(String, Object[])
  • Formatter.format(Locale, String, Object[])

  For example, the following exception is thrown when an argument index of 0 is used (%0 in the format string):

  IllegalFormatArgumentIndexException: Illegal format argument index = 0
  

  In this case, the issue can be fixed by using an argument index of 1 (%1 in the format string).

• Changes to component type of Arrays.asList(...).toArray(): When using Arrays.asList(...).toArray(), the component type of the resulting array is now an Object—not the type of the underlying array's elements. So the following code throws a ClassCastException:

  String[] elements = (String[]) Arrays.asList("one", "two").toArray();
  

  For this case, to preserve String as the component type in the resulting array, you could use Collection.toArray(Object[]) instead:

  String[] elements = Arrays.asList("two", "one").toArray(new String[0]);
  

• Changes to language code handling: When using the Locale API, language codes for Hebrew, Yiddish, and Indonesian are no longer converted to their obsolete forms (Hebrew: iw, Yiddish: ji, and Indonesian: in). When specifying the language code for one of these locales, use the codes from ISO 639-1 instead (Hebrew: he, Yiddish: yi, and Indonesian: id).

• Changes to random int sequences: Following the changes made in https://bugs.openjdk.org/browse/JDK-8301574, the following Random.ints() methods now return a different sequence of numbers than the Random.nextInt() methods do:

  • Random.ints(long)
  • Random.ints(long, int, int)
  • Random.ints(int, int)
  • Random.ints()

  Generally, this change shouldn't result in app-breaking behavior, but your code shouldn't expect the sequence generated from Random.ints() methods to match Random.nextInt().

The new SequencedCollection API can affect your app's compatibility after you update compileSdk in your app's build configuration to use Android 15 (API level 35):

• Collision with MutableList.removeFirst() and MutableList.removeLast() extension functions in kotlin-stdlib

  The List type in Java is mapped to the MutableList type in Kotlin. Because the List.removeFirst() and List.removeLast() APIs have been introduced in Android 15 (API level 35), the Kotlin compiler resolves function calls, for example list.removeFirst(), statically to the new List APIs instead of to the extension functions in kotlin-stdlib.

  If an app is re-compiled with compileSdk set to 35 and minSdk set to 34 or lower, and then the app is run on Android 14 and lower, a runtime error is thrown:

  java.lang.NoSuchMethodError: No virtual method
  removeFirst()Ljava/lang/Object; in class Ljava/util/ArrayList;
  

  The existing NewApi lint option in Android Gradle Plugin can catch these new API usages.

  ./gradlew lint
  
  MainActivity.kt:41: Error: Call requires API level 35 (current min is 34): java.util.List#removeFirst [NewApi]
        list.removeFirst()
  

  To fix the runtime exception and lint errors, the removeFirst() and removeLast() function calls can be replaced with removeAt(0) and removeAt(list.lastIndex) respectively in Kotlin. If you're using Android Studio Ladybug | 2024.1.3 or higher, it also provides a quick fix option for these errors.

  Consider removing @SuppressLint("NewApi") and lintOptions { disable 'NewApi' } if the lint option has been disabled.

• Collision with other methods in Java

  New methods have been added into the existing types, for example, List and Deque. These new methods might not be compatible with the methods with the same name and argument types in other interfaces and classes. In the case of a method signature collision with incompatibility, the javac compiler outputs a build-time error. For example:

  Example error 1:

  javac MyList.java
  
  MyList.java:135: error: removeLast() in MyList cannot implement removeLast() in List
    public void removeLast() {
                ^
    return type void is not compatible with Object
    where E is a type-variable:
      E extends Object declared in interface List
  

  Example error 2:

  javac MyList.java
  
  MyList.java:7: error: types Deque<Object> and List<Object> are incompatible;
  public class MyList implements  List<Object>, Deque<Object> {
    both define reversed(), but with unrelated return types
  1 error
  

  Example error 3:

  javac MyList.java
  
  MyList.java:43: error: types List<E#1> and MyInterface<E#2> are incompatible;
  public static class MyList implements List<Object>, MyInterface<Object> {
    class MyList inherits unrelated defaults for getFirst() from types List and MyInterface
    where E#1,E#2 are type-variables:
      E#1 extends Object declared in interface List
      E#2 extends Object declared in interface MyInterface
  1 error
  

  To fix these build errors, the class implementing these interfaces should override the method with a compatible return type. For example:

  @Override
  public Object getFirst() {
      return List.super.getFirst();
  }
  

Güvenlik

Android 15, uygulamaları ve kullanıcıları kötü amaçlı uygulamalardan korumaya yardımcı olmak için sistem güvenliğini destekleyen değişiklikler içerir.

Güvenli arka plan etkinliği lansmanları

Android 15, kullanıcıları kötü amaçlı uygulamalardan korur ve üzerinde daha fazla kontrol imkanı sunar. kötü amaçlı arka plan uygulamalarının çalışmasını engelleyen değişiklikler ekleyerek diğer uygulamaları ön plana alarak, ayrıcalıklarının yükseltilmesine ve kötü amaçlı kullanıcı etkileşimi. Arka plan etkinliği lansmanları şu tarihten beri kısıtlanmıştır: Android 10 (API düzeyi 29).

Yığındaki en iyi UID ile eşleşmeyen uygulamaların etkinlik başlatmasını engelle

Kötü amaçlı uygulamalar aynı görev içinde başka bir uygulamanın etkinliğini başlatabilir ve ardından Böylece uygulama olduğu izlenimi yaratıyor. Bu "görev hesabı ele geçirme" mevcut arka plan başlatma kısıtlamalarını atlar çünkü aynı görev içinde gerçekleşir. Android 15, bu riski azaltmak için Yığındaki en iyi UID ile eşleşmeyen uygulamaların başlatılmasını engelleyen işaret yardımcı olur. Uygulamanızdaki tüm etkinlikleri etkinleştirmek için allowCrossUidActivitySwitchFromBelow özelliği ekleyin:AndroidManifest.xml

<application android:allowCrossUidActivitySwitchFromBelow="false" >

Aşağıdaki koşulların tamamı geçerliyse yeni güvenlik önlemleri etkindir:

• Lansmanı gerçekleştiren uygulama Android 15'i hedefliyor.
• Görev yığınının en üstündeki uygulama Android 15'i hedefliyor.
• Görünen tüm etkinlikler yeni korumaları etkinleştirmiştir.

Güvenlik önlemleri etkinleştirilirse uygulamalar, görünür hale getirebilirsiniz.

Diğer değişiklikler

UID eşleşmesi kısıtlamasına ek olarak, bu diğer değişiklikler de dahil:

• PendingIntent içerik üreticiyi, şu tarihe kadar arka planda etkinlik başlatmaları engelleyecek şekilde değiştirin: varsayılan. Bu, uygulamaların kötü niyetli kişiler tarafından kötüye kullanılabilecek bir PendingIntent oluşturmasını önler.
• PendingIntent adlı göndereni göndermediği sürece uygulamayı ön plana taşıma izin veriyor. Bu değişikliğin amacı, kötü amaçlı uygulamaların arka planda etkinlik başlatma becerisi. Uygulamalar varsayılan olarak oluşturan kullanıcı izin vermediği sürece görev yığınını ön plana taşımasına izin verilir arka planda etkinlik başlatma ayrıcalıkları veya gönderenin arka planda etkinliği olması başlatma ayrıcalıkları.
• Bir görev yığınının en üst etkinliğinin, görevini nasıl tamamlayabileceğini kontrol edin. Öğe bir görevi tamamladığında, Android o göreve geri döner son etkin olma zamanı. Ayrıca, en üstte olmayan bir etkinlik görevini tamamlarsa Android, ana ekrana geri dön; bu üst olmayan bu bölümün bitişini etkinliği'ne dokunun.
• Diğer uygulamalardan kendi görevinize rastgele etkinliklerin başlatılmasını engelleyin. Bu değişiklik, kötü amaçlı uygulamaların kullanıcıları kimlik avına karşı korumak için diğer uygulamalardan geliyormuş gibi görünen etkinlikler.
• Görünmeyen pencerelerin arka plan etkinliği için değerlendirilmesini engelle lansmanlar. Bu, kötü amaçlı uygulamaların arka planı kötüye kullanmasını önlemeye yardımcı olur kullanıcılara istenmeyen veya kötü amaçlı içeriklerin gösterilmesi için etkinlik başlatma.

Daha güvenli niyetler

Android 15 introduces new optional security measures to make intents safer and more robust. These changes are aimed at preventing potential vulnerabilities and misuse of intents that can be exploited by malicious apps. There are two main improvements to the security of intents in Android 15:

• Match target intent-filters: Intents that target specific components must accurately match the target's intent-filter specifications. If you send an intent to launch another app's activity, the target intent component needs to align with the receiving activity's declared intent-filters.
• Intents must have actions: Intents without an action will no longer match any intent-filters. This means that intents used to start activities or services must have a clearly defined action.

In order to check how your app responds to these changes, use StrictMode in your app. To see detailed logs about Intent usage violations, add the following method:

fun onCreate() {
    StrictMode.setVmPolicy(VmPolicy.Builder()
        .detectUnsafeIntentLaunch()
        .build()
    )
}

public void onCreate() {
    StrictMode.setVmPolicy(new VmPolicy.Builder()
            .detectUnsafeIntentLaunch()
            .build());
}

Kullanıcı deneyimi ve sistem kullanıcı arayüzü

Android 15, daha tutarlı ve sezgisel bir kullanıcı deneyimi sunmayı amaçlayan bazı değişiklikler içerir.

Pencere içe yerleştirilmesi değişiklikleri

Android 15'te pencere ekleriyle ilgili iki değişiklik vardır: Varsayılan olarak uçtan uca zorunlu kılınır. Ayrıca, sistem çubuklarının varsayılan yapılandırması gibi yapılandırma değişiklikleri de bulunur.

Uçtan uca yaptırım

Apps are edge-to-edge by default on devices running Android 15 if the app is targeting Android 15 (API level 35).

This is a breaking change that might negatively impact your app's UI. The changes affect the following UI areas:

• Gesture handle navigation bar
  • Transparent by default.
  • Bottom offset is disabled so content draws behind the system navigation bar unless insets are applied.
  • setNavigationBarColor and R.attr#navigationBarColor are deprecated and don't affect gesture navigation.
  • setNavigationBarContrastEnforced and R.attr#navigationBarContrastEnforced continue to have no effect on gesture navigation.
• 3-button navigation
  • Opacity set to 80% by default, with color possibly matching the window background.
  • Bottom offset disabled so content draws behind the system navigation bar unless insets are applied.
  • setNavigationBarColor and R.attr#navigationBarColor are set to match the window background by default. The window background must be a color drawable for this default to apply. This API is deprecated but continues to affect 3-button navigation.
  • setNavigationBarContrastEnforced and R.attr#navigationBarContrastEnforced is true by default, which adds an 80% opaque background across 3-button navigation.
• Status bar
  • Transparent by default.
  • The top offset is disabled so content draws behind the status bar unless insets are applied.
  • setStatusBarColor and R.attr#statusBarColor are deprecated and have no effect on Android 15.
  • setStatusBarContrastEnforced and R.attr#statusBarContrastEnforced are deprecated but still have an effect on Android 15.
• Display cutout
  • layoutInDisplayCutoutMode of non-floating windows must be LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS. SHORT_EDGES, NEVER, and DEFAULT are interpreted as ALWAYS so that users don't see a black bar caused by the display cutout and appear edge-to-edge.

The following example shows an app before and after targeting Android 15 (API level 35), and before and after applying insets.

What to check if your app is already edge-to-edge

If your app is already edge-to-edge and applies insets, you are mostly unimpacted, except in the following scenarios. However, even if you think you aren't impacted, we recommend you test your app.

• You have a non-floating window, such as an Activity that uses SHORT_EDGES, NEVER or DEFAULT instead of LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS. If your app crashes on launch, this might be due to your splashscreen. You can either upgrade the core splashscreen dependency to 1.2.0-alpha01 or later or set window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always.
• There might be lower-traffic screens with occluded UI. Verify these less-visited screens don't have occluded UI. Lower-traffic screens include:
  • Onboarding or sign-in screens
  • Settings pages

What to check if your app is not already edge-to-edge

If your app is not already edge-to-edge, you are most likely impacted. In addition to the scenarios for apps that are already edge-to-edge, you should consider the following:

• If your app uses Material 3 Components ( androidx.compose.material3) in compose, such as TopAppBar, BottomAppBar, and NavigationBar, these components are likely not impacted because they automatically handle insets.
• If your app is using Material 2 Components ( androidx.compose.material) in Compose, these components don't automatically handle insets. However, you can get access to the insets and apply them manually. In androidx.compose.material 1.6.0 and later, use the windowInsets parameter to apply the insets manually for BottomAppBar, TopAppBar, BottomNavigation, and NavigationRail. Likewise, use the contentWindowInsets parameter for Scaffold.
• If your app uses views and Material Components (com.google.android.material), most views-based Material Components such as BottomNavigationView, BottomAppBar, NavigationRailView, or NavigationView, handle insets and require no additional work. However, you need to add android:fitsSystemWindows="true" if using AppBarLayout.
• For custom composables, apply the insets manually as padding. If your content is within a Scaffold, you can consume insets using the Scaffold padding values. Otherwise, apply padding using one of the WindowInsets.
• If your app is using views and BottomSheet, SideSheet or custom containers, apply padding using ViewCompat.setOnApplyWindowInsetsListener. For RecyclerView, apply padding using this listener and also add clipToPadding="false".

What to check if your app must offer custom background protection

If your app must offer custom background protection to 3-button navigation or the status bar, your app should place a composable or view behind the system bar using WindowInsets.Type#tappableElement() to get the 3-button navigation bar height or WindowInsets.Type#statusBars.

Additional edge-to-edge resources

See the Edge to Edge Views and Edge to Edge Compose guides for additional considerations on applying insets.

Deprecated APIs

The following APIs are deprecated but not disabled:

• R.attr#enforceStatusBarContrast
• R.attr#navigationBarColor (for 3 button navigation, with 80% alpha)
• Window#isStatusBarContrastEnforced
• Window#setNavigationBarColor (for 3 button navigation, with 80% alpha)
• Window#setStatusBarContrastEnforced

The following APIs are deprecated and disabled:

• R.attr#navigationBarColor (for gesture navigation)
• R.attr#navigationBarDividerColor
• R.attr#statusBarColor
• Window#setDecorFitsSystemWindows
• Window#getNavigationBarColor
• Window#getNavigationBarDividerColor
• Window#getStatusBarColor
• Window#setNavigationBarColor (for gesture navigation)
• Window#setNavigationBarDividerColor
• Window#setStatusBarColor

Kararlı yapılandırma

If your app targets Android 15 (API level 35) or higher, Configuration no longer excludes the system bars. If you use the screen size in the Configuration class for layout calculation, you should replace it with better alternatives like an appropriate ViewGroup, WindowInsets, or WindowMetricsCalculator depending on your need.

Configuration has been available since API 1. It is typically obtained from Activity.onConfigurationChanged. It provides information like window density, orientation, and sizes. One important characteristic about the window sizes returned from Configuration is that it previously excluded the system bars.

The configuration size is typically used for resource selection, such as /res/layout-h500dp, and this is still a valid use case. However, using it for layout calculation has always been discouraged. If you do so, you should move away from it now. You should replace the use of Configuration with something more suitable depending on your use case.

If you use it to calculate the layout, use an appropriate ViewGroup, such as CoordinatorLayout or ConstraintLayout. If you use it to determine the height of the system navbar, use WindowInsets. If you want to know the current size of your app window, use computeCurrentWindowMetrics.

The following list describes the fields affected by this change:

• Configuration.screenWidthDp and screenHeightDp sizes no longer exclude the system bars.
• Configuration.smallestScreenWidthDp is indirectly affected by changes to screenWidthDp and screenHeightDp.
• Configuration.orientation is indirectly affected by changes to screenWidthDp and screenHeightDp on close-to-square devices.
• Display.getSize(Point) is indirectly affected by the changes in Configuration. This was deprecated beginning in API level 30.
• Display.getMetrics() has already worked like this since API level 33.

elegantTextHeight özelliği varsayılan olarak true değerini alır

Android 15'i hedefleyen uygulamalarda elegantTextHeight TextView özelliği varsayılan olarak true haline gelir. Varsayılan olarak kullanılan kompakt yazı tipi, büyük dikey metriklere sahip bazı komut dosyalarıyla değiştirilir. Bu yazı tipi çok daha okunabilir bir yazı tipiyle değiştirilir. Kompakt yazı tipi, düzenlerin bozulmasını önlemek için kullanıma sunulmuştur. Android 13 (API düzeyi 33), fallbackLineSpacing özelliğini kullanarak metin düzeninin dikey yüksekliği genişletmesine izin vererek bu bozuklukların çoğunun önüne geçer.

Android 15'te, kompakt yazı tipi sistemde kalmaya devam eder. Böylece uygulamanız, öncekiyle aynı davranışı elde etmek için elegantTextHeight değerini false olarak ayarlayabilir, ancak gelecekteki sürümlerde desteklenme olasılığı düşüktür. Bu nedenle, uygulamanız Arapça, Laoca, Myanmar, Tamilce, Guceratça, Kannada, Malayalam, Oriya, Telugu ve Tayca komutlarını destekliyorsa elegantTextHeight değerini true olarak ayarlayarak uygulamanızı test edin.

Karmaşık harf şekilleri için TextView genişliği değişiyor

Android'in önceki sürümlerinde, karmaşık şekillendirmeye sahip bazı el yazısı yazı tipleri veya diller, harfleri önceki veya sonraki karakterin alanında çizebilir. Bazı durumlarda bu tür harfler başlangıç veya bitiş konumunda kesilmiştir. Android 15'ten itibaren TextView, bu tür harflerin çizilmesi için yeterli alan ayıran bir genişlik atar ve uygulamaların kırpmayı önlemek için sola ek dolgu istemesine olanak tanır.

Bu değişiklik, TextView öğesinin genişliği belirleme şeklini etkilediği için uygulama Android 15 (API düzeyi 35) veya sonraki sürümleri hedefliyorsa TextView varsayılan olarak daha fazla genişlik ayırır. Bu davranışı TextView üzerinde setUseBoundsForWidth API'yi çağırarak etkinleştirebilir veya devre dışı bırakabilirsiniz.

Sol dolgu eklemek mevcut düzenlerde hizalama sorunlarına neden olabileceğinden, Android 15 veya sonraki sürümleri hedefleyen uygulamalarda bile dolgu varsayılan olarak eklenmez. Ancak setShiftDrawingOffsetForStartOverhang işlevini çağırarak kırpmayı önlemek için ek dolgu ekleyebilirsiniz.

Aşağıdaki örneklerde, bu değişikliklerin bazı yazı tipleri ve diller için metin düzenini nasıl iyileştirebileceği gösterilmektedir.

Eğik yazı tipi kullanılarak yazılmış İngilizce metinler için standart düzen. Bazı harfler kesilmiş. İlgili XML şu şekildedir:

<TextView
    android:fontFamily="cursive"
    android:text="java" />

Ek genişlik ve dolgu içeren aynı İngilizce metnin düzeni. İlgili XML şu şekildedir:

<TextView
    android:fontFamily="cursive"
    android:text="java"
    android:useBoundsForWidth="true"
    android:shiftDrawingOffsetForStartOverhang="true" />

Tay dili metinleri için standart düzen. Harflerden bazıları kesilmiş. İlgili XML:

<TextView
    android:text="คอมพิวเตอร์" />

Ek genişlik ve dolgu içeren aynı Tayca metnin düzeni. İlgili XML şu şekildedir:

<TextView
    android:text="คอมพิวเตอร์"
    android:useBoundsForWidth="true"
    android:shiftDrawingOffsetForStartOverhang="true" />

EditText için yerel ayara duyarlı varsayılan satır yüksekliği

Android'in önceki sürümlerinde metin düzeni, metnin yüksekliğini mevcut yerel ayarla eşleşen yazı tipinin satır yüksekliğini karşılayacak şekilde genişletiyordu. Örneğin, içerik Japoncaysa, Japonca yazı tipinin satır yüksekliği Latin yazı tipinden biraz daha büyük olduğu için metnin yüksekliği biraz daha büyük olur. Ancak, satır yüksekliklerindeki bu farklılıklara rağmen, aşağıdaki resimde gösterildiği gibi EditText öğesi, kullanılan yerel ayardan bağımsız olarak eşit şekilde boyutlandırıldı:

Android 15'i hedefleyen uygulamalarda, aşağıdaki resimde gösterildiği gibi, belirtilen Yerel Ayarın referans yazı tipiyle eşleşmesi için EditText için minimum satır yüksekliği ayrılmıştır:

Gerekirse uygulamanız useLocalePreferredLineHeightForMinimum özelliğini false için belirterek önceki davranışı geri yükleyebilir. Ayrıca uygulamanız, Kotlin ve Java'da setMinimumFontMetrics API'yi kullanarak özel minimum sektör metrikleri ayarlayabilir.

Kamera ve medya içerikleri

Android 15, Android 15 veya sonraki sürümleri hedefleyen uygulamalarda kamera ve medya davranışında aşağıdaki değişiklikleri yapar.

Ses odağını istemeyle ilgili kısıtlamalar

Ses odağı isteğinde bulunabilmek için Android 15'i hedefleyen uygulamaların en iyi uygulama olması veya bir ön plan hizmeti çalıştırması gerekir. Bir uygulama bu şartlardan birini karşılamadığında odaklanma isteğinde bulunmaya çalışırsa çağrı AUDIOFOCUS_REQUEST_FAILED değerini döndürür.

Ses odağı hakkında daha fazla bilgi edinmek için Ses odağını yönetme başlıklı makaleye göz atabilirsiniz.

SDK dışı kısıtlamalar güncellendi

Android 15, Android geliştiricilerle yapılan ortak çalışmalara ve en son şirket içi testlere dayalı olarak kısıtlanmış SDK dışı arayüzlerin güncellenmiş listelerini içerir. Mümkün olduğunda SDK dışı arayüzleri kısıtlamadan önce herkese açık alternatiflerin kullanılabildiğinden emin oluruz.

Uygulamanız Android 15'i hedeflemiyorsa bu değişikliklerden bazıları sizi hemen etkilemeyebilir. Bununla birlikte, uygulamanızın hedef API düzeyine bağlı olarak uygulamanızın bazı SDK olmayan arayüzlere erişmesi mümkün olsa da SDK olmayan herhangi bir yöntem veya alan kullanmak her zaman uygulamanızın bozulma riski taşır.

Uygulamanızın SDK dışı arayüz kullanıp kullanmadığından emin değilseniz bunu öğrenmek için uygulamanızı test edebilirsiniz. Uygulamanız SDK dışı arayüzlere dayanıyorsa SDK alternatiflerine geçiş planlamaya başlamanız gerekir. Bununla birlikte, bazı uygulamaların SDK dışı arayüzleri kullanmanın geçerli kullanım alanları olduğunu biliyoruz. Uygulamanızdaki bir özellik için SDK dışında bir arayüz kullanmanın alternatifini bulamıyorsanız yeni bir herkese açık API isteğinde bulunmanız gerekir.

Android'in bu sürümündeki değişiklikler hakkında daha fazla bilgi edinmek için Android 15'teki SDK dışı arayüz kısıtlamalarında yapılan güncellemeler başlıklı makaleyi inceleyin. Genel olarak SDK olmayan arayüzler hakkında daha fazla bilgi edinmek için SDK olmayan arayüzlerde kısıtlamalar başlıklı makaleyi inceleyin.