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

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

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

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

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

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

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

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

Android 15 introduces a new timeout behavior to dataSync for apps targeting Android 15 (API level 35) or higher. This behavior also applies to the new mediaProcessing foreground service type.

The system permits an app's dataSync services to run for a total of 6 hours in a 24-hour period, after which the system calls the running service's Service.onTimeout(int, int) method (introduced in Android 15). At this time, the service has a few seconds to call Service.stopSelf(). When Service.onTimeout() is called, the service is no longer considered a foreground service. If the service does not call Service.stopSelf(), the system throws an internal exception. The exception is logged in Logcat with the following message:

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

To avoid problems with this behavior change, you can do one or more of the following:

  1. Have your service implement the new Service.onTimeout(int, int) method. When your app receives the callback, make sure to call stopSelf() within a few seconds. (If you don't stop the app right away, the system generates a failure.)
  2. Make sure your app's dataSync services don't run for more than a total of 6 hours in any 24-hour period (unless the user interacts with the app, resetting the timer).
  3. Only start dataSync foreground services as a result of direct user interaction; since your app is in the foreground when the service starts, your service has the full six hours after the app goes to the background.
  4. Instead of using a dataSync foreground service, use an alternative API.

If your app's dataSync foreground services have run for 6 hours in the last 24, you cannot start another dataSync foreground service unless the user has brought your app to the foreground (which resets the timer). If you try to start another dataSync foreground service, the system throws ForegroundServiceStartNotAllowedException with an error message like "Time limit already exhausted for foreground service type dataSync".

Testing

To test your app's behavior, you can enable data sync timeouts even if your app is not targeting Android 15 (as long as the app is running on an Android 15 device). To enable timeouts, run the following adb command:

adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name

You can also adjust the timeout period, to make it easier to test how your app behaves when the limit is reached. To set a new timeout period, run the following adb command:

adb shell device_config put activity_manager data_sync_fgs_timeout_duration duration-in-milliseconds

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

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

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

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

Ограничения на широковещательные приемники 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

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

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.

Изменения 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.getFirst();
}

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

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

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

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

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

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

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

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

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

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

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

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

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:

Kotlin

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

Java

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

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

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

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

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

Edge-to-edge enforcement

Приложения по умолчанию являются безграничными на устройствах под управлением Android 15, если приложение ориентировано на Android 15 (уровень API 35).

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


Приложение, предназначенное для Android 15 (уровень API 35) и обеспечивающее полную совместимость на устройстве Android 15. В этом приложении в основном используются компоненты Material 3 Compose, которые автоматически применяют вставки. На этот экран не оказывает негативного влияния поддержка Android 15 от края до края.

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

  • Панель навигации с помощью жестов
    • Прозрачный по умолчанию.
    • Смещение по нижнему краю отключено, поэтому содержимое отображается за системной панелью навигации, если не применяются вставки.
    • setNavigationBarColor и R.attr#navigationBarColor устарели и не влияют на навигацию с помощью жестов.
    • setNavigationBarContrastEnforced и R.attr#navigationBarContrastEnforced по-прежнему не влияют на навигацию с помощью жестов.
  • 3-кнопочная навигация
    • По умолчанию непрозрачность установлена ​​на 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 14 и не поддерживающее безграничное использование устройств с Android 15.
Приложение, предназначенное для Android 15 (уровень API 35) и обеспечивающее полную совместимость на устройстве Android 15. Однако многие элементы теперь скрыты строкой состояния, трехкнопочной панелью навигации или вырезом на дисплее из-за ограничений Android 15 от края до края. Скрытый пользовательский интерфейс включает верхнюю панель приложения Material 2, плавающие кнопки действий и элементы списка.
Приложение, предназначенное для 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 .
  • Могут быть экраны с меньшим трафиком и закрытым пользовательским интерфейсом. Убедитесь, что на этих менее посещаемых экранах пользовательский интерфейс не перекрыт. Экраны с низким трафиком включают в себя:
    • Экраны регистрации или входа в систему
    • Страницы настроек
Что проверить, если ваше приложение еще не является сквозным

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

  • Если ваше приложение использует компоненты Material 3 ( androidx.compose.material3 ) в компоновке, такие как TopAppBar , BottomAppBar и NavigationBar , эти компоненты, скорее всего, не пострадают, поскольку они автоматически обрабатывают вставки.
  • Если ваше приложение использует компоненты Material 2 ( androidx.compose.material ) в Compose, эти компоненты не обрабатывают вставки автоматически. Однако вы можете получить доступ к вставкам и применить их вручную. В androidx.compose.material 1.6.0 и более поздних версиях используйте параметр windowInsets , чтобы вручную применить вставки для BottomAppBar , TopAppBar , BottomNavigation и NavigationRail . Аналогичным образом используйте параметр contentWindowInsets для Scaffold .
  • Если ваше приложение использует представления и компоненты материалов ( com.google.android.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 .

Дополнительные сквозные ресурсы

Дополнительные сведения о применении вставок см. в руководствах « Просмотры от края до края» и «Композиция от края до края» .

Устаревшие API

Следующие API устарели, но не отключены:

Следующие API устарели и отключены:

Stable configuration

Если ваше приложение предназначено для 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

For apps targeting Android 15 (API level 35), the elegantTextHeight TextView attribute becomes true by default, replacing the compact font used by default with some scripts that have large vertical metrics with one that is much more readable. The compact font was introduced to prevent breaking layouts; Android 13 (API level 33) prevents many of these breakages by allowing the text layout to stretch the vertical height utilizing the fallbackLineSpacing attribute.

In Android 15, the compact font still remains in the system, so your app can set elegantTextHeight to false to get the same behavior as before, but it is unlikely to be supported in upcoming releases. So, if your app supports the following scripts: Arabic, Lao, Myanmar, Tamil, Gujarati, Kannada, Malayalam, Odia, Telugu or Thai, test your app by setting elegantTextHeight to true.

elegantTextHeight behavior for apps targeting Android 14 (API level 34) and lower.
elegantTextHeight behavior for apps targeting Android 15.

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

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

Поскольку это изменение влияет на то, как TextView определяет ширину, TextView по умолчанию выделяет большую ширину, если приложение предназначено для Android 15 (уровень API 35) или выше. Вы можете включить или отключить это поведение, вызвав 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 (уровень API 35), минимальная высота строки теперь зарезервирована для EditText , чтобы соответствовать эталонному шрифту для указанного языкового стандарта, как показано на следующем изображении:

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

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

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

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

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

Apps that target Android 15 (API level 35) must be the top app or running a foreground service in order to request audio focus. If an app attempts to request focus when it does not meet one of these requirements, the call returns AUDIOFOCUS_REQUEST_FAILED.

You can learn more about audio focus at Manage audio focus.

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

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

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

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

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

,

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

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

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

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

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

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

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

Android 15 introduces a new timeout behavior to dataSync for apps targeting Android 15 (API level 35) or higher. This behavior also applies to the new mediaProcessing foreground service type.

The system permits an app's dataSync services to run for a total of 6 hours in a 24-hour period, after which the system calls the running service's Service.onTimeout(int, int) method (introduced in Android 15). At this time, the service has a few seconds to call Service.stopSelf(). When Service.onTimeout() is called, the service is no longer considered a foreground service. If the service does not call Service.stopSelf(), the system throws an internal exception. The exception is logged in Logcat with the following message:

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

To avoid problems with this behavior change, you can do one or more of the following:

  1. Have your service implement the new Service.onTimeout(int, int) method. When your app receives the callback, make sure to call stopSelf() within a few seconds. (If you don't stop the app right away, the system generates a failure.)
  2. Make sure your app's dataSync services don't run for more than a total of 6 hours in any 24-hour period (unless the user interacts with the app, resetting the timer).
  3. Only start dataSync foreground services as a result of direct user interaction; since your app is in the foreground when the service starts, your service has the full six hours after the app goes to the background.
  4. Instead of using a dataSync foreground service, use an alternative API.

If your app's dataSync foreground services have run for 6 hours in the last 24, you cannot start another dataSync foreground service unless the user has brought your app to the foreground (which resets the timer). If you try to start another dataSync foreground service, the system throws ForegroundServiceStartNotAllowedException with an error message like "Time limit already exhausted for foreground service type dataSync".

Testing

To test your app's behavior, you can enable data sync timeouts even if your app is not targeting Android 15 (as long as the app is running on an Android 15 device). To enable timeouts, run the following adb command:

adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name

You can also adjust the timeout period, to make it easier to test how your app behaves when the limit is reached. To set a new timeout period, run the following adb command:

adb shell device_config put activity_manager data_sync_fgs_timeout_duration duration-in-milliseconds

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

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

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

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

Ограничения на широковещательные приемники 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

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

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.

Изменения 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.getFirst();
}

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

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

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

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

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

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

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

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

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

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

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

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

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:

Kotlin

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

Java

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

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

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

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

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

Edge-to-edge enforcement

Приложения по умолчанию являются безграничными на устройствах под управлением Android 15, если приложение ориентировано на Android 15 (уровень API 35).

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


Приложение, предназначенное для Android 15 (уровень API 35) и обеспечивающее полную совместимость на устройстве Android 15. В этом приложении в основном используются компоненты Material 3 Compose, которые автоматически применяют вставки. На этот экран не оказывает негативного влияния поддержка Android 15 от края до края.

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

  • Панель навигации с помощью жестов
    • Прозрачный по умолчанию.
    • Смещение по нижнему краю отключено, поэтому содержимое отображается за системной панелью навигации, если не применяются вставки.
    • setNavigationBarColor и R.attr#navigationBarColor устарели и не влияют на навигацию с помощью жестов.
    • setNavigationBarContrastEnforced и R.attr#navigationBarContrastEnforced по-прежнему не влияют на навигацию с помощью жестов.
  • 3-кнопочная навигация
    • По умолчанию непрозрачность установлена ​​на 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 14 и не поддерживающее безграничное использование устройств с Android 15.
Приложение, предназначенное для Android 15 (уровень API 35) и обеспечивающее полную совместимость на устройстве Android 15. Однако многие элементы теперь скрыты строкой состояния, трехкнопочной панелью навигации или вырезом на дисплее из-за ограничений Android 15 от края до края. Скрытый пользовательский интерфейс включает верхнюю панель приложения Material 2, плавающие кнопки действий и элементы списка.
Приложение, предназначенное для 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 .
  • Могут быть экраны с меньшим трафиком и закрытым пользовательским интерфейсом. Убедитесь, что на этих менее посещаемых экранах пользовательский интерфейс не перекрыт. Экраны с низким трафиком включают в себя:
    • Экраны регистрации или входа в систему
    • Страницы настроек
Что проверить, если ваше приложение еще не является сквозным

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

  • Если ваше приложение использует компоненты Material 3 ( androidx.compose.material3 ) в компоновке, такие как TopAppBar , BottomAppBar и NavigationBar , эти компоненты, скорее всего, не пострадают, поскольку они автоматически обрабатывают вставки.
  • Если ваше приложение использует компоненты Material 2 ( androidx.compose.material ) в Compose, эти компоненты не обрабатывают вставки автоматически. Однако вы можете получить доступ к вставкам и применить их вручную. В androidx.compose.material 1.6.0 и более поздних версиях используйте параметр windowInsets , чтобы вручную применить вставки для BottomAppBar , TopAppBar , BottomNavigation и NavigationRail . Аналогичным образом используйте параметр contentWindowInsets для Scaffold .
  • Если ваше приложение использует представления и компоненты материалов ( com.google.android.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 .

Дополнительные сквозные ресурсы

Дополнительные сведения о применении вставок см. в руководствах « Просмотры от края до края» и «Композиция от края до края» .

Устаревшие API

Следующие API устарели, но не отключены:

Следующие API устарели и отключены:

Stable configuration

Если ваше приложение предназначено для 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

For apps targeting Android 15 (API level 35), the elegantTextHeight TextView attribute becomes true by default, replacing the compact font used by default with some scripts that have large vertical metrics with one that is much more readable. The compact font was introduced to prevent breaking layouts; Android 13 (API level 33) prevents many of these breakages by allowing the text layout to stretch the vertical height utilizing the fallbackLineSpacing attribute.

In Android 15, the compact font still remains in the system, so your app can set elegantTextHeight to false to get the same behavior as before, but it is unlikely to be supported in upcoming releases. So, if your app supports the following scripts: Arabic, Lao, Myanmar, Tamil, Gujarati, Kannada, Malayalam, Odia, Telugu or Thai, test your app by setting elegantTextHeight to true.

elegantTextHeight behavior for apps targeting Android 14 (API level 34) and lower.
elegantTextHeight behavior for apps targeting Android 15.

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

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

Поскольку это изменение влияет на то, как TextView определяет ширину, TextView по умолчанию выделяет большую ширину, если приложение предназначено для Android 15 (уровень API 35) или выше. Вы можете включить или отключить это поведение, вызвав 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 (уровень API 35), минимальная высота строки теперь зарезервирована для EditText , чтобы соответствовать эталонному шрифту для указанного языкового стандарта, как показано на следующем изображении:

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

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

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

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

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

Apps that target Android 15 (API level 35) must be the top app or running a foreground service in order to request audio focus. If an app attempts to request focus when it does not meet one of these requirements, the call returns AUDIOFOCUS_REQUEST_FAILED.

You can learn more about audio focus at Manage audio focus.

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

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

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

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

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