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

Android 15, önceki sürümlerde olduğu gibi uygulamanızı etkileyebilecek davranış değişiklikleri içerir. 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 uygulamanızı, geçerli olduğu durumlarda bu davranışları düzgün şekilde destekleyecek şekilde değiştirmeniz gerekir.

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

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

Android 15, Android 15'i (API düzeyi 35) veya sonraki sürümleri hedefleyen uygulamalar için dataSync'te yeni bir zaman aşımı davranışı sunar. 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 sorunları önlemek 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 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 dataSync hizmetlerinin, 24 saatlik herhangi bir dönemde toplam 6 saatten fazla çalışmadığından emin olun (kullanıcı uygulamayla etkileşime geçerek zamanlayıcıyı sıfırlamazsa).
  3. dataSync ö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. 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 hizmeti başlatan BOOT_COMPLETED yayın alıcılarıyla ilgili kısıtlamalar

在启动 BOOT_COMPLETED 广播接收器方面存在新限制 前台服务。BOOT_COMPLETED 接收器不能启动 以下类型的前台服务：

如果 BOOT_COMPLETED 接收器尝试启动任何上述类型的前台 服务，系统会抛出 ForegroundServiceStartNotAllowedException。

测试

如需测试应用的行为，您可以启用这些新限制，即使您的应用并未以 Android 15 为目标平台（只要应用在 Android 15 设备上运行）也是如此。运行以下 adb 命令：

adb shell am compat enable FGS_BOOT_COMPLETED_RESTRICTIONS your-package-name

如需在不重启设备的情况下发送 BOOT_COMPLETED 广播，请运行以下 adb 命令：

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

Bir uygulama SYSTEM_ALERT_WINDOW iznine sahipken ön plan hizmetlerini başlatmayla ilgili kısıtlamalar

以前，如果应用拥有 SYSTEM_ALERT_WINDOW 权限，即使应用当前在后台运行，也可以启动前台服务（如免于后台启动限制中所述）。

如果应用以 Android 15 为目标平台，则此豁免范围现在更窄。现在，应用需要具有 SYSTEM_ALERT_WINDOW 权限，并且还需要有一个可见的叠加窗口。也就是说，应用需要先启动 TYPE_APPLICATION_OVERLAY 窗口，并且该窗口需要处于可见状态，然后您才能启动前台服务。

如果您的应用尝试从后台启动前台服务，但不符合这些新要求（并且没有其他豁免情况），系统会抛出 ForegroundServiceStartNotAllowedException。

如果您的应用声明了 SYSTEM_ALERT_WINDOW 权限并从后台启动前台服务，则可能会受到此变更的影响。如果您的应用获得了 ForegroundServiceStartNotAllowedException，请检查应用的操作顺序，并确保应用在尝试从后台启动前台服务之前已具有有效的叠加层窗口。您可以通过调用 View.getWindowVisibility() 检查叠加层窗口当前是否可见，也可以替换 View.onWindowVisibilityChanged()，以便在可见性发生变化时收到通知。

测试

如需测试应用的行为，您可以启用这些新限制，即使您的应用并未以 Android 15 为目标平台（只要应用在 Android 15 设备上运行）也是如此。如需针对从后台启动前台服务启用这些新限制，请运行以下 adb 命令：

adb shell am compat enable FGS_SAW_RESTRICTIONS your-package-name

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

以 Android 15（API 级别 35）及更高版本为目标平台的应用无法再更改设备上的勿扰 (DND) 功能的全局状态或政策（无论是通过修改用户设置还是关闭勿扰模式）。相反，应用必须提供 AutomaticZenRule，系统会将其与现有的“最严格的政策优先”方案合并为一个全局政策。对之前会影响全局状态的现有 API 的调用（setInterruptionFilter、setNotificationPolicy）会导致创建或更新隐式 AutomaticZenRule，该 AutomaticZenRule 会根据这些 API 调用的调用周期开启和关闭。

请注意，只有当应用调用 setInterruptionFilter(INTERRUPTION_FILTER_ALL) 并希望该调用停用之前由其所有者激活的 AutomaticZenRule 时，此更改才会影响可观察到的行为。

OpenJDK API değişiklikleri

Android 15, Android'in temel kitaplıklarını en son OpenJDK LTS sürümlerindeki özelliklerle uyumlu hale getirme çalışmalarına devam ediyor.

Bu değişikliklerden bazıları, Android 15'i (API düzeyi 35) hedefleyen uygulamaların uygulama uyumluluğunu etkileyebilir:

  • Dize biçimlendirme API'lerinde yapılan değişiklikler: Aşağıdaki String.format() ve Formatter.format() API'leri kullanılırken bağımsız değişken dizini, işaretler, genişlik ve duyarlılık doğrulaması artık daha katı bir şekilde yapılıyor:

    Örneğin, 0 bağımsız değişken dizini kullanıldığında (biçim dizesinde %0) aşağıdaki istisna oluşturulur:

    IllegalFormatArgumentIndexException: Illegal format argument index = 0

    Bu durumda, biçim dizesinde 1 bağımsız değişken dizini (%1 biçiminde) kullanılarak sorun düzeltilebilir.

  • Arrays.asList(...).toArray() bileşen türünde yapılan değişiklikler: Arrays.asList(...).toArray() kullanılırken sonuçta elde edilen dizinin bileşen türü artık temel dizinin öğelerinin türü değil, Object türündedir. Bu nedenle, aşağıdaki kod ClassCastException oluşturur:

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

    Bu durumda, sonuçtaki dizide bileşen türü olarak String değerini korumak için bunun yerine Collection.toArray(Object[]) değerini kullanabilirsiniz:

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

  • Dil kodu işleme ile ilgili değişiklikler: Locale API'si kullanılırken İbranice, Yidiş ve Endonezce dil kodları artık eski biçimlerine (İbranice: iw, Yidiş: ji ve Endonezce: in) dönüştürülmüyor. Bu yerel ayarlardan birinin dil kodunu belirtirken bunun yerine ISO 639-1'deki kodları (İbranice: he, Yidiş: yi ve Endonezce: id) kullanın.

  • Rastgele int dizilerinde yapılan değişiklikler: https://bugs.openjdk.org/browse/JDK-8301574 adresinde yapılan değişikliklerin ardından aşağıdaki Random.ints() yöntemleri artık Random.nextInt() yöntemlerinden farklı bir sayı dizisi döndürüyor:

    Genel olarak bu değişiklik, uygulamanın bozulmasına neden olmamalıdır ancak kodunuz, Random.ints() yöntemlerinden oluşturulan dizinin Random.nextInt() ile eşleşmesini beklememelidir.

Yeni SequencedCollection API'si, uygulamanızın derleme yapılandırmasında compileSdk sürümünü Android 15'i (API düzeyi 35) kullanacak şekildegüncelledikten sonra uygulamanızın uyumluluğunu etkileyebilir:

  • MutableList.removeFirst() ve MutableList.removeLast() uzantısı işlevleriyle çakışma (kotlin-stdlib)

    Java'daki List türü, Kotlin'deki MutableList türüyle eşlenir. List.removeFirst() ve List.removeLast() API'leri Android 15'te (API düzeyi 35) kullanıma sunulduğundan Kotlin derleyici, işlev çağrılarını (ör. list.removeFirst()) kotlin-stdlib'deki uzantı işlevlerine değil, yeni List API'lerine statik olarak çözümler.

    Bir uygulama, compileSdk 35 olarak, minSdk ise 34 veya daha düşük bir sürüm olarak ayarlanıp yeniden derlenirse ve ardından Android 14 ile önceki sürümlerde çalıştırılırsa çalışma zamanı hatası verilir:

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

    Android Gradle eklentisindeki mevcut NewApi lint seçeneği, bu yeni API kullanımlarını yakalayabilir.

    ./gradlew lint

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

    Çalışma zamanı istisnasını ve lint hatalarını düzeltmek için removeFirst() ve removeLast() işlev çağrıları Kotlin'de sırasıyla removeAt(0) ve removeAt(list.lastIndex) ile değiştirilebilir. Android Studio Ladybug | 2024.1.3 veya sonraki sürümleri kullanıyorsanız bu hatalar için hızlı düzeltme seçeneği de sunulur.

    Lint seçeneği devre dışı bırakıldıysa @SuppressLint("NewApi") ve lintOptions { disable 'NewApi' } karakterlerini kaldırabilirsiniz.

  • Java'da diğer yöntemlerle çakışma

    Mevcut türlere yeni yöntemler eklenmiştir. Örneğin, List ve Deque. Bu yeni yöntemler, diğer arayüzlerde ve sınıflarda aynı ada ve bağımsız değişken türlerine sahip yöntemlerle uyumlu olmayabilir. Uyumsuzluk nedeniyle yöntem imzası çakışması durumunda javac derleyicisi derleme zamanı hatası verir. Örneğin:

    1. örnek hata:

    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

    2. örnek hata:

    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

    3. örnek hata:

    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

    Bu derleme hatalarını düzeltmek için bu arayüzleri uygulayan sınıf, yöntemi uyumlu bir dönüş türüyle geçersiz kılmalıdır. Örneğin:

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

Güvenlik

Android 15, uygulamaları ve kullanıcıları kötü amaçlı uygulamalardan korumak için sistem güvenliğini artıran değişiklikler içerir.

Kısıtlanmış TLS sürümleri

Android 15 限制了对 TLS 版本 1.0 和 1.1 的使用。这些版本之前已在 Android 中被弃用，但现在不允许面向 Android 15 的应用使用。

Güvenli arka plan etkinliği başlatma

Android 15, kötü amaçlı arka plan uygulamalarının diğer uygulamaları ön plana çıkarmasını, ayrıcalıklarını yükseltmesini ve kullanıcı etkileşimini kötüye kullanmasını engelleyen değişiklikler ekleyerek kullanıcıları kötü amaçlı uygulamalardan korur ve cihazları üzerinde daha fazla kontrol sahibi olmalarını sağlar. Arka plan etkinliği başlatmaları, Android 10'dan (API düzeyi 29) beri kısıtlanmıştır.

Diğer değişiklikler

  • PendingIntent oluşturucularının arka plan etkinliği başlatmalarını varsayılan olarak engellemesini sağlayın. Bu, uygulamaların kötü niyetli kişiler tarafından kötüye kullanılabilecek bir PendingIntent oluşturmasını yanlışlıkla önlemeye yardımcı olur.
  • PendingIntentGönderen izin vermediği sürece bir uygulamayı ön plana getirmeyin. Bu değişikliğin amacı, kötü amaçlı uygulamaların arka planda etkinlik başlatma özelliğini kötüye kullanmasını önlemektir. Varsayılan olarak, oluşturucu arka plan etkinliği başlatma ayrıcalıklarına izin vermediği veya gönderen arka plan etkinliği başlatma ayrıcalıklarına sahip olmadığı sürece uygulamaların görev yığınını ön plana getirmesine izin verilmez.
  • Bir görev yığınındaki en üstteki etkinliğin görevini nasıl tamamlayabileceğini kontrol edin. En üstteki etkinlik bir görevi tamamlarsa Android, en son etkin olan göreve geri döner. Ayrıca, en üstteki olmayan bir etkinlik görevini tamamlarsa Android ana ekrana geri döner ve bu en üstteki olmayan etkinliğin tamamlanmasını engellemez.
  • Diğer uygulamalardan rastgele etkinliklerin kendi görevinizde başlatılmasını önleyin. Bu değişiklik, kötü amaçlı uygulamaların diğer uygulamalardan geliyormuş gibi görünen etkinlikler oluşturarak kullanıcıları kimlik avı saldırılarına karşı korur.
  • Görünür olmayan pencerelerin arka plan etkinliği başlatma için değerlendirilmesini engelleme. Bu, kötü amaçlı uygulamaların, kullanıcılara istenmeyen veya kötü amaçlı içerik göstermek için arka plan etkinliği başlatmalarını kötüye kullanmasını önlemeye yardımcı olur.

Daha güvenli amaçlar

Android 15, amaçlar için StrictMode özelliğini sunar.

Intent kullanım ihlalleriyle ilgili ayrıntılı günlükleri görmek için aşağıdaki yöntemi kullanın:

Kotlin

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

Java

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

Kullanıcı deneyimi ve sistem arayüzü

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

Pencere yerleştirme değişiklikleri

Android 15'te pencere içe eklemeleriyle ilgili iki değişiklik vardır: Kenardan kenara ekranlar varsayılan olarak zorunlu kılınmıştır. Ayrıca sistem çubuklarının varsayılan yapılandırması gibi yapılandırma değişiklikleri de vardır.

Uçtan uca yaptırım

如果应用以 Android 15（API 级别 35）为目标平台，则在搭载 Android 15 的设备上默认以无边框显示。

以 Android 14 为目标平台且在 Android 15 设备上未以无边框显示的应用。


以 Android 15（API 级别 35）为目标平台且以无边框显示 的 Android 15 设备上的应用。此应用主要使用会自动应用边衬区的 Material 3 Compose 组件 。此屏幕不会受到 Android 15 无边框强制执行的不利影响。

这是一项重大变更，可能会对应用的界面产生不利影响。这些变更会影响以下界面区域：

  • 手势提示条导航栏
    • 默认透明。
    • 底部偏移已停用，因此除非应用了边衬区，否则内容会绘制在系统导航栏后面。
    • setNavigationBarColor 和 R.attr#navigationBarColor 已弃用，不会影响手势导航。
    • setNavigationBarContrastEnforced 和 R.attr#navigationBarContrastEnforced 仍不会影响手势导航。
  • 三按钮导航
    • 默认情况下，不透明度设置为 80%，颜色可能与窗口背景颜色一致。
    • 底部偏移已停用，因此除非应用了边衬区，否则内容会绘制在系统导航栏后面。
    • setNavigationBarColor 和 R.attr#navigationBarColor 默认设置为与窗口背景颜色一致。窗口背景必须是颜色可绘制对象，才能应用此默认设置。此 API 已弃用，但仍会影响三按钮导航。
    • setNavigationBarContrastEnforced 和 R.attr#navigationBarContrastEnforced 默认值为 true，这会在三按钮导航中添加 80% 不透明的背景。
  • 状态栏
    • 默认透明。
    • 顶部偏移已停用，因此除非应用了边衬区，否则内容会绘制在状态栏后面。
    • setStatusBarColor 和 R.attr#statusBarColor 已弃用，不会影响 Android 15。
    • setStatusBarContrastEnforced 和 R.attr#statusBarContrastEnforced 已弃用，但仍会影响 Android 15。
  • 刘海屏
    • 非浮动窗口的 layoutInDisplayCutoutMode 必须为 LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS。SHORT_EDGES、NEVER 和 DEFAULT 会被解读为 ALWAYS，这样用户就不会看到因显示屏刘海屏而产生的黑条，并且会以无边框显示。

以下示例展示了应用在以 Android 15（API 级别 35）为目标平台之前和之后，以及在应用边衬区之前和之后的效果。此示例并不全面，在 Android Auto 上可能会显示不同的效果。

以 Android 14 为目标平台且在 Android 15 设备上未以无边框显示的应用。
以 Android 15（API 级别 35）为目标平台且在 Android 15 设备上以无边框显示的应用。不过，由于 Android 15 无边框强制执行，许多元素现在会被状态栏、三按钮导航栏或刘海屏遮盖。被遮盖的界面包括 Material 2 顶部应用栏、悬浮操作按钮和列表项。
以 Android 15（API 级别 35）为目标平台且在 Android 15 设备上以无边框显示的应用，并应用了边衬区，因此界面不会被 遮盖。
如果您的应用已以无边框显示，需要检查哪些内容

如果您的应用已以 无边框 显示并应用了边衬区，则大部分情况下 不会受到影响，但在以下情形中除外。不过，即使您认为自己不会受到影响，我们也建议您测试应用。

  • 您有一个非浮动窗口，例如使用 SHORT_EDGES、NEVER 或 DEFAULT 而不是 LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS 的 Activity。如果您的应用在启动时崩溃，可能是因为启动画面所致。您可以将 核心 启动画面 依赖项升级到 1.2.0-alpha01 或更高版本，也可以设置 window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always。
  • 可能存在流量较低的屏幕，其界面被遮盖。验证这些访问量较少的屏幕是否没有被遮盖的界面。流量较低的屏幕包括：
    • 新手入门或登录屏幕
    • “设置”页面
如果您的应用尚未以无边框显示，需要检查哪些内容

如果您的应用尚未以无边框显示，则很可能会受到影响。除了已以无边框显示的应用的情形之外，您还应考虑以下情况：

  • 如果您的应用在 Compose 中使用了 Material 3 组件 ( androidx.compose.material3)，例如 TopAppBar、 BottomAppBar 和 NavigationBar，这些组件可能不会 受到影响，因为它们会自动处理边衬区。
  • 如果应用使用的是 Compose 中的 Material 2 组件 ( androidx.compose.material)，这些组件 本身并不会自动处理边衬区。不过，您可以获得边衬区的访问权限，然后手动应用边衬区。在 androidx.compose.material 1.6.0 及更高版本中，使用 windowInsets 参数可为 BottomAppBar、TopAppBar、 BottomNavigation 和 NavigationRail 手动应用边衬区。 同样，对于 Scaffold，请使用 contentWindowInsets 参数。
  • 如果应用使用了视图和 Material 组件 (com.google.android.material)，则大多数基于视图的 Material 组件（例如 BottomNavigationView、BottomAppBar、 NavigationRailView 或 NavigationView）都会处理边衬区，因此不需要执行额外的操作。不过，您需要添加 android:fitsSystemWindows="true" ，如果使用 AppBarLayout。
  • 对于自定义可组合项，请手动应用边衬区作为内边距。如果您的 内容位于 Scaffold 中，则可以使用 Scaffold 内边距值来使用边衬区。否则，请使用其中一个 WindowInsets应用内边距。
  • 如果应用使用的是视图和 BottomSheet、SideSheet 或自定义 容器，请使用 ViewCompat.setOnApplyWindowInsetsListener应用内边距。对于 RecyclerView，请使用此监听器应用内边距，同时添加 clipToPadding="false"。
如果您的应用必须提供自定义背景保护，需要检查哪些内容

如果您的应用必须为“三按钮”导航或 状态栏提供自定义背景保护，则应用应使用 WindowInsets.Type#tappableElement() 将可组合函数或视图放置在系统栏后面 ，以获取“三按钮” 导航栏高度或 WindowInsets.Type#statusBars。

其他无边框资源

如需了解有关应用边衬区的其他注意事项，请参阅无边框视图和无边框 Compose 指南。

已弃用的 API

以下 API 已弃用，但未停用：

以下 API 已弃用并已停用：

Kararlı yapılandırma

Uygulamanız Android 15'i (API düzeyi 35) veya sonraki sürümleri hedefliyorsa Configuration artık sistem çubuklarını hariç tutmaz. Düzen hesaplaması için Configuration sınıfında ekran boyutunu kullanıyorsanız ihtiyacınıza bağlı olarak uygun bir ViewGroup, WindowInsets veya WindowMetricsCalculator gibi daha iyi alternatiflerle değiştirmeniz gerekir.

Configuration, API 1'den beri kullanılabilir. Bu bilgiler genellikle Activity.onConfigurationChanged adresinden alınır. Pencere yoğunluğu, yön ve boyutlar gibi bilgiler sağlar. Configuration işlevinden döndürülen pencere boyutlarıyla ilgili önemli bir özellik, daha önce sistem çubuklarını hariç tutmasıdır.

Yapılandırma boyutu genellikle kaynak seçimi için kullanılır (ör. /res/layout-h500dp) ve bu hâlâ geçerli bir kullanım alanıdır. Ancak bu işlevin düzen hesaplaması için kullanılması her zaman önerilmemiştir. Böyle bir durum varsa hemen uzaklaşmalısınız. Configuration kullanımını, kullanım alanınıza bağlı olarak daha uygun bir ifadeyle değiştirmeniz gerekir.

Düzeni hesaplamak için kullanıyorsanız ViewGroup, CoordinatorLayout veya ConstraintLayout gibi uygun bir değer kullanın. Sistemin gezinme çubuğunun yüksekliğini belirlemek için kullanıyorsanız WindowInsets kullanın. Uygulama pencerenizin mevcut boyutunu öğrenmek istiyorsanız computeCurrentWindowMetrics kullanın.

Aşağıdaki listede, bu değişiklikten etkilenen alanlar açıklanmaktadır:

  • Configuration.screenWidthDp ve screenHeightDp boyutları artık sistem çubuklarını hariç tutmuyor.
  • Configuration.smallestScreenWidthDp, screenWidthDp ve screenHeightDp'de yapılan değişikliklerden dolaylı olarak etkilenir.
  • Configuration.orientation, kareye yakın cihazlarda screenWidthDp ve screenHeightDp ile ilgili değişikliklerden dolaylı olarak etkilenir.
  • Display.getSize(Point), Configuration alanındaki değişikliklerden dolaylı olarak etkilenir. Bu işlev, API düzeyi 30'dan itibaren kullanımdan kaldırılmıştır.
  • Display.getMetrics(), API düzeyi 33'ten beri bu şekilde çalışmaktadır.

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

Android 15'i (API düzeyi 35) hedefleyen uygulamalarda elegantTextHeight TextView özelliği varsayılan olarak true olur. Bu durumda, varsayılan olarak kullanılan kompakt yazı tipi, büyük dikey metriklere sahip bazı komut dosyalarıyla değiştirilir ve çok daha okunaklı bir yazı tipi kullanılır. Kompakt yazı tipi, düzenlerin bozulmasını önlemek için kullanıma sunulmuştur. Android 13 (API düzeyi 33), metin düzeninin fallbackLineSpacing özelliğini kullanarak dikey yüksekliği uzatmasına izin vererek bu bozulmaların çoğunu önler.

Android 15'te kompakt yazı tipi sistemde hâlâ mevcuttur. Bu nedenle, uygulamanız öncekiyle aynı davranışı elde etmek için elegantTextHeight değerini false olarak ayarlayabilir ancak bu özelliğin gelecekteki sürümlerde desteklenmeyeceği muhtemeldir. Bu nedenle, uygulamanız Arapça, Laosça, Myanmarca, Tamilce, Guceratça, Kannada, Malayalamca, Odiya, Teluguca veya Tayca yazı tiplerini destekliyorsa elegantTextHeight değerini true olarak ayarlayarak uygulamanızı test edin.

elegantTextHeight Android 14 (API düzeyi 34) ve önceki sürümleri hedefleyen uygulamalar için davranış
Android 15'i hedefleyen uygulamalar için elegantTextHeight davranışı.

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

在以前的 Android 版本中，某些具有复杂形状的手写字体或语言可能会在上一个或下一个字符的区域绘制字母。在某些情况下，此类字母会在开头或结尾处被剪裁。从 Android 15 开始，TextView 会分配宽度，以便为此类字母绘制足够的空间，并允许应用请求向左额外添加内边距以防止剪裁。

由于此更改会影响 TextView 确定宽度的方式，因此如果应用以 Android 15（API 级别 35）或更高版本为目标平台，TextView 会默认分配更多宽度。您可以通过对 TextView 调用 setUseBoundsForWidth API 来启用或停用此行为。

由于添加左内边距可能会导致现有布局未对齐，因此默认情况下不会添加内边距，即使以 Android 15 或更高版本为目标平台的应用也是如此。不过，您可以通过调用 setShiftDrawingOffsetForStartOverhang 添加额外的内边距以防止剪裁。

以下示例展示了这些更改如何改进某些字体和语言的文本布局。

采用手写体字体的英语文本的标准布局。部分字母被截断。对应的 XML 如下：

<TextView
    android:fontFamily="cursive"
    android:text="java" />
相同英语文本的布局，增加了宽度和内边距。以下是相应的 XML：

<TextView
    android:fontFamily="cursive"
    android:text="java"
    android:useBoundsForWidth="true"
    android:shiftDrawingOffsetForStartOverhang="true" />
泰语文本的标准布局。部分字母被截断。 以下是相应的 XML：

<TextView
    android:text="คอมพิวเตอร์" />
相同泰语文本的布局，增加了宽度和内边距。以下是相应的 XML：

<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ğine uyacak şekilde uzatıyordu. Örneğin, içerik Japonca ise Japonca yazı tipinin satır yüksekliği Latin alfabesindeki yazı tipinin satır yüksekliğinden biraz daha yüksek olduğundan metnin yüksekliği de biraz daha yüksek olur. Ancak satır yüksekliklerindeki bu farklılıklara rağmen EditText öğesi, aşağıdaki resimde gösterildiği gibi kullanılan yerel ayardan bağımsız olarak tek tip bir boyuta sahipti:

İngilizce (en), Japonca (ja) ve Burmaca (my) dillerinde metin içerebilen EditText öğelerini temsil eden üç kutu. Bu diller birbirinden farklı satır yüksekliklerine sahip olsa da EditText'ün yüksekliği aynıdır.

Android 15'i (API düzeyi 35) hedefleyen uygulamalarda, EditText için minimum satır yüksekliği artık aşağıdaki resimde gösterildiği gibi belirtilen yerel dilin referans yazı tipiyle eşleşecek şekilde ayrılmıştır:

İngilizce (en), Japonca (ja) ve Burmaca (my) dillerinde metin içerebilen EditText öğelerini temsil eden üç kutu. EditText öğesinin yüksekliği artık bu dillerin yazı tiplerinin varsayılan satır yüksekliğini barındıracak şekilde boşluk içeriyor.

Gerekirse uygulamanız, useLocalePreferredLineHeightForMinimum özelliğini false olarak belirterek önceki davranışı geri yükleyebilir ve Kotlin ile Java'da setMinimumFontMetrics API'sini kullanarak özel minimum dikey metrikler ayarlayabilir.

Kamera ve medya içerikleri

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

Ses odağı isteğinde bulunmayla ilgili kısıtlamalar

Android 15'i (API düzeyi 35) hedefleyen uygulamaların ses odağını istemesi için en üstteki uygulama olması veya ön planda bir hizmetin çalışıyor olması gerekir. Bir uygulama bu koşullardan birini karşılamıyorken odaklanma isteğinde bulunursa çağrı AUDIOFOCUS_REQUEST_FAILED döndürülür.

Ses odak noktası hakkında daha fazla bilgiyi Ses odak noktasını yönetme başlıklı makalede bulabilirsiniz.

SDK olmayan arayüzlerle ilgili kısıtlamalar güncellendi

Android 15, Android geliştiricilerle işbirliği ve en son dahili testlere dayalı olarak kısıtlanmış SDK dışı arayüzlerin güncellenmiş listelerini içerir. Mümkün olduğunda, SDK olmayan arayüzleri kısıtlamadan önce herkese açık alternatiflerin kullanılabilir olmasını sağlarız.

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

Uygulamanızın SDK dışı arayüzler kullanıp kullanmadığından emin değilseniz öğrenmek için uygulamanızı test edebilirsiniz. Uygulamanız SDK dışı arayüzlere bağlıysa SDK alternatiflerine geçişi planlamaya başlamanız gerekir. Bununla birlikte, bazı uygulamaların SDK dışı arayüzleri kullanmak için geçerli kullanım alanları olduğunu anlıyoruz. Uygulamanızdaki bir özellik için SDK olmayan bir arayüz kullanmaya alternatif bulamıyorsanız yeni bir genel 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.