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

Android 시스템에서는 설치 시점과 런타임 시점에 <compatible-screens> manifest 요소를 읽지 않습니다. 이 요소는 정보 제공의 목적으로만 사용되며 Google Play와 같은 외부 서비스에서 특정 화면 구성과의 애플리케이션 호환성을 더 잘 이해하고 사용자 필터링을 사용 설정하기 위해 사용할 수 있습니다. 이 요소에 선언되지 않은 모든 화면 구성은 애플리케이션이 호환되지 않는 화면입니다. 따라서 Google Play와 같은 외부 서비스는 이러한 화면이 있는 기기에 애플리케이션을 제공해서는 안 됩니다.

주의: 일반적으로 이 manifest 요소를 사용해서는 안 됩니다. 이 요소를 사용하면 사용자가 화면 구성이 목록에 없는 기기를 사용하는 경우 애플리케이션을 설치할 수 없으므로 애플리케이션의 잠재적 사용자층이 현저히 줄어들 수 있습니다. 따라서 이 요소는 애플리케이션이 특정 화면 구성에서 전혀 작동하지 않을 때 최후의 수단으로만 사용해야합니다. 이 요소를 사용하는 대신 여러 화면 지원 가이드에 따라 다양한 화면 크기 및 밀도용 대체 레이아웃과 비트맵을 사용하여 여러 화면을 위한 확장 가능한 지원을 제공해야 합니다.

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

또한 Google Play에서 이 manifest 요소와 다른 manifest 요소를 사용하여 애플리케이션을 필터링하는 방법에 관한 자세한 내용은 Google Play 필터 문서를 참조하세요.

하위 요소
<screen>
애플리케이션이 호환되는 단일 화면 구성을 지정합니다.

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

속성

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

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

  • small
  • normal
  • large
  • xlarge

다양한 화면 크기에 관한 자세한 내용은 여러 화면 지원을 참조하세요.

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

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

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

다양한 화면 밀도에 관한 자세한 내용은 여러 화면 지원을 참조하세요.

애플리케이션이 화면 밀도와 상관없이 소형 및 보통 화면과만 호환되는 경우 각 화면 크기에 6개의 서로 다른 밀도 구성이 있으므로 12개의 다른 <screen> 요소를 지정해야 합니다. 이러한 각 요소를 선언해야 하며, 지정하지 않은 크기와 밀도의 조합은 애플리케이션이 호환되지 않는 화면 구성으로 간주됩니다. 애플리케이션이 소형 및 보통 화면과만 호환되는 경우 manifest 항목은 다음과 같습니다.

    <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 필터