Halaman ini diterjemahkan oleh Cloud Translation API.

Ringkasan kompatibilitas perangkat

Android dirancang untuk berjalan di banyak perangkat yang berbeda, seperti ponsel, tablet, dan televisi. Berbagai perangkat memberikan potensi besar audiens aplikasi Anda. Agar aplikasi Anda berhasil di semua perangkat, aplikasi harus menoleransi variabilitas fitur dan menyediakan antarmuka pengguna fleksibel yang beradaptasi pada 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 sumber daya 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 proyek {i>open-source<i}, produsen perangkat keras mana pun dapat membuat perangkat yang menjalankan sistem operasi Android. Tetapi sebuah perangkat "Kompatibel dengan Android" hanya jika layanan itu dapat menjalankan aplikasi yang ditulis untuk Lingkungan eksekusi Android. 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, maka aplikasi Anda hanya kompatibel dengan perangkat yang menyertakan fitur tersebut.

Mengontrol ketersediaan aplikasi untuk perangkat

Android mendukung beragam fitur yang dapat dimanfaatkan oleh aplikasi Anda melalui API platform. Beberapa fitur berbasis perangkat keras, 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 sebanyak mungkin bagi aplikasi Anda, dukung sebanyak mungkin konfigurasi perangkat yang paling mungkin menggunakan satu APK atau AAB. Di kebanyakan situasi, Anda dapat melakukannya dengan menonaktifkan fitur opsional saat {i>runtime<i} dan aplikasi penyedia resource dengan alternatif untuk berbagai konfigurasi, seperti tata letak 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 masuk akal pada perangkat yang tidak memiliki kompas sensor, Anda dapat mendeklarasikan sensor kompas sebagai persyaratan dengan tag manifes:

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

Google Play Store membandingkan fitur yang dibutuhkan aplikasi Anda dengan 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, lakukan degradasi halus fitur aplikasi tersebut. Misalnya, Anda dapat melakukan kueri apakah suatu fitur tersedia dengan menelepon hasSystemFeature() seperti ini:

KotlinJava

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

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

KotlinGroovy

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)
        ...
    }
}

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 agar tidak diinstal pada versi platform yang lebih tinggi dari nilai yang ditentukan, tetapi 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 dijalankan pada versi terbaru.

Namun, jika aplikasi Anda menggunakan API yang ditambahkan dalam versi platform yang lebih baru, tetapi tidak memerlukannya untuk fungsi utamanya, periksa API level di runtime dan menurunkan kualitas fitur terkait secara halus ketika level API terlalu rendah. Dalam hal ini, tetapkan minSdkVersion ke nilai terendah mungkin untuk fungsi utama aplikasi Anda, lalu bandingkan nilai versi, SDK_INT, ke konstanta namakode di Build.VERSION_CODES sesuai dengan level API yang ingin Anda periksa, seperti ditunjukkan dalam contoh:

KotlinJava

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()
}

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. Kepada mengategorikan perangkat berdasarkan jenis layarnya, Android mendefinisikan dua karakteristik setiap perangkat: ukuran layar (ukuran fisik layar) dan kepadatan layar (kepadatan fisik piksel pada layar, yang dikenal sebagai DPI). Untuk menyederhanakan berbagai Android, 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 akan menyesuaikan 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. Ini juga membantu ketika jendela berubah 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. Tetapi memfilter karena alasan nonteknis—seperti lokal—selalu ditangani di Konsol Google Play.

Referensi tambahan:

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