Bergabunglah bersama kami di ⁠#Android11: The Beta Launch Show pada tanggal 3 Juni!

<compatible-screens>

sintaks:
    <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 boleh 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> (baik pada waktu penginstalan maupun waktu proses). Elemen ini hanya bersifat informatif dan dapat 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 adalah layar yang tidak kompatibel dengan aplikasi. Oleh karena itu, layanan eksternal (seperti Google Play) tidak boleh menyediakan aplikasi ke perangkat dengan layar seperti yang dijelaskan sebelumnya.

Perhatian: Umumnya, Anda tidak boleh menggunakan elemen manifes ini. Menggunakan elemen ini dapat menurunkan potensi basis pengguna untuk aplikasi Anda secara signifikan, karena pengguna menjadi tidak dapat menginstal aplikasi Anda apabila perangkatnya memiliki konfigurasi layar yang belum Anda cantumkan. Anda hanya boleh menggunakannya sebagai opsi terakhir saat aplikasi benar-benar tidak dapat berfungsi dengan konfigurasi layar tertentu. Daripada menggunakan elemen ini, sebaiknya ikuti panduan untuk Mendukung Beberapa Layar guna memberikan dukungan yang dapat disesuaikan bagi beberapa layar menggunakan bitmap dan tata letak alternatif untuk berbagai ukuran dan kepadatan layar.

Jika ingin menetapkan ukuran layar minimal saja bagi aplikasi Anda, gunakan elemen <supports-screens>. Misalnya, jika Anda ingin aplikasi hanya tersedia untuk perangkat berlayar besar dan ekstra besar, elemen <supports-screens> akan memungkinkan Anda mendeklarasikan bahwa aplikasi tidak mendukung ukuran layar kecil dan normal. Layanan eksternal (seperti Google Play) akan memfilter aplikasi Anda sesuai ketentuan tersebut. Anda juga dapat menggunakan elemen <supports-screens> untuk mendeklarasikan apakah sistem harus mengubah ukuran aplikasi Anda bagi ukuran layar yang berbeda.

Lihat juga dokumen Filter di Google Play untuk mengetahui informasi selengkapnya tentang cara Google Play memfilter aplikasi menggunakan elemen manifes ini dan elemen manifes lainnya.

elemen turunan:
<screen>
Menentukan konfigurasi layar tunggal yang kompatibel dengan aplikasi.

Setidaknya 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:

  • small
  • normal
  • large
  • xlarge

Untuk mengetahui informasi tentang berbagai ukuran layar, lihat Mendukung Beberapa 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 tentang berbagai kepadatan layar, lihat Mendukung Beberapa Layar.

contoh

Jika aplikasi hanya kompatibel dengan layar berukuran kecil dan normal, berapa pun kepadatan layarnya, Anda harus menetapkan dua belas elemen <screen> yang berbeda, karena setiap ukuran layar memiliki enam konfigurasi kepadatan yang berbeda. Anda harus mendeklarasikan tiap-tiapnya; setiap 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 pada:
API Level 9
lihat juga:
Mendukung Beberapa Layar
Filter di Google Play