Android Developers

語法：

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

子元素：

示例

如果您的應用程式只與小型螢幕和一般螢幕相容 (無論螢幕密度為何)，您必須指定 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 的篩選功能