<호환-화면>

문법:
<compatible-screens>
    <screen android:screenSize=["small" | "normal" | "large" | "xlarge"]
            android:screenDensity=["ldpi" | "mdpi" | "hdpi" | "xhdpi"
                                   | "280" | "360" | "420" | "480" | "560" ] />
    ...
</compatible-screens>
포함된 위치:
<manifest>
설명
애플리케이션이 호환되는 각 화면 구성을 지정합니다. 매니페스트에는 <compatible-screens> 요소의 인스턴스 1개만 허용되지만 <screen> 요소는 여러 개 포함할 수 있습니다. 각 <screen> 요소는 애플리케이션이 호환되는 특정 화면 크기-밀도 조합을 지정합니다.

Android 시스템은 어떤 시점에서도 <compatible-screens> 매니페스트 요소를 읽지 않습니다. 이 요소는 정보 제공의 목적으로만 사용되며 Google Play와 같은 외부 서비스에서 특정 화면 구성과의 애플리케이션 호환성을 더 잘 이해하고 사용자 필터링을 사용 설정하기 위해 사용됩니다.

이 요소에 선언되지 않은 모든 화면 구성은 애플리케이션이 호환되지 않는 화면입니다. Google Play와 같은 외부 서비스는 이러한 화면이 있는 기기에 애플리케이션을 제공하지 않습니다.

주의: 일반적으로 이 매니페스트 요소는 사용하지 않습니다. 이 요소를 사용하면 나열되지 않은 화면 구성이 적용된 기기가 사용자에게 있는 경우 사용자가 애플리케이션을 설치하지 못하게 하여 애플리케이션의 잠재적 사용자층을 크게 줄일 수 있습니다. 애플리케이션이 특정 화면 구성에서 전혀 작동하지 않을 때 최후의 수단으로만 사용하세요. 이 요소를 사용하는 대신 여러 화면 지원 가이드에 따라 다양한 화면 크기 및 밀도용 대체 레이아웃과 비트맵을 사용하여 여러 화면을 위한 확장 가능한 지원을 제공합니다.

애플리케이션의 최소 화면 크기를 설정하려면 <supports-screens> 요소를 사용하세요. 예를 들어 대형 및 초대형 화면 기기에만 애플리케이션을 제공하려는 경우 <supports-screens> 요소를 사용하면 애플리케이션이 소형 및 일반 화면 크기를 지원하지 않는다고 선언할 수 있습니다. 그러면 Google Play와 같은 외부 서비스에서 적절히 애플리케이션을 필터링합니다. 또한 <supports-screens> 요소를 사용해 시스템에서 다른 화면 크기에 맞게 애플리케이션 크기를 조절할 수 있는지 선언할 수 있습니다.

Google Play에서 이 매니페스트 요소와 다른 매니페스트 요소를 사용하여 애플리케이션을 필터링하는 방법에 관한 자세한 내용은 Google Play 필터를 참고하세요.

하위 요소
<screen>

애플리케이션이 호환되는 단일 화면 구성을 지정합니다.

이 요소의 인스턴스 중 하나 이상이 <compatible-screens> 요소 내에 있어야 합니다. 이 요소에는 android:screenSize 속성과 android:screenDensity 속성이 모두 포함되어야 합니다. 두 속성을 모두 선언하지 않으면 요소가 무시됩니다.

속성:

android:screenSize
필수사항. 이 화면 구성의 화면 크기를 지정합니다.

허용되는 값은 다음과 같습니다.

  • small
  • normal
  • large
  • xlarge

다양한 화면 크기에 관한 자세한 내용은 화면 호환성 개요를 참고하세요.

android:screenDensity
필수사항. 이 화면 구성의 화면 밀도를 지정합니다.

허용되는 값은 다음과 같습니다.

  • "ldpi"(약 120DPI)
  • "mdpi"(약 160DPI)
  • "hdpi"(약 240DPI)
  • "xhdpi"(약 320DPI)
  • "280"
  • "360"
  • "420"
  • "480"
  • "560"

다양한 화면 밀도에 관한 자세한 내용은 화면 호환성 개요를 참고하세요.

예

애플리케이션이 화면 밀도와 상관없이 소형 및 일반 화면과만 호환되는 경우 각 화면 크기에 서로 다른 밀도 구성이 6개 있으므로 <screen> 요소를 12개 지정해야 합니다.

각각 모두 선언해야 합니다. 지정하지 않은 크기와 밀도의 조합은 애플리케이션이 호환되지 않는 화면 구성으로 간주됩니다. 애플리케이션이 소형 및 일반 화면과만 호환되는 경우 매니페스트 항목은 다음과 같습니다.

<manifest ... >
    ...
    <compatible-screens>
        <!-- all small size screens -->
        <screen android:screenSize="small" android:screenDensity="ldpi" />
        <screen android:screenSize="small" android:screenDensity="mdpi" />
        <screen android:screenSize="small" android:screenDensity="hdpi" />
        <screen android:screenSize="small" android:screenDensity="xhdpi" />
        <screen android:screenSize="small" android:screenDensity="xxhdpi" />
        <screen android:screenSize="small" android:screenDensity="xxxhdpi" />
        <!-- all normal size screens -->
        <screen android:screenSize="normal" android:screenDensity="ldpi" />
        <screen android:screenSize="normal" android:screenDensity="mdpi" />
        <screen android:screenSize="normal" android:screenDensity="hdpi" />
        <screen android:screenSize="normal" android:screenDensity="xhdpi" />
        <screen android:screenSize="normal" android:screenDensity="xxhdpi" />
        <screen android:screenSize="normal" android:screenDensity="xxxhdpi" />
    </compatible-screens>
    <application ... >
        ...
    <application>
</manifest>
도입 수준:
API 수준 9
참고 항목:
화면 호환성 개요
Google Play 필터