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 yerlerde bu davranışları düzgün şekilde destekleyecek şekilde değiştirmeniz gerekir.

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

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

We are making the following changes to foreground services with Android 15.

Data sync foreground service timeout behavior

对于以 Android 15（API 级别 35）或更高版本为目标平台的应用，Android 15 为 dataSync 引入了新的超时行为。此行为也适用于新的 mediaProcessing 前台服务类型。

系统允许应用的 dataSync 服务在 24 小时内总共运行 6 小时，之后系统会调用正在运行的服务的 Service.onTimeout(int, int) 方法（在 Android 15 中引入）。此时，该服务有几秒钟时间来调用 Service.stopSelf()。调用 Service.onTimeout() 后，该服务将不再被视为前台服务。如果服务未调用 Service.stopSelf()，系统会抛出内部异常。系统会在 Logcat 中记录此异常，并显示以下消息：

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

为避免因行为变更而导致问题，您可以执行以下一项或多项操作：

  1. 让您的服务实现新的 Service.onTimeout(int, int) 方法。当您的应用收到回调时，请务必在几秒钟内调用 stopSelf()。（如果您不立即停止应用，系统会生成故障。）
  2. 确保应用的 dataSync 服务在任何 24 小时内总运行时间不超过 6 小时（除非用户与应用互动，重置计时器）。
  3. 仅通过直接的用户互动来启动 dataSync 前台服务；由于您的应用在服务启动时位于前台，因此服务会在应用进入后台后的 6 小时内完整运行。
  4. 请改用替代 API，而不是使用 dataSync 前台服务。

如果您的应用的 dataSync 前台服务在过去 24 小时内运行了 6 小时，则您无法启动其他 dataSync 前台服务，除非用户已将您的应用切换到前台（这会重置计时器）。如果您尝试启动其他 dataSync 前台服务，系统会抛出 ForegroundServiceStartNotAllowedException，并显示类似“前台服务类型 dataSync 的时间限制已用尽”的错误消息。

测试

如需测试应用的行为，您可以启用数据同步超时功能，即使应用未以 Android 15 为目标平台也是如此（前提是应用在 Android 15 设备上运行）。如需启用超时，请运行以下 adb 命令：

adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name

您还可以调整超时期限，更轻松地测试应用在达到此限制时的行为。如需设置新的超时期限，请运行以下 adb 命令：

adb shell device_config put activity_manager data_sync_fgs_timeout_duration duration-in-milliseconds

New media processing foreground service type

Android 15 引入了一种新的前台服务类型 mediaProcessing。此服务类型适用于转码媒体文件等操作。例如，媒体应用可能会下载音频文件，并需要先将其转换为其他格式，然后才能播放。您可以使用 mediaProcessing 前台服务，确保即使应用在后台运行时转换也会继续。

系统允许应用的 mediaProcessing 服务在 24 小时内总共运行 6 小时，之后系统会调用正在运行的服务的 Service.onTimeout(int, int) 方法（在 Android 15 中引入）。此时，服务有几秒钟的时间来调用 Service.stopSelf()。如果服务未调用 Service.stopSelf()，系统会抛出内部异常。系统会在 Logcat 中记录此异常，并显示以下消息：

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

为避免出现此异常，您可以执行以下任一操作：

  1. 让您的服务实现新的 Service.onTimeout(int, int) 方法。当您的应用收到回调时，请务必在几秒钟内调用 stopSelf()。（如果您未立即停止应用，系统会生成失败情况。）
  2. 确保应用的 mediaProcessing 服务在任何 24 小时内总运行时间不超过 6 小时（除非用户与应用互动，重置计时器）。
  3. 仅在有直接用户互动时启动 mediaProcessing 前台服务；由于服务启动时应用位于前台，因此您的服务在应用进入后台后有完整的 6 小时时间。
  4. 请改用 替代 API（例如 WorkManager），而不是使用 mediaProcessing 前台服务。

如果您的应用的 mediaProcessing 前台服务在过去 24 小时内运行了 6 小时，则您无法启动其他 mediaProcessing 前台服务，除非用户将您的应用切换到前台（这会重置计时器）。如果您尝试启动另一个 mediaProcessing 前台服务，系统会抛出 ForegroundServiceStartNotAllowedException，并显示类似于“前台服务类型 mediaProcessing 的时间限制已用尽”的错误消息。

如需详细了解 mediaProcessing 服务类型，请参阅 Android 15 前台服务类型变更：媒体处理。

测试

如需测试应用的行为，您可以启用媒体处理超时，即使您的应用并非以 Android 15 为目标平台也是如此（前提是应用在 Android 15 设备上运行）。如需启用超时，请运行以下 adb 命令：

adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name

您还可以调整超时期限，以便更轻松地测试应用在达到上限时的行为方式。如需设置新的超时期限，请运行以下 adb 命令：

adb shell device_config put activity_manager media_processing_fgs_timeout_duration duration-in-milliseconds

Restrictions on BOOT_COMPLETED broadcast receivers launching foreground services

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:

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

Restrictions on starting foreground services while an app holds the SYSTEM_ALERT_WINDOW permission

Önceden, SYSTEM_ALERT_WINDOW iznine sahip bir uygulama, o anda arka planda olsa bile ön plan hizmeti başlatabiliyordu (arka planda başlatma kısıtlamalarından muafiyetler bölümünde açıklandığı gibi).

Bir uygulama Android 15'i hedefliyorsa bu muafiyet artık daha dar olacaktır. Uygulamanın artık SYSTEM_ALERT_WINDOW iznine sahip olması ve ayrıca görünür bir yer paylaşımı penceresine sahip olması gerekiyor. Yani, ön plan hizmetini başlatmadan önce uygulamanın önce bir TYPE_APPLICATION_OVERLAY penceresi başlatması ve bu pencerenin görünür olması gerekir.

Uygulamanız bu yeni koşulları karşılamadan arka plandan ön plan hizmeti başlatmaya çalışırsa (ve başka bir muafiyeti yoksa) sistem ForegroundServiceStartNotAllowedException hatası verir.

Uygulamanız SYSTEM_ALERT_WINDOW iznini beyan ediyorsa ve ön plan hizmetlerini arka plandan başlatıyorsa bu değişiklikten etkilenebilir. Uygulamanız ForegroundServiceStartNotAllowedException alıyorsa uygulamanızın işlem sırasını kontrol edin ve arka plandan ön plan hizmeti başlatmaya çalışmadan önce uygulamanızda etkin bir yer paylaşımı penceresi bulunduğundan emin olun. View.getWindowVisibility() çağrısını yaparak yer paylaşımı pencerenizin şu anda görünür olup olmadığını kontrol edebilir veya görünürlük her değiştiğinde bildirim almak için View.onWindowVisibilityChanged() değerini geçersiz kılabilirsiniz.

Test

Uygulamanızın davranışını test etmek için, Android 15'i hedeflemese bile bu yeni kısıtlamaları etkinleştirebilirsiniz (uygulamanız Android 15 cihazında çalışıyorsa). Arka plandan ön plan hizmetlerini başlatmayla ilgili bu yeni kısıtlamaları etkinleştirmek için aşağıdaki adb komutunu çalıştırın:

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

Apps that target Android 15 (API level 35) and higher can no longer change the global state or policy of Do Not Disturb (DND) on a device (either by modifying user settings, or turning off DND mode). Instead, apps must contribute an AutomaticZenRule, which the system combines into a global policy with the existing most-restrictive-policy-wins scheme. Calls to existing APIs that previously affected global state (setInterruptionFilter, setNotificationPolicy) result in the creation or update of an implicit AutomaticZenRule, which is toggled on and off depending on the call-cycle of those API calls.

Note that this change only affects observable behavior if the app is calling setInterruptionFilter(INTERRUPTION_FILTER_ALL) and expects that call to deactivate an AutomaticZenRule that was previously activated by their owners.

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 Object (temel dizinin öğelerinin türü değil) olur. Bu nedenle, aşağıdaki kod ClassCastException hatası verir:

    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 değerini Android 15'i (API düzeyi 35) kullanacak şekilde güncelledikten sonra uygulamanızın uyumluluğunu etkileyebilir:

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

    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 değeri 35, minSdk değeri ise 34 veya daha düşük olacak şekilde yeniden derlenip Android 14 ve ö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 eklendi. Ö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 ve 1.1 sürümlerinin kullanımını kısıtlar. Bu sürümlerin desteği Android'de daha önce sonlandırılmıştı ancak artık Android 15'i hedefleyen uygulamalarda kullanılmasına izin verilmiyor.

Güvenli arka plan etkinliği başlatma

Android 15 protects users from malicious apps and gives them more control over their devices by adding changes that prevent malicious background apps from bringing other apps to the foreground, elevating their privileges, and abusing user interaction. Background activity launches have been restricted since Android 10 (API level 29).

Other changes

In addition to the restriction for UID matching, these other changes are also included:

  • Change PendingIntent creators to block background activity launches by default. This helps prevent apps from accidentally creating a PendingIntent that could be abused by malicious actors.
  • Don't bring an app to the foreground unless the PendingIntent sender allows it. This change aims to prevent malicious apps from abusing the ability to start activities in the background. By default, apps are not allowed to bring the task stack to the foreground unless the creator allows background activity launch privileges or the sender has background activity launch privileges.
  • Control how the top activity of a task stack can finish its task. If the top activity finishes a task, Android will go back to whichever task was last active. Moreover, if a non-top activity finishes its task, Android will go back to the home screen; it won't block the finish of this non-top activity.
  • Prevent launching arbitrary activities from other apps into your own task. This change prevents malicious apps from phishing users by creating activities that appear to be from other apps.
  • Block non-visible windows from being considered for background activity launches. This helps prevent malicious apps from abusing background activity launches to display unwanted or malicious content to users.

Daha güvenli amaçlar

Android 15, intent'leri daha güvenli ve daha güçlü hale getirmek için yeni isteğe bağlı güvenlik önlemleri sunar. Bu değişiklikler, olası güvenlik açıklarını önlemeyi amaçlar ve kötü amaçlı uygulamalar tarafından istismar edilebilecek amaçların kötüye kullanımı. Android 15'te intent'lerin güvenliğiyle ilgili iki önemli iyileştirme yapılmıştır:

  • Hedef intent filtreleriyle eşleşme: Belirli bileşenleri hedefleyen intent'ler, hedefin intent filtresi spesifikasyonlarıyla tam olarak eşleşmelidir. Başka bir uygulamanın etkinliğini başlatmak için intent gönderirseniz hedef intent bileşeninin, alıcı etkinliğin beyan edilen intent filtreleriyle uyumlu olması gerekir.
  • Niyetlerin işlemleri olmalıdır: İşlem içermeyen amaçlar artık eşleşmeyecek inceleyebilirsiniz. Bu, amaçların etkinlik başlatmak veya hizmetlerin açıkça tanımlanmış bir işlevi olmalıdır.

Uygulamanızın bu değişikliklere nasıl tepki verdiğini kontrol etmek için Uygulamanızda StrictMode. Ayrıntılı Intent kullanım ihlali hakkında günlükler almak için aşağıdaki yöntemi ekleyin:

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 kullanıcı 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

There are two changes related to window insets in Android 15: edge-to-edge is enforced by default, and there are also configuration changes, such as the default configuration of system bars.

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。
  • 可能存在流量较低且界面被遮挡的屏幕。验证这些访问频率较低的界面是否没有被遮挡的界面。低流量界面包括：
    • 初始配置或登录界面
    • “设置”页面
如果您的应用尚未实现全屏显示，需要检查哪些方面

如果您的应用尚未实现全屏显示，则很可能会受到影响。除了已经实现全屏显示的 app 的场景之外，您还应考虑以下事项：

  • 如果您的应用在 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）都会处理边衬区，因此不需要执行额外的操作。不过，如果使用的是 AppBarLayout，则需要添加 android:fitsSystemWindows="true"。
  • 对于自定义可组合项，请手动应用边衬区作为内边距。如果您的内容位于 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ın hariç tutulmasıydı.

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 CoordinatorLayout veya ConstraintLayout gibi uygun bir ViewGroup 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'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ğ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 güncellenen kısıtlamalar

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üzleri kullanıyorsa 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 bir çözüm 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.