Изменения в поведении: приложения для Android 15 или более поздней версии.

Как и предыдущие выпуски, Android 15 включает изменения в поведении, которые могут повлиять на ваше приложение. Следующие изменения в поведении применяются исключительно к приложениям, ориентированным на Android 15 или более позднюю версию. Если ваше приложение ориентировано на Android 15 или более поздней версии, вам следует изменить его так, чтобы оно правильно поддерживало такое поведение, если это применимо.

Обязательно ознакомьтесь со списком изменений поведения, которые влияют на все приложения, работающие на Android 15, независимо от targetSdkVersion вашего приложения.

Основная функциональность

Android 15 изменяет или расширяет различные основные возможности системы Android.

Изменения в службах переднего плана

Мы вносим следующие изменения в службы переднего плана в Android 15.

Поведение времени ожидания службы синхронизации данных на переднем плане

В Android 15 представлен новый режим тайм-аута для dataSync для приложений, предназначенных для Android 15 или более поздних версий. Это поведение также применимо к новому типу службы переднего плана mediaProcessing .

Система разрешает службам dataSync приложения работать в общей сложности 6 часов в течение 24-часового периода, после чего система вызывает метод 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 вашего приложения не работают более 6 часов в течение 24-часового периода (если только пользователь не взаимодействует с приложением, сбрасывая таймер).
  3. Запускайте службы dataSync переднего плана только в результате прямого взаимодействия с пользователем; поскольку ваше приложение находится на переднем плане при запуске службы, у вашей службы есть полные шесть часов после того, как приложение перейдет в фоновый режим.
  4. Вместо использования службы переднего плана dataSync используйте альтернативный API .

Если службы приоритетного плана dataSync вашего приложения работали в течение 6 часов за последние 24 часа, вы не сможете запустить другую службу приоритетного плана 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

Новый тип приоритетной службы обработки мультимедиа

Android 15 引入了一种新的前台服务类型，即 mediaProcessing。本次 服务类型适用于对媒体文件进行转码等操作。对于 例如，媒体应用可能会下载音频文件并需要将其转换为 然后再播放之前的视频您可以使用 mediaProcessing 前台 以确保即使应用处于打开或关闭状态，转化仍会继续进行 背景。

系统允许应用的 mediaProcessing 服务共运行 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. 不使用 mediaProcessing 前台服务，而是使用替代方法 API，例如 WorkManager。

如果您的应用的 mediaProcessing 前台服务已在 不能启动其他 mediaProcessing 前台服务，除非 用户将您的应用转至前台（这会重置计时器）。如果您 尝试启动另一个 mediaProcessing 前台服务，系统会抛出 ForegroundServiceStartNotAllowedException 并显示类似“前台服务的时限已用尽”的错误消息 type 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

Ограничения на широковещательные приемники BOOT_COMPLETED , запускающие службы приоритета

在启动 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

Ограничения на запуск служб переднего плана, пока приложение имеет разрешение SYSTEM_ALERT_WINDOW

以前，如果应用拥有 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

Изменения в том, когда приложения могут изменять глобальное состояние режима «Не беспокоить».

Приложения, предназначенные для Android 15, больше не могут изменять глобальное состояние или политику режима «Не беспокоить» (DND) на устройстве (путем изменения пользовательских настроек или отключения режима «Не беспокоить»). Вместо этого приложения должны внести AutomaticZenRule , которое система объединяет в глобальную политику с существующей схемой наиболее ограничительной политики. Вызовы к существующим API, которые ранее влияли на глобальное состояние ( setInterruptionFilter , setNotificationPolicy ), приводят к созданию или обновлению неявного объекта AutomaticZenRule , который включается и выключается в зависимости от цикла вызовов этих вызовов API.

Обратите внимание, что это изменение влияет на наблюдаемое поведение только в том случае, если приложение вызывает setInterruptionFilter(INTERRUPTION_FILTER_ALL) и ожидает, что этот вызов деактивирует AutomaticZenRule , который ранее был активирован его владельцами.

Изменения API OpenJDK

В Android 15 продолжается работа по обновлению основных библиотек Android, чтобы они соответствовали функциям последних выпусков OpenJDK LTS.

Некоторые из этих изменений могут повлиять на совместимость приложений, предназначенных для Android 15 (уровень API 35):

  • Изменения в API форматирования строк : проверка индекса аргумента, флагов, ширины и точности теперь более строгая при использовании следующих API String.format() и Formatter.format() :

    Например, следующее исключение выдается, когда используется индекс аргумента 0 ( %0 в строке формата):

    IllegalFormatArgumentIndexException: Illegal format argument index = 0

    В этом случае проблему можно решить, используя индекс аргумента 1 ( %1 в строке формата).

  • Изменения в типе компонента Arrays.asList(...).toArray() : при использовании Arrays.asList(...).toArray() типом компонента результирующего массива теперь является Object , а не тип элементы базового массива. Итак, следующий код генерирует исключение ClassCastException :

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

    В этом случае, чтобы сохранить String как тип компонента в результирующем массиве, вы можете вместо этого использовать Collection.toArray(Object[]) :

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

  • Изменения в обработке языковых кодов . При использовании Locale API языковые коды для иврита, идиша и индонезийского языка больше не преобразуются в их устаревшие формы (иврит: iw , идиш: ji и индонезийский: in ). При указании кода языка для одного из этих языков вместо этого используйте коды из ISO 639-1 (иврит: he , идиш: yi и индонезийский: id ).

  • Изменения в случайных последовательностях целых чисел : после изменений, внесенных в https://bugs.openjdk.org/browse/JDK-8301574 , следующие методы Random.ints() теперь возвращают последовательность чисел, отличную от методов Random.nextInt() делать:

    Как правило, это изменение не должно приводить к нарушению работы приложения, но ваш код не должен ожидать, что последовательность, сгенерированная методами Random.ints() будет соответствовать Random.nextInt() .

Новый API SequencedCollection может повлиять на совместимость вашего приложения после обновления compileSdk в конфигурации сборки вашего приложения для использования Android 15 (уровень API 35) :

  • Конфликт с функциями расширения MutableList.removeFirst() и MutableList.removeLast() в kotlin-stdlib

    Тип List в Java сопоставляется с типом MutableList в Kotlin. Поскольку API-интерфейсы List.removeFirst() и List.removeLast() были представлены в Android 15 (уровень API 35), компилятор Kotlin разрешает вызовы функций, например list.removeFirst() , статически в новые API-интерфейсы List , а не в функции расширения в kotlin-stdlib .

    Если приложение перекомпилируется с compileSdk , равным 35 , и minSdk , равным 34 или ниже, а затем приложение запускается на Android 14 и более ранних версиях, выдается ошибка времени выполнения:

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

    Существующая опция NewApi lint в плагине Android Gradle может отследить эти новые варианты использования API.

    ./gradlew lint

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

    Чтобы исправить исключения во время выполнения и ошибки проверки, вызовы функций removeFirst() и removeLast() можно заменить на removeAt(0) и removeAt(list.lastIndex) соответственно в Kotlin. Если вы используете Android Studio Ladybug | 2024.1.3 или более поздней версии, он также предоставляет возможность быстрого исправления этих ошибок.

    Рассмотрите возможность удаления @SuppressLint("NewApi") и lintOptions { disable 'NewApi' } если опция lint отключена.

  • Столкновение с другими методами в Java

    В существующие типы добавлены новые методы, например List и Deque . Эти новые методы могут быть несовместимы с методами с тем же именем и типами аргументов в других интерфейсах и классах. В случае конфликта сигнатуры метода с несовместимостью компилятор javac выводит ошибку времени сборки. Например:

    Пример ошибки 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

    Пример ошибки 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

    Пример ошибки 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

    Чтобы исправить эти ошибки сборки, класс, реализующий эти интерфейсы, должен переопределить метод совместимым типом возвращаемого значения. Например:

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

Безопасность

Android 15 включает изменения, повышающие безопасность системы и помогающие защитить приложения и пользователей от вредоносных приложений.

Запуск защищенной фоновой активности

Android 15 защищает пользователей от вредоносных приложений и дает им больше контроля над своими устройствами, добавляя изменения, которые не позволяют вредоносным фоновым приложениям выводить другие приложения на передний план, повышать их привилегии и злоупотреблять взаимодействием с пользователем. Запуск фоновой активности ограничен начиная с Android 10 (уровень API 29).

Блокировать запуск действий приложений, которые не соответствуют верхнему UID в стеке.

Вредоносные приложения могут запускать действия другого приложения в рамках той же задачи, а затем накладываться поверх них, создавая иллюзию того, что они являются этим приложением. Эта атака «перехвата задачи» обходит текущие ограничения на фоновый запуск, поскольку все это происходит в рамках одной и той же видимой задачи. Чтобы снизить этот риск, в Android 15 добавлен флаг, который блокирует запуск действий приложений, которые не соответствуют верхнему UID в стеке. Чтобы разрешить все действия вашего приложения, обновите allowCrossUidActivitySwitchFromBelow в файле AndroidManifest.xml вашего приложения:

<application android:allowCrossUidActivitySwitchFromBelow="false" >

Новые меры безопасности активны, если выполняются все следующие условия:

  • Приложение, осуществляющее запуск, ориентировано на Android 15.
  • Приложение на вершине стека задач предназначено для Android 15.
  • Любая видимая активность включила новые средства защиты.

Если меры безопасности включены, приложения могут вернуться домой, а не к последнему видимому приложению, если завершат свою задачу.

Другие изменения

Помимо ограничения на сопоставление UID, включены и другие изменения:

  • Измените создателей PendingIntent , чтобы они по умолчанию блокировали запуск фоновой активности . Это помогает предотвратить случайное создание приложениями PendingIntent , которым могут воспользоваться злоумышленники.
  • Не выводите приложение на передний план, если это не разрешено отправителем PendingIntent . Это изменение направлено на то, чтобы вредоносные приложения не злоупотребляли возможностью запускать действия в фоновом режиме. По умолчанию приложениям не разрешено выводить стек задач на передний план, если только создатель не разрешил права запуска фоновых действий или отправитель не имеет привилегий запуска фоновых действий.
  • Управляйте тем, как верхняя операция стека задач может завершить свою задачу . Если верхняя активность завершает задачу, Android вернется к той задаче, которая была активной в последний раз. Более того, если неосновное действие завершит свою задачу, Android вернется на главный экран; это не заблокирует завершение этого нетопового действия.
  • Запретите запуск произвольных действий из других приложений в вашу собственную задачу . Это изменение не позволяет вредоносным приложениям фишинговать пользователей, создавая действия, выглядящие как действия других приложений.
  • Блокировать невидимые окна для запуска фоновых действий . Это помогает предотвратить злоупотребление вредоносными приложениями запуском фоновой активности для отображения пользователям нежелательного или вредоносного контента.

Более безопасные намерения

В Android 15 представлены новые меры безопасности, которые делают намерения более безопасными и надежными. Эти изменения направлены на предотвращение потенциальных уязвимостей и неправомерного использования намерений, которые могут быть использованы вредоносными приложениями. В Android 15 есть два основных улучшения безопасности намерений:

  • Соответствие целевым фильтрам намерений: намерения, нацеленные на определенные компоненты, должны точно соответствовать спецификациям целевого фильтра намерений. Если вы отправляете намерение запустить действие другого приложения, целевой компонент намерения должен согласовываться с объявленными фильтрами намерений принимающего действия.
  • Намерения должны иметь действия: намерения без действия больше не будут соответствовать никаким фильтрам намерений. Это означает, что намерения, используемые для запуска действий или служб, должны иметь четко определенное действие.
  • Ожидающие намерения: создатель ожидающего намерения считается отправителем включающего намерения , а не отправителем ожидающего намерения.

Котлин 

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

Ява 

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

Пользовательский опыт и системный интерфейс

Android 15 включает в себя некоторые изменения, призванные создать более последовательный и интуитивно понятный пользовательский интерфейс.

Изменения вставки окна

Есть два изменения, связанных с вставками окон в Android 15: по умолчанию применяется сквозное изображение, а также есть изменения конфигурации, такие как конфигурация системных панелей по умолчанию.

Комплексное соблюдение требований

在搭载 Android 15 的设备上，应用会默认采用全屏 以 Android 15（API 级别 35）为目标平台。

<ph type="x-smartling-placeholder">
</ph>
一款以 Android 14 为目标平台且在 Android 设备上未处于无边框的应用 Android 15 设备。


<ph type="x-smartling-placeholder">
</ph>
一款以 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）以及应用边衬区之前和之后。

<ph type="x-smartling-placeholder">
</ph>
一款以 Android 14 为目标平台且在 Android 设备上未处于无边框的应用 Android 15 设备。
。 <ph type="x-smartling-placeholder">
</ph>
一款以 Android 15（API 级别 35）为目标平台且采用无边框的应用 在 Android 15 设备上。不过，许多元素 栏、“三按钮”导航栏或刘海屏（由于 Android 15） 全屏强制措施。隐藏界面包含 Material 2 顶部应用栏、悬浮操作按钮和列表项。
。 <ph type="x-smartling-placeholder">
</ph>
如果应用以 Android 15（API 级别 35）为目标平台， Android 15 设备并应用边衬区，这样界面就不会 已隐藏。
检查应用是否已采用全屏的检查步骤

如果您的应用已经采用无边框且应用了边衬区， 基本未受影响，但下列情况除外。但即使您认为 您不会受到影响，但我们建议您测试自己的应用。

  • 您的非浮动窗口（例如 Activity）使用 SHORT_EDGES、NEVER 或 DEFAULT，而不是 LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS。如果您的应用在启动时崩溃 可能是启动画面所致您可以升级核心 初始屏幕依赖项更改为 1.2.0-alpha01 或更高版本，或者设置 window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always。
  • 可能会有流量较低的屏幕显示被遮挡的界面。验证这些 访问较少的屏幕也不会显示被遮挡的界面。流量较低的屏幕包括： <ph type="x-smartling-placeholder">
      </ph>
    • 初始配置或登录屏幕
    • “设置”页面
如何检查应用尚未实现无边框

如果您的应用还没有全面屏，那么您很可能会受到影响。在 除了针对已经采用无边框的应用的情况之外， 请考虑以下事项：

  • 如果您的应用使用 Material 3 组件 ( androidx.compose.material3)，例如 TopAppBar， BottomAppBar 和 NavigationBar，那么这些组件可能不 会受到影响，因为它们会自动处理边衬区。
  • 如果您的应用使用 Material 2 组件 ( androidx.compose.material），那么这些组件 不会自动处理边衬区。不过，您可以使用边衬区 并手动应用这些设置在 androidx.compose.material 1.6.0 中 然后使用 windowInsets 参数手动应用边衬区 BottomAppBar、TopAppBar、 BottomNavigation 和 NavigationRail。 同样，对以下内容使用 contentWindowInsets 形参： Scaffold。
  • 如果您的应用使用视图和 Material 组件 (com.google.android.material)，大多数基于 View 的 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 现已弃用：

Стабильная конфигурация

Если ваше приложение предназначено для Android 15 (уровень API 35) или выше, Configuration больше не исключает системные панели. Если вы используете размер экрана в классе Configuration для расчета макета, вам следует заменить его лучшими альтернативами, такими как соответствующие ViewGroup , WindowInsets или WindowMetricsCalculator , в зависимости от ваших потребностей.

Configuration доступна начиная с API 1. Обычно ее получают из Activity.onConfigurationChanged . Он предоставляет такую ​​информацию, как плотность, ориентация и размеры окон. Одной из важных характеристик размеров окон, возвращаемых из Configuration , является то, что ранее из нее исключались системные панели.

Размер конфигурации обычно используется для выбора ресурсов, например /res/layout-h500dp , и это по-прежнему допустимый вариант использования. Однако использовать его для расчета планировки всегда не поощрялось. Если вы это сделаете, вам следует отойти от этого сейчас. Вам следует заменить использование Configuration чем-то более подходящим в зависимости от вашего варианта использования.

Если вы используете его для расчета макета, используйте соответствующую ViewGroup , такую ​​как CoordinatorLayout или ConstraintLayout . Если вы используете его для определения высоты системной панели навигации, используйте WindowInsets . Если вы хотите узнать текущий размер окна вашего приложения, используйте computeCurrentWindowMetrics .

В следующем списке описаны поля, затронутые этим изменением:

  • Размеры Configuration.screenWidthDp и screenHeightDp больше не исключают системные панели.
  • Configuration.smallestScreenWidthDp косвенно влияют изменения в screenWidthDp и screenHeightDp .
  • Configuration.orientation косвенно влияют изменения screenWidthDp и screenHeightDp на устройствах, близких к квадратным.
  • Display.getSize(Point) косвенно влияют изменения Configuration . Это устарело, начиная с уровня API 30.
  • Display.getMetrics() уже работал таким образом, начиная с уровня API 33.

Атрибут ElegantTextHeight по умолчанию имеет значение true

Для приложений, ориентированных на Android 15, атрибут elegantTextHeight TextView становится true по умолчанию, заменяя компактный шрифт, используемый по умолчанию, некоторыми скриптами с большими вертикальными метриками на гораздо более читаемый. Компактный шрифт был введен, чтобы предотвратить нарушение макета; Android 13 (уровень API 33) предотвращает многие из этих проблем, позволяя текстовому макету растягивать вертикальную высоту с помощью атрибута fallbackLineSpacing .

В Android 15 компактный шрифт по-прежнему остается в системе, поэтому ваше приложение может установить для elegantTextHeight значение false чтобы получить то же поведение, что и раньше, но вряд ли он будет поддерживаться в следующих выпусках. Итак, если ваше приложение поддерживает следующие сценарии: арабский, лаосский, мьянманский, тамильский, гуджаратский, каннада, малаялам, одиа, телугу или тайский, протестируйте свое приложение, установив для elegantTextHeight значение true .

Поведение elegantTextHeight для приложений, ориентированных на Android 14 (уровень API 34) и ниже.
Поведение elegantTextHeight для приложений, ориентированных на Android 15.

Изменение ширины TextView для сложных форм букв

В предыдущих версиях Android некоторые рукописные шрифты или языки сложной формы могли отображать буквы в области предыдущего или следующего символа. В некоторых случаях такие буквы обрезались в начальной или конечной позиции. Начиная с Android 15, TextView выделяет ширину для рисования достаточного места для таких букв и позволяет приложениям запрашивать дополнительные поля слева, чтобы предотвратить обрезку.

Поскольку это изменение влияет на то, как TextView определяет ширину, TextView по умолчанию выделяет большую ширину, если приложение предназначено для Android 15 или более поздней версии. Вы можете включить или отключить это поведение, вызвав API setUseBoundsForWidth в TextView .

Поскольку добавление левого отступа может привести к смещению существующих макетов, отступы не добавляются по умолчанию даже для приложений, ориентированных на 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 с учетом локали

В предыдущих версиях Android текстовый макет растягивал высоту текста так, чтобы она соответствовала высоте строки шрифта, соответствующего текущему языковому стандарту. Например, если контент был на японском языке, поскольку высота строки японского шрифта немного больше, чем у латинского шрифта, высота текста стала немного больше. Однако, несмотря на эти различия в высоте строк, размер элемента EditText был одинаковым, независимо от используемой локали, как показано на следующем изображении:

Три поля, представляющие элементы EditText , которые могут содержать текст на английском (en), японском (ja) и бирманском (my). Высота EditText одинакова, хотя эти языки имеют разную высоту строк.

Для приложений, ориентированных на Android 15, минимальная высота строки теперь зарезервирована для EditText , чтобы соответствовать эталонному шрифту для указанного языкового стандарта, как показано на следующем изображении:

Три поля, представляющие элементы EditText , которые могут содержать текст на английском (en), японском (ja) и бирманском (my). Высота EditText теперь включает пространство для размещения высоты строки по умолчанию для шрифтов этих языков.

При необходимости ваше приложение может восстановить предыдущее поведение, указав для атрибута useLocalePreferredLineHeightForMinimum значение false , а ваше приложение может установить собственные минимальные вертикальные метрики с помощью API setMinimumFontMetrics в Kotlin и Java.

Камера и медиа

В Android 15 внесены следующие изменения в поведение камеры и мультимедиа для приложений, предназначенных для Android 15 или более поздних версий.

Ограничения на запрос аудиофокуса

以 Android 15 为目标平台的应用必须是顶级应用或运行前台服务，才能请求音频焦点。如果应用在不符合其中任何一项要求时尝试请求焦点，该调用将返回 AUDIOFOCUS_REQUEST_FAILED。

您可以参阅管理音频焦点，详细了解音频焦点。

Обновлены ограничения, не связанные с SDK.

Android 15 включает обновленные списки ограниченных интерфейсов, не входящих в SDK, основанные на сотрудничестве с разработчиками Android и последних результатах внутреннего тестирования. По возможности мы обеспечиваем доступность общедоступных альтернатив, прежде чем ограничивать интерфейсы, не относящиеся к SDK.

Если ваше приложение не предназначено для Android 15, некоторые из этих изменений могут не затронуть вас сразу. Однако, хотя ваше приложение может получить доступ к некоторым интерфейсам, не входящим в SDK, в зависимости от целевого уровня API вашего приложения , использование любого метода или поля, не входящего в SDK, всегда сопряжено с высоким риском поломки вашего приложения.

Если вы не уверены, использует ли ваше приложение интерфейсы, отличные от SDK, вы можете проверить свое приложение , чтобы выяснить это. Если ваше приложение использует интерфейсы, отличные от SDK, вам следует начать планировать переход на альтернативы SDK. Тем не менее, мы понимаем, что в некоторых приложениях есть допустимые варианты использования интерфейсов, отличных от SDK. Если вы не можете найти альтернативу использованию интерфейса, отличного от SDK, для функции вашего приложения, вам следует запросить новый общедоступный API .

Дополнительные сведения об изменениях в этой версии Android см . в разделе Обновления ограничений интерфейса, не связанных с SDK, в Android 15 . Дополнительные сведения об интерфейсах, отличных от SDK, см. в разделе Ограничения на интерфейсы, не относящиеся к SDK .