相容螢幕(<螢幕)>

語法:
<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> 元素,但可包含多個 <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:screenSizeandroid:screenDensity 屬性。如未宣告這兩項屬性,系統會忽略該元素。

屬性:

android:screenSize
必要。指定這項螢幕設定的螢幕大小。

接受的值:

  • small
  • normal
  • large
  • xlarge

如需不同螢幕尺寸的詳細資訊,請參閱「螢幕相容性總覽」。

android:screenDensity
必要。指定這項螢幕設定的螢幕密度。

接受的值:

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

如需不同螢幕密度的詳細資訊,請參閱「螢幕相容性總覽」。

示例

如果您的應用程式只與小型螢幕和一般螢幕相容 (無論螢幕密度為何),您必須指定 12 個 <screen> 元素,因為每種螢幕大小有六種不同的密度設定。

您必須逐一宣告每個元素。系統會將所有「未指定」的大小和密度組合,視為與應用程式「不相容」的螢幕設定。如果您的應用程式僅與小螢幕和一般螢幕相容,資訊清單項目會如下所示:

<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 的篩選功能