Halaman ini diterjemahkan oleh Cloud Translation API.

Ringkasan kompatibilitas perangkat

Android dirancang untuk berjalan di berbagai perangkat, seperti ponsel, tablet, dan TV. Berbagai perangkat memberikan potensi audiens yang sangat besar untuk aplikasi Anda. Agar berhasil di semua perangkat, aplikasi harus mentoleransi variasi fitur dan menyediakan antarmuka pengguna fleksibel yang beradaptasi dengan berbagai konfigurasi layar.

Untuk membantu kompatibilitas perangkat, Android menyediakan framework aplikasi dinamis tempat Anda dapat menyediakan resource aplikasi khusus konfigurasi dalam file statis, seperti tata letak XML yang berbeda untuk ukuran layar yang berbeda. Android kemudian memuat resource yang sesuai berdasarkan konfigurasi perangkat saat ini. Dengan mempertimbangkan desain aplikasi dan resource aplikasi tambahan, Anda dapat memublikasikan satu paket aplikasi (APK) yang mengoptimalkan pengalaman pengguna di berbagai perangkat.

Namun, jika perlu, Anda dapat menentukan persyaratan fitur aplikasi dan mengontrol jenis perangkat yang dapat menginstal aplikasi Anda dari Google Play Store. Dokumen ini menjelaskan cara mengontrol perangkat yang dapat mengakses aplikasi Anda dan cara menyiapkan aplikasi untuk menjangkau audiens yang tepat.

Apa yang dimaksud dengan “kompatibilitas”?

Sehubungan dengan pengembangan Android, ada dua jenis kompatibilitas: kompatibilitas perangkat dan kompatibilitas aplikasi.

Karena Android adalah project open source, setiap produsen hardware dapat mem-build perangkat yang menjalankan sistem operasi Android. Namun, perangkat "kompatibel dengan Android" hanya jika dapat menjalankan aplikasi yang ditulis untuk lingkungan eksekusi Android dengan benar. Detail persis tentang lingkungan eksekusi Android ditentukan oleh program kompatibilitas Android. Setiap perangkat harus lulus Compatibility Test Suite (CTS) agar dianggap kompatibel.

Sebagai developer aplikasi, Anda tidak perlu khawatir apakah perangkat kompatibel dengan Android atau tidak, karena hanya perangkat yang kompatibel dengan Android yang menyertakan Google Play Store. Jadi, jika pengguna menginstal aplikasi Anda dari Google Play Store, mereka menggunakan perangkat yang kompatibel dengan Android.

Namun, Anda perlu mempertimbangkan apakah aplikasi Anda kompatibel dengan setiap kemungkinan konfigurasi perangkat. Karena Android berjalan pada berbagai konfigurasi perangkat, beberapa fitur tidak tersedia di semua perangkat. Misalnya, beberapa perangkat mungkin tidak menyertakan sensor kompas. Jika fungsi inti aplikasi Anda memerlukan sensor kompas, aplikasi Anda hanya kompatibel dengan perangkat yang menyertakan fitur tersebut.

Mengontrol ketersediaan aplikasi Anda ke perangkat

Android mendukung beragam fitur yang dapat dimanfaatkan oleh aplikasi Anda melalui API platform. Beberapa fitur berbasis hardware, seperti sensor kompas; beberapa berbasis software, seperti widget aplikasi; dan beberapa bergantung pada versi platform. Tidak semua perangkat mendukung setiap fitur, jadi Anda mungkin perlu mengontrol ketersediaan aplikasi untuk perangkat berdasarkan fitur yang diperlukan aplikasi Anda.

Untuk mencapai basis pengguna sebesar mungkin bagi aplikasi, dukung sebanyak mungkin konfigurasi perangkat menggunakan satu APK atau AAB. Dalam sebagian besar situasi, Anda dapat melakukannya dengan menonaktifkan fitur opsional saat runtime dan menyediakan resource aplikasi dengan alternatif untuk berbagai konfigurasi, seperti tata letak yang berbeda untuk ukuran layar yang berbeda. Jika perlu, Anda dapat membatasi ketersediaan aplikasi untuk perangkat tertentu melalui Google Play Store berdasarkan karakteristik perangkat berikut:

Fitur perangkat
Versi platform
Konfigurasi layar

Fitur perangkat

Untuk mengelola ketersediaan aplikasi berdasarkan fitur perangkat, Android menentukan ID fitur untuk setiap fitur hardware atau software yang mungkin tidak tersedia di semua perangkat. Misalnya, ID fitur untuk sensor kompas adalah FEATURE_SENSOR_COMPASS, dan ID fitur untuk widget aplikasi adalah FEATURE_APP_WIDGETS.

Jika perlu, Anda dapat mencegah pengguna menginstal aplikasi Anda saat perangkat mereka tidak menyediakan fitur yang diperlukan dengan mendeklarasikan fitur tersebut menggunakan elemen <uses-feature> dalam file manifes aplikasi Anda.

Misalnya, jika aplikasi Anda tidak berfungsi di perangkat yang tidak memiliki sensor kompas, Anda dapat mendeklarasikan sensor kompas sebagai persyaratan dengan tag manifes berikut:

<manifest ... >
    <uses-feature android:name="android.hardware.sensor.compass"
                  android:required="true" />
    ...
</manifest>

Google Play Store membandingkan fitur yang diperlukan aplikasi Anda dengan fitur yang tersedia di setiap perangkat pengguna untuk menentukan apakah aplikasi Anda kompatibel dengan setiap perangkat. Jika perangkat tidak memiliki semua fitur yang diperlukan aplikasi Anda, pengguna tidak dapat menginstal aplikasi Anda.

Namun, jika fungsi utama aplikasi Anda tidak memerlukan fitur perangkat, tetapkan atribut required ke "false" dan periksa fitur perangkat saat runtime. Jika fitur aplikasi tidak tersedia di perangkat saat ini, turunkan versi fitur aplikasi yang sesuai dengan baik. Misalnya, Anda dapat membuat kueri apakah fitur tersedia dengan memanggil hasSystemFeature() seperti ini:

Kotlin

if (!packageManager.hasSystemFeature(PackageManager.FEATURE_SENSOR_COMPASS)) {
    // This device doesn't have a compass. Turn off the compass feature.
    disableCompassFeature()
}

Java

PackageManager pm = getPackageManager();
if (!pm.hasSystemFeature(PackageManager.FEATURE_SENSOR_COMPASS)) {
    // This device doesn't have a compass. Turn off the compass feature.
    disableCompassFeature();
}

Untuk mengetahui informasi tentang semua filter yang dapat Anda gunakan untuk mengontrol ketersediaan aplikasi melalui Google Play Store, lihat dokumentasi Filter di Google Play.

Catatan: Beberapa izin sistem secara implisit memerlukan ketersediaan fitur perangkat. Misalnya, jika aplikasi Anda meminta izin untuk mengakses BLUETOOTH, secara implisit aplikasi memerlukan fitur perangkat FEATURE_BLUETOOTH. Anda dapat menonaktifkan pemfilteran berdasarkan fitur ini dan menyediakan aplikasi untuk perangkat tanpa Bluetooth dengan menetapkan atribut required ke "false" dalam tag <uses-feature>. Untuk mengetahui informasi selengkapnya tentang fitur perangkat yang diperlukan secara implisit, baca Izin yang menyiratkan persyaratan fitur.

Versi platform

Perangkat yang berbeda mungkin menjalankan versi platform Android yang berbeda, seperti Android 12 atau Android 13. Setiap urutan versi platform seringkali menambahkan API yang tidak tersedia di versi sebelumnya. Untuk menunjukkan kumpulan API yang tersedia, setiap versi platform menentukan API level. Misalnya, Android 12 adalah API level 31, dan Android 13 adalah API level 33.

Anda harus menentukan nilai minSdkVersion dan targetSdkVersion dalam file build.gradle:

Kotlin

android {
    defaultConfig {
        applicationId = "com.example.myapp"

        // Defines the minimum API level required to run the app.
        minSdkVersion(30)

        // Specifies the API level used to test the app.
        targetSdkVersion(33)
        ...
    }
}

Groovy

android {
    defaultConfig {
        applicationId 'com.example.myapp'

        // Defines the minimum API level required to run the app.
        minSdkVersion 30

        // Specifies the API level used to test the app.
        targetSdkVersion 33
        ...
    }
}

Untuk mengetahui informasi selengkapnya tentang file build.gradle, baca Mengonfigurasi build.

Setiap versi Android yang berurutan menyediakan kompatibilitas untuk aplikasi yang di-build menggunakan API dari versi platform sebelumnya, sehingga aplikasi Anda kompatibel dengan versi Android mendatang saat menggunakan Android API yang didokumentasikan.

Catatan: Atribut targetSdkVersion tidak mencegah aplikasi Anda diinstal di versi platform yang lebih tinggi dari nilai yang ditentukan, tetapi hal ini penting karena menunjukkan kepada sistem apakah aplikasi Anda mewarisi perubahan perilaku dalam versi yang lebih baru. Jika Anda tidak mengupdate targetSdkVersion ke versi terbaru, sistem akan menganggap bahwa aplikasi Anda memerlukan kompatibilitas mundur saat menjalankan versi terbaru.

Namun, jika aplikasi Anda menggunakan API yang ditambahkan dalam versi platform yang lebih baru, tetapi tidak memerlukannya untuk fungsi utamanya, periksa level API saat runtime dan turunkan dengan baik fitur yang sesuai jika level API terlalu rendah. Dalam hal ini, tetapkan minSdkVersion ke nilai terendah yang memungkinkan untuk fungsi utama aplikasi Anda, lalu bandingkan versi sistem saat ini, SDK_INT, dengan konstanta nama kode di Build.VERSION_CODES yang sesuai dengan level API yang ingin Anda periksa, seperti yang ditunjukkan dalam contoh berikut:

Kotlin

if (Build.VERSION.SDK_INT < Build.VERSION_CODES.HONEYCOMB) {
    // Running on something older than API level 11, so disable
    // the drag and drop features that use ClipboardManager APIs.
    disableDragAndDrop()
}

Java

if (Build.VERSION.SDK_INT < Build.VERSION_CODES.HONEYCOMB) {
    // Running on something older than API level 11, so disable
    // the drag and drop features that use ClipboardManager APIs.
    disableDragAndDrop();
}

Konfigurasi layar

Android berjalan di perangkat dengan berbagai ukuran seperti ponsel, tablet, dan TV. Untuk mengkategorikan perangkat menurut jenis layarnya, Android menentukan dua karakteristik untuk setiap perangkat: ukuran layar (ukuran fisik layar) dan kepadatan layar (kerapatan fisik piksel pada layar, yang dikenal sebagai DPI). Untuk menyederhanakan berbagai konfigurasi, Android menggeneralisasi varian ini ke dalam grup yang membuatnya lebih mudah ditargetkan:

Empat ukuran umum: kecil, normal, besar, dan ekstra besar
Beberapa kepadatan umum: mdpi (sedang), hdpi (tinggi), xhdpi (ekstra tinggi), xxhdpi (ekstra-ekstra tinggi), dan lainnya

Secara default, aplikasi Anda kompatibel dengan semua ukuran dan kepadatan layar, karena sistem membuat penyesuaian pada tata letak UI dan resource gambar yang diperlukan untuk setiap layar. Berikan gambar bitmap yang dioptimalkan untuk kepadatan layar yang umum.

Optimalkan pengalaman pengguna dengan menggunakan tata letak yang fleksibel sebanyak mungkin. Jika ada tata letak untuk perubahan konfigurasi besar, seperti potret dan lanskap, atau ukuran jendela besar versus kecil, pertimbangkan untuk menyediakan tata letak alternatif yang fleksibel terhadap perubahan yang lebih kecil dalam konfigurasi. Hal ini meningkatkan pengalaman pengguna pada faktor bentuk seperti tablet, ponsel, dan perangkat foldable. Hal ini juga membantu saat jendela mengubah ukuran dalam mode multi-aplikasi.

Untuk mengetahui informasi tentang cara membuat resource alternatif untuk berbagai layar dan cara membatasi aplikasi ke ukuran layar tertentu jika diperlukan, baca ringkasan kompatibilitas layar dan lihat panduan kualitas aplikasi layar besar.

Mengontrol ketersediaan aplikasi karena alasan bisnis

Selain membatasi ketersediaan aplikasi berdasarkan karakteristik perangkat, Anda mungkin perlu membatasi ketersediaan aplikasi karena alasan bisnis atau hukum. Untuk jenis situasi ini, Google Play Store menyediakan opsi pemfilteran di Konsol Play yang memungkinkan Anda mengontrol ketersediaan aplikasi karena alasan nonteknis seperti lokalitas pengguna atau operator nirkabel.

Pemfilteran untuk kompatibilitas teknis—seperti komponen hardware yang diperlukan—selalu didasarkan pada informasi yang terdapat dalam file APK atau AAB Anda. Namun, pemfilteran karena alasan nonteknis—seperti lokalitas geografis—selalu ditangani di Konsol Google Play.

Referensi tambahan:

Ringkasan resource aplikasi: Informasi tentang cara aplikasi Android disusun untuk memisahkan resource aplikasi dari kode aplikasi, termasuk cara menyediakan resource alternatif untuk konfigurasi perangkat tertentu.
Filter di Google Play: Informasi tentang berbagai cara yang dapat dilakukan Google Play Store untuk mencegah aplikasi Anda diinstal di perangkat yang berbeda.
Izin di Android: Cara Android membatasi akses aplikasi ke API tertentu dengan sistem izin yang memerlukan persetujuan pengguna agar aplikasi dapat menggunakan API tersebut.

Berikutnya

Tentang kompatibilitas layar