권장사항

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

폴더블 및 멀티스크린 기기용 앱

일반적으로 앱은 일부 디스플레이 ID에 종속되는 정적 식별자나 논리에 의존하면 안 됩니다. 대부분의 경우 앱은 크기가 변경되어야 하고 여러 디스플레이에서 작동해야 하며 시스템은 앱을 어디서 찾아야 할지 제어해야 합니다. 폴더블 기기를 위한 새롭고 고유한 환경을 빌드하고 기기가 접혔을 때 외부 화면에 특수 앱을 실행해야 하는 경우를 예로 들 수 있습니다.

이 경우 SystemUI 또는 다른 시스템 구성요소는 접힘을 감지하고 작업을 수행해도 괜찮은지 판단한 다음 타겟 활동을 실행하고 외부 디스플레이 ID를 실행 타겟으로 지정해야 합니다. 앱은 이에 대한 반응으로 이 작업을 감지하거나 어떠한 작업도 수행하면 안 되며, 이어서 구체적인 디스플레이에서 실행 작업을 수행해도 안 됩니다. 즉, 기기에서 작동하는 작업이 다른 기기에서도 작동할 것이라고 가정하면 안 됩니다. 간단히 말해 기기별 코드는 세분화 증가로 이어집니다.

디스플레이에 대한 액세스 제한

기기 구성에서 1개 이상의 디스플레이에 대한 액세스 제한을 요구하는 경우에는 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()를 참조하세요.

디스플레이를 식별하려면 고유 ID(기본적으로 DisplayInfo#uniqueId를 사용) 또는 하드웨어 디스플레이의 실제 ID를 사용하세요(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이 사용되었으며, 시뮬레이션된 디스플레이에서는 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>

자세한 내용은 정적 디스플레이 식별자를 참고하세요.

자세한 내용은 다음을 참조하세요.