Рекомендации

Приложения для складных и многоэкранных устройств

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

В этом случае SystemUI (или другой компонент системы) должен обнаружить сгиб, определить, целесообразно ли выполнить действие, а затем запустить целевую активность и указать внешний идентификатор дисплея в качестве цели запуска. Приложения не должны обнаруживать это действие или выполнять какие-либо действия в ответ, а затем выполнять запуск на определенном дисплее. Другими словами, не предполагайте, что то, что работает на одном устройстве, будет работать и на других устройствах. Короче говоря, код, специфичный для устройства, увеличивает фрагментацию.

Ограничить доступ к дисплеям

Если конфигурация устройства требует ограничения доступа к одному или нескольким дисплеям, рекомендуется использовать флаг Display#FLAG_PRIVATE для обозначения таких дисплеев как закрытых . Это ограничивает всех, кроме владельца, в возможности добавлять содержимое на дисплей. Любая попытка запустить действие или добавить окно кем-либо, кроме владельца, приводит к SecurityException . Если система владеет дисплеем, она может добавлять окна и запускать действия.

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

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

Более подробную информацию см. здесь:

  • ActivityStackSupervisor#isCallerAllowedToLaunchOnDisplay()
  • ActivityDisplay#isUidPresent()
  • DisplayManagerService#isUidPresentOnDisplay()

Для условного управления запуском активности используйте LaunchParamsController , который перехватывает все запуски активности и позволяет системному компоненту изменять параметры, используемые для запуска. Это доступно в system_server .

Настройте параметры отображения окон и системные декорации

Системные декорации можно настроить для каждого дисплея в DisplayWindowSettings . Реализация устройства может предоставить конфигурацию по умолчанию в /data/system/display_settings.xml .

Это значение определяет, будут ли отображаться на дисплее системные украшения (панель запуска, обои, панель навигации и другие окна декора) и IME. Подробности см. DisplayWindowSettings#shouldShowSystemDecorsLocked() и DisplayWindowSettings#shouldShowImeLocked() .

Для идентификации дисплея используйте уникальный идентификатор (по умолчанию используется DisplayInfo#uniqueId ) или идентификатор физического порта для аппаратных дисплеев (см. DisplayInfo#address ).

Например, следующий пример конфигурации дисплея включает системные декорации и IME на имитируемом дисплее:

<?xml version='1.0' encoding='utf-8' standalone='yes' ?>
<display-settings>
<config identifier="0" />
<display
  name="overlay:1"
  shouldShowSystemDecors="true"
  shouldShowIme="true" />
</display-settings>

В приведенном выше примере uniqueId используется для идентификации дисплея в атрибуте name, который для имитируемого дисплея равен overlay:1 . Для встроенного дисплея примерным значением может быть "local:45354385242535243453" . Другой вариант — использовать информацию об аппаратном порте и задать identifier="1" для соответствия DisplayWindowSettings#IDENTIFIER_PORT , а затем обновить имя, чтобы использовать формат "port:<port_id>" :

<?xmlversion='1.0' encoding='utf-8' standalone='yes' ?>
<display-settings>
<config identifier="1" />
<display
  name="port:12345"
  shouldShowSystemDecors="true"
  shouldShowIme="true" />
</display-settings>

Подробную информацию см. в разделе Статические идентификаторы отображения .

Более подробную информацию см. здесь: