<layar yang kompatibel>
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
- sintaksis:
-
<compatible-screens>
<screen android:screenSize=["small" | "normal" | "large" | "xlarge"]
android:screenDensity=["ldpi" | "mdpi" | "hdpi" | "xhdpi"
| "280" | "360" | "420" | "480" | "560" ] />
...
</compatible-screens>
- terdapat dalam:
<manifest>- deskripsi:
- Menentukan setiap konfigurasi layar yang kompatibel dengan aplikasi. Hanya satu instance
dari elemen
<compatible-screens> yang diizinkan dalam manifes, tetapi manifes dapat
berisi beberapa elemen <screen>. Setiap elemen <screen>
menetapkan kombinasi kepadatan ukuran layar tertentu dengan kepadatan yang kompatibel untuk aplikasi.
Sistem Android tidak membaca elemen manifes <compatible-screens>
di setiap titik. Elemen ini hanya bersifat informatif dan digunakan oleh
layanan eksternal, seperti Google Play, untuk lebih memahami kompatibilitas
aplikasi dengan konfigurasi layar tertentu dan memungkinkan pemfilteran bagi pengguna.
Semua konfigurasi layar yang
tidak dideklarasikan dalam elemen ini merupakan layar yang tidak kompatibel
dengan aplikasi. Layanan eksternal, seperti Google Play, tidak menyediakan aplikasi ke
perangkat dengan layar tersebut.
Perhatian: Biasanya, Anda tidak menggunakan elemen
manifes ini. Menggunakan elemen ini dapat menurunkan potensi basis pengguna untuk aplikasi
Anda secara signifikan dengan mencegah pengguna menginstal aplikasi jika mereka memiliki perangkat dengan konfigurasi
layar yang tidak Anda cantumkan. Gunakan elemen ini hanya sebagai opsi terakhir ketika
aplikasi benar-benar tidak berfungsi dengan konfigurasi layar tertentu. Daripada menggunakan elemen
ini, ikuti panduan untuk mendukung beberapa layar
guna memberikan dukungan yang dapat disesuaikan untuk beberapa layar menggunakan bitmap dan tata letak alternatif
untuk berbagai ukuran dan kepadatan layar.
Jika ingin menetapkan ukuran layar minimum untuk aplikasi Anda, gunakan elemen <supports-screens>. Misalnya, jika Anda ingin aplikasi hanya
tersedia untuk perangkat layar besar dan ekstra besar, elemen <supports-screens> akan mengizinkan
Anda mendeklarasikan bahwa aplikasi tidak mendukung ukuran layar kecil dan normal.
Selanjutnya, layanan eksternal seperti Google Play akan memfilter aplikasi Anda. Anda juga dapat menggunakan
elemen <supports-screens> untuk mendeklarasikan apakah sistem harus mengubah ukuran aplikasi
Anda bagi ukuran layar yang berbeda.
Untuk mengetahui informasi selengkapnya tentang cara Google Play memfilter aplikasi menggunakan elemen
manifes ini dan elemen manifes lainnya, lihat Filter di Google Play.
- elemen turunan:
-
<screen>Menentukan konfigurasi layar tunggal yang kompatibel dengan aplikasi.
Minimal satu instance elemen ini harus ditempatkan dalam elemen
<compatible-screens>. Elemen ini harus menyertakan atribut android:screenSize dan
android:screenDensity. Jika Anda tidak mendeklarasikan kedua
atribut, elemen akan diabaikan.
Atribut:
android:screenSize- Wajib. Menentukan ukuran layar untuk konfigurasi layar ini.
Nilai yang diterima:
smallnormallargexlarge
Untuk mengetahui informasi tentang berbagai ukuran layar, lihat Ringkasan kompatibilitas layar.
android:screenDensity- Wajib. Menentukan kepadatan layar untuk konfigurasi layar ini.
Nilai yang diterima:
"ldpi" (sekitar 120 dpi)"mdpi" (sekitar 160 dpi)"hdpi" (sekitar 240 dpi)"xhdpi" (sekitar 320 dpi)"280""360""420""480""560"
Untuk mengetahui informasi berbagai kepadatan layar, lihat Ringkasan kompatibilitas layar.
- contoh
-
Jika aplikasi hanya kompatibel dengan layar berukuran
kecil dan normal, berapa pun kepadatan layarnya, Anda harus menetapkan 12 elemen <screen>
karena setiap ukuran layar memiliki enam konfigurasi kepadatan yang berbeda.
Anda harus mendeklarasikan
tiap-tiapnya. Kombinasi ukuran dan kepadatan yang tidak Anda tetapkan akan dianggap sebagai konfigurasi
layar yang tidak kompatibel dengan aplikasi Anda. Berikut tampilan entri
manifes yang akan Anda jumpai jika aplikasi hanya kompatibel dengan layar berukuran kecil dan normal:
<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>
- diperkenalkan di:
- API level 9
- lihat juga:
- Ringkasan kompatibilitas layar
- Filter di Google Play
Konten dan contoh kode di halaman ini tunduk kepada lisensi yang dijelaskan dalam Lisensi Konten. Java dan OpenJDK adalah merek dagang atau merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-27 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 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)"]]
