<zgodne-ekrany>
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
- składnia:
-
<compatible-screens>
<screen android:screenSize=["small" | "normal" | "large" | "xlarge"]
android:screenDensity=["ldpi" | "mdpi" | "hdpi" | "xhdpi"
| "280" | "360" | "420" | "480" | "560" ] />
...
</compatible-screens>
- zawarte w:
<manifest>- description:
- Określa każdą konfigurację ekranu, z którą jest zgodna aplikacja. Tylko jedna instancja
elementu
<compatible-screens> jest dozwolony w pliku manifestu, ale może
zawierają wiele elementów <screen>. Każdy element <screen>
określa określoną kombinację rozmiaru ekranu, z którą aplikacja jest zgodna.
System Android nie odczytuje pliku manifestu <compatible-screens>
w dowolnym momencie. Ten element ma wyłącznie charakter informacyjny i jest używany
przez usługi zewnętrzne, takie jak Google Play, aby lepiej poznać zgodność aplikacji
z określonymi konfiguracjami ekranu oraz aby włączyć filtrowanie użytkowników.
Dowolną konfigurację ekranu,
nie jest zadeklarowane w tym elemencie, to ekran, na którym aplikacja nie
są zgodne. Usługi zewnętrzne, np. Google Play, nie dostarczają aplikacji do
urządzeń z takimi ekranami.
Uwaga: normalnie nie używasz tego pliku manifestu.
. Użycie tego elementu może znacznie zmniejszyć liczbę potencjalnych użytkowników
aplikacji, uniemożliwiając użytkownikom instalowanie aplikacji, jeśli mają urządzenie z ekranem.
konfiguracji, których nie ma na liście. Należy z niej korzystać tylko w ostateczności, gdy
Aplikacja absolutnie nie działa z określonymi konfiguracjami ekranu. Zamiast tego
postępuj zgodnie z instrukcjami z przewodnika po obsłudze wielu ekranów,
zapewniają skalowalną obsługę wielu ekranów dzięki alternatywnym układom i mapom bitowym.
do różnych rozmiarów i gęstości ekranu.
Jeśli chcesz ustawić minimalny rozmiar ekranu swojej aplikacji, użyj elementu <supports-screens>. Jeśli na przykład chcesz, aby Twoja aplikacja była dostępna
tylko w przypadku urządzeń z dużym i bardzo dużym ekranem, element <supports-screens> pozwala
zadeklarujesz, że Twoja aplikacja nie obsługuje małych i zwykłych rozmiarów ekranów.
Następnie usługi zewnętrzne, takie jak Google Play, odpowiednio filtrują Twoją aplikację. Możesz też użyć usługi
<supports-screens> element określający, czy system może zmienić rozmiar
do różnych rozmiarów ekranu.
Więcej informacji o tym, jak Google Play filtruje aplikacje za pomocą tego
inne elementy manifestu znajdziesz w artykule Filtry w Google Play.
- elementy podrzędne:
-
<screen>Określa konfigurację pojedynczego ekranu, z którą aplikacja jest zgodna.
Co najmniej 1 wystąpienie tego elementu musi znajdować się wewnątrz elementu <compatible-screens>
. Ten element musi zawierać zarówno android:screenSize, jak i
android:screenDensity. Jeśli nie zadeklarujesz obu
, element jest ignorowany.
Atrybuty:
android:screenSize- Wymagane. Określa rozmiar ekranu na potrzeby tej konfiguracji ekranu.
Akceptowane wartości:
smallnormallargexlarge
Informacje o różnych rozmiarach ekranów znajdziesz w artykule Omówienie zgodności ekranu.
android:screenDensity- Wymagane. Określa gęstość ekranu na potrzeby tej konfiguracji ekranu.
Akceptowane wartości:
"ldpi" (ok. 120 dpi)"mdpi" (ok. 160 dpi)"hdpi" (ok. 240 dpi)"xhdpi" (ok. 320 dpi)"280""360""420""480""560"
Informacje o różnych gęstościach ekranu znajdziesz w artykule Omówienie zgodności ekranu.
- przykład
-
Jeśli Twoja aplikacja jest zgodna tylko z małymi i zwykłymi ekranami, niezależnie od
gęstości ekranu, musisz określić 12 elementów <screen>,
bo każdy rozmiar ekranu ma 6 różnych konfiguracji gęstości.
Musisz zadeklarować każdy z
ich. Każda kombinacja rozmiaru i gęstości, której nie określisz, jest uznawana za ekran.
konfiguracja, z którą Twoja aplikacja nie jest zgodna. Plik manifestu zawiera
Wygląda na to, że Twoja aplikacja jest zgodna tylko z małymi i zwykłymi ekranami:
<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>
- wprowadzone w:
- Poziom API 9
- zobacz też:
- Omówienie zgodności ekranu
- Filtry w Google Play
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-27 UTC.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-07-27 UTC."],[],[],null,["# <compatible-screens\u003e\n\nsyntax:\n:\n\n ```xml\n \u003ccompatible-screens\u003e\n \u003cscreen android:screenSize=[\"small\" | \"normal\" | \"large\" | \"xlarge\"]\n android:screenDensity=[\"ldpi\" | \"mdpi\" | \"hdpi\" | \"xhdpi\"\n | \"280\" | \"360\" | \"420\" | \"480\" | \"560\" ] /\u003e\n ...\n \u003c/compatible-screens\u003e\n ```\n\ncontained in:\n: [\u003cmanifest\u003e](/guide/topics/manifest/manifest-element)\n\ndescription:\n: Specifies each screen configuration with which the application is compatible. Only one instance\n of the `\u003ccompatible-screens\u003e` element is allowed in the manifest, but it can\n contain multiple `\u003cscreen\u003e` elements. Each `\u003cscreen\u003e` element\n specifies a specific screen size-density combination with which the application is compatible.\n\n The Android system *doesn't* read the `\u003ccompatible-screens\u003e` manifest\n element at any point. This element is informational only and is used\n by external services, such as Google Play, to better understand the application's compatibility\n with specific screen configurations and to enable filtering for users.\n\n\n Any screen configuration that\n *isn't* declared in this element is a screen with which the application *isn't*\n compatible. External services, such as Google Play, don't provide the application to\n devices with such screens.\n\n\n **Caution:** Normally, *you don't use this manifest\n element* . Using this element can dramatically reduce the potential user base for your\n application by preventing users from installing your application if they have a device with a screen\n configuration that you don't list. Use it only as a last resort, when the\n application absolutely doesn't work with specific screen configurations. Instead of using this\n element, follow the guide to [supporting multiple screens](/guide/practices/screens_support) to\n provide scalable support for multiple screens using alternative layouts and bitmaps\n for different screen sizes and densities.\n\n\n If you want to set a minimum screen size for your your application, use the [`\u003csupports-screens\u003e`](/guide/topics/manifest/supports-screens-element) element. For example, if you want your application to be available\n only for large and extra-large screen devices, the `\u003csupports-screens\u003e` element lets\n you declare that your application doesn't support small and normal screen sizes.\n Then, external services like Google Play filter your application accordingly. You can also use the\n `\u003csupports-screens\u003e` element to declare whether the system can resize your\n application for different screen sizes.\n\n\n For more information about how Google Play filters applications using this and\n other manifest elements, see [Filters on Google Play](/google/play/filters).\n\n\nchild elements:\n:\n\n `\u003cscreen\u003e`\n\n : Specifies a single screen configuration with which the application is compatible.\n\n At least one instance of this element must be placed inside the `\u003ccompatible-screens\u003e`\n element. This element must include both the `android:screenSize` and\n `android:screenDensity` attributes. If you don't declare both\n attributes, then the element is ignored.\n\n Attributes:\n\n `android:screenSize`\n : **Required.** Specifies the screen size for this screen configuration.\n\n Accepted values:\n\n - `small`\n - `normal`\n - `large`\n - `xlarge`\n\n\n For information about the different screen sizes, see [Screen compatibility overview](/guide/practices/screens_support#sizes).\n\n `android:screenDensity`\n : **Required.** Specifies the screen density for this screen configuration.\n\n Accepted values:\n\n - `\"ldpi\"` (approximately 120 dpi)\n - `\"mdpi\"` (approximately 160 dpi)\n - `\"hdpi\"` (approximately 240 dpi)\n - `\"xhdpi\"` (approximately 320 dpi)\n - `\"280\"`\n - `\"360\"`\n - `\"420\"`\n - `\"480\"`\n - `\"560\"`\n\n\n For information about the different screen densities, see [Screen compatibility overview](/guide/practices/screens_support#density).\n\n\nexample\n\n: If your application is compatible with only small and normal screens, regardless\n of screen density, then you must specify 12 `\u003cscreen\u003e` elements,\n because each screen size has six different density configurations.\n\n You must declare each one of\n these. Any combination of size and density that you *don't* specify is considered a screen\n configuration with which your application *isn't* compatible. Here's what the manifest\n entry looks like if your application is compatible with only small and normal screens: \n\n ```xml\n \u003cmanifest ... \u003e\n ...\n \u003ccompatible-screens\u003e\n \u003c!-- all small size screens --\u003e\n \u003cscreen android:screenSize=\"small\" android:screenDensity=\"ldpi\" /\u003e\n \u003cscreen android:screenSize=\"small\" android:screenDensity=\"mdpi\" /\u003e\n \u003cscreen android:screenSize=\"small\" android:screenDensity=\"hdpi\" /\u003e\n \u003cscreen android:screenSize=\"small\" android:screenDensity=\"xhdpi\" /\u003e\n \u003cscreen android:screenSize=\"small\" android:screenDensity=\"xxhdpi\" /\u003e\n \u003cscreen android:screenSize=\"small\" android:screenDensity=\"xxxhdpi\" /\u003e\n \u003c!-- all normal size screens --\u003e\n \u003cscreen android:screenSize=\"normal\" android:screenDensity=\"ldpi\" /\u003e\n \u003cscreen android:screenSize=\"normal\" android:screenDensity=\"mdpi\" /\u003e\n \u003cscreen android:screenSize=\"normal\" android:screenDensity=\"hdpi\" /\u003e\n \u003cscreen android:screenSize=\"normal\" android:screenDensity=\"xhdpi\" /\u003e\n \u003cscreen android:screenSize=\"normal\" android:screenDensity=\"xxhdpi\" /\u003e\n \u003cscreen android:screenSize=\"normal\" android:screenDensity=\"xxxhdpi\" /\u003e\n \u003c/compatible-screens\u003e\n \u003capplication ... \u003e\n ...\n \u003capplication\u003e\n \u003c/manifest\u003e\n ```\n\nintroduced in:\n: API level 9\n\nsee also:\n: [Screen compatibility overview](/guide/practices/screens_support)\n: [Filters on Google Play](/google/play/filters)"]]
