Kompatibilitas APK Berdasarkan Versi Android (Panduan Lengkap 2026)

Kompatibilitas APK berdasarkan versi Android berpangkal pada dua angka di dalam manifest aplikasi. minSdkVersion adalah batas bawah: rilis Android Anda harus berada di atas atau sama dengannya, atau pemasangan gagal. targetSdkVersion adalah versi yang diuji pengembang, dan angka itu mengubah perilaku alih-alih memblokir pemasangan. Android 10 adalah API 29, Android 15 adalah API 35, Android 17 adalah API 37, dan setiap APK menyatakan angka yang dibutuhkannya.

Cara Kerja Kompatibilitas Versi Android

Android memeriksa manifest sebelum menyalin berkas apa pun, dan pemeriksaan itu memakai dua kolom. minSdkVersion menamai rilis Android tertua yang didukung aplikasi. targetSdkVersion menamai rilis tempat aplikasi dibangun dan diuji. Tingkat API perangkat dibandingkan dengan angka pertama, dan angka kedua hanya memengaruhi perilaku platform mana yang aktif.

Tiga hasil mengikuti dari perbandingan itu:

1. API perangkat di atas atau sama dengan minSdkVersion. Pemasangan lanjut ke pemeriksaan tanda tangan dan arsitektur.
2. API perangkat di bawah minSdkVersion. Penginstal membatalkan. Dari ADB Anda melihat INSTALL_FAILED_OLDER_SDK; dari Play Store Anda melihat “This app isn’t compatible with your device.”
3. API perangkat jauh di atas targetSdkVersion. Aplikasi terpasang, tetapi Android dapat menerapkan perilaku kompatibilitas yang tidak pernah diuji pengembang. Di situlah crash di ponsel modern biasanya berasal.

Google mendokumentasikan kedua kolom itu di referensi elemen uses-sdk, dan angka API muncul pada tabel di bawah.

Mengapa APK Menolak Dipasang di Versi Android Anda

Pesan yang Anda lihat memberi tahu pemeriksaan mana dari ketiganya yang gagal. Cocokkan kesalahan Anda dengan barisnya:

Baris kelima adalah yang terbaru. Android 14 memblokir pemasangan yang menyasar API 22 ke bawah, Android 15 menaikkan batas ke 23, dan setiap rilis terus menaikkannya. Flag ADB di atas adalah jalan keluar yang disengaja untuk salinan hasil sideload. Panduan pemecahan masalah pemasangan membahas setiap kode dengan tangkapan layar.

Riwayat Versi Android dan Tingkat API

Aplikasi menyatakan tingkat API, bukan nama pemasaran, karena angka-angka itu tidak pernah berubah. Inilah pemetaan yang akan Anda lihat dikutip di halaman unduhan:

Tiga detail yang layak diketahui tentang ekor tabel itu. Android 16 dirilis pada 10 Juni 2025 dan Android 17 pada 16 Juni 2026, jadi jawaban atas “Android terbaru” berubah setiap musim panas. Fire OS memakai penomoran yang sama: Fire OS 16 sesuai dengan API 36. Dan Play Store kini mengikat aturannya ke bilangan bulat itu, bukan ke nama versi.

Cara Fire OS, Wear OS, TV, dan Automotive Menomori Android

Setiap cabang Android melaporkan bilangan API yang sama yang Google tetapkan untuk setiap rilis, sehingga Fire OS 16 berarti API 36, build Android TV cocok satu per satu dengan rilis ponsel, dan Wear OS serta Android Automotive menyatakan nilai minSdkVersion dan targetSdkVersion yang sama di manifest mereka. Labelnya berubah. Angkanya tidak.

Fire OS adalah contoh paling jelas, karena versi 16 langsung dipetakan ke API 36 dan Android 16. Wear OS dan Android Automotive menjalankan jalur Play Store terpisah, sehingga sebuah aplikasi bisa ada untuk ponsel tetapi tidak ada di jam tangan. Aplikasi cermin yang gagal di Galaxy Watch biasanya mengenai perpecahan itu. Itu masalah katalog.

Penjelasan Kompatibilitas Mundur dan Maju

Android menjalankan aplikasi lama di sistem baru jauh lebih andal daripada sebaliknya. Dua arah itu gagal secara berbeda.

Android Baru, APK Lama

Aplikasi lama biasanya terpasang dan berjalan. Perubahan perilaku dikendalikan di balik targetSdkVersion, sehingga aplikasi yang dibuat untuk Android 9 tetap berperilaku seperti aplikasi Android 9 di Android 17. Kegagalan yang dialami orang adalah API yang dihapus dan batasan latar belakang yang diperketat, yang muncul sebagai crash atau notifikasi yang tak pernah sampai. Pengecualian darurat ada untuk target yang sangat lama, dibahas di tabel kesalahan di atas.

Android Lama, APK Baru

Pemasangannya sama sekali tidak terjadi. minSdkVersion ditegakkan sebelum segala sesuatu, dan tidak ada jalan pintas tersembunyi. Pilihan nyata Anda adalah:

1. Perbarui Android. Perbaikan permanen, dengan asumsi perangkat Anda masih menerima pembaruan.
2. Pasang rilis aplikasi yang lebih lama. Arsip menyimpan versi sebelumnya, dan rilis lama sering menyatakan minimum yang lebih rendah. Panduan pembaruan APK membahas penurunan versi dengan aman, termasuk mengapa tanda tangan tetap harus cocok.
3. Jalankan di tempat lain. Citra emulator, perangkat kedua, atau sesi Android cloud.

Batas Waktu Milik Play Store Sendiri

Google Play menambahkan aturan ketiga di atas aturan teknis. Aplikasi baru dan pembaruan harus menyasar API 36 mulai 31 Agustus 2026 (dengan perpanjangan hingga 1 November 2026). Aplikasi yang masih di bawah API 35 berhenti ditawarkan kepada pengguna baru di perangkat yang menjalankan Android lebih baru. Pemasangan yang ada tetap berfungli; yang berubah adalah penemuan. Google menerbitkan tanggal pastinya di persyaratan tingkat API target.

Linimasa Batas Waktu Target API Google Play

Google Play mensyaratkan setiap aplikasi baru dan setiap pembaruan menyasar tingkat API tertentu, dan batas bawah saat ini adalah API 36 sejak 31 Agustus 2026, dengan jendela perpanjangan singkat hingga 1 November 2026 bagi pengembang yang meminta waktu tambahan. Dua batas waktu penting saat ini.

Pemasangan yang ada tidak pernah dihapus. Google menerbitkan kedua tanggal di persyaratan tingkat API target, dan referensi platform yang cocok adalah dokumentasi targetSdkVersion. Aplikasi yang mengabaikan batas waktu tetap berfungsi bagi orang yang sudah menginstalnya.

Perubahan Perilaku yang Dikendalikan targetSdkVersion

targetSdkVersion menentukan perilaku platform mana yang diterapkan Android pada sebuah aplikasi, sehingga paket yang dibuat untuk API 29 terpasang di Android 16 namun tetap memakai aturan penyimpanan, aturan notifikasi, dan batasan latar belakang dari era-nya sendiri, bukan aturan platform terbaru. Itulah sebabnya aplikasi lama bisa gagal di ponsel yang benar-benar baru.

Tidak ada baris itu yang memblokir pemasangan. Aplikasi datang, diluncurkan, lalu gagal saat menyentuh API yang dibatasi. Hanya pengembang yang dapat menaikkan targetSdkVersion, jadi pembaruan adalah perbaikannya.

Cara Memeriksa Versi Android Minimum Sebuah APK

Empat metode, diurutkan menurut banyaknya usaha yang dikeluarkan.

Baca Halaman Toko atau Halaman Unduhan

Google Play mencantumkan Requires Android di setiap halaman aplikasi. Arsip dan mirror mencetak nilai yang sama di halaman unduhan mereka. Ini menjawab pertanyaan dalam lima detik untuk apa pun yang belum Anda unduh.

Gunakan APK Analyzer di Android Studio

Buka Android Studio, pilih File lalu Profile or Debug APK, dan baca minSdkVersion dari ringkasan manifest. Ini berfungsi pada berkas lokal apa pun, termasuk yang Anda terima melalui aplikasi pesan.

Baca Manifest dengan ADB

Instal aplikasi di sebuah perangkat, lalu jalankan:

adb shell dumpsys package com.example.app | grep -E "minSdk|targetSdk|versionName"

Perintah itu mencetak nilai-nilai yang sebenarnya ditegakkan Android untuk salinan terpasang tersebut.

Periksa Arsitektur Sekaligus

Pemeriksaan yang sama seharusnya memberi tahu pustaka native mana yang dikirim di dalam paket, yang penting di Chromebook dan PC. Arsitektur, nama ABI, dan paket split dibahas di ukuran dan arsitektur file APK.

APK Split, Berkas XAPK, dan adb install-multiple

Google Play mengubah Android App Bundle menjadi beberapa APK kecil alih-alih satu berkas, dan perintah adb install biasa hanya menerima satu berkas sekaligus, sehingga sebuah bundle memerlukan perintah install-multiple agar tiba lengkap di perangkat. Satu berkas tidak pernah merupakan seluruh aplikasi.

install-multiple mengambil setiap jalur dalam satu panggilan dan memperlakukannya sebagai satu paket, sehingga berkas-berkas itu harus saling cocok. Kirim hanya split x86 ke ponsel arm64 dan ADB mengembalikan INSTALL_FAILED_NO_MATCHING_ABIS. Contoh perintah ada di ukuran dan arsitektur file APK.

Cara Memeriksa Versi Android Anda

Buka Pengaturan, gulir ke Tentang ponsel atau Tentang tablet, dan baca Versi Android. Ketuk nomor versi jika Anda ingin telur paskahnya, tetapi angkanya sendiri yang Anda butuhkan. Petakan memakai tabel di atas.

Di TV jalurnya sedikit berbeda: Pengaturan, lalu Preferensi perangkat atau Sistem, lalu Tentang. Di Wear OS, Pengaturan, lalu Sistem, lalu Tentang. Angka yang sama berlaku di mana pun, karena berasal dari basis Android yang sama.

Jika layar pengaturan hanya menampilkan nomor build, Anda melihat terlalu jauh ke bawah satu baris. Kompatibilitas membaca versi Android, bukan tanggal tambalan keamanan.

Apa yang Harus Dilakukan Jika APK Membutuhkan Android Lebih Baru

Tiga pilihan, diurutkan menurut seberapa sering berhasil:

1. Perbarui perangkat. Pengaturan, Sistem, Pembaruan sistem. Perangkat yang dirilis dalam tiga tahun terakhir biasanya menerima dua sampai tiga tahun pembaruan, sehingga ponsel 2022 mungkin sudah berada di batas atasnya.
2. Turunkan ke versi aplikasi yang lebih lama. Rilis sebelumnya sering menyatakan minimum yang lebih rendah. Pasang dari sebuah arsip, tetapi jaga tanda tangannya tetap konsisten dengan salinan yang sudah ada di perangkat, atau hapus dulu.
3. Gunakan emulator. Di komputer, citra emulator menjalankan tingkat API apa pun yang sedang berlaku, sehingga itu menjadi jawaban saat ponsel terjebak. Lihat panduan PC untuk penyiapannya.

Jangan mencoba mengubah minSdkVersion dengan membangun ulang manifest. APK yang dikemas ulang gagal dalam pemeriksaan tanda tangan dan ditolak dengan INSTALL_FAILED_UPDATE_INCOMPATIBLE.

Cara Menurunkan Versi ke Rilis Aplikasi Lebih Lama

Untuk mengembalikan sebuah aplikasi, Anda menghapus salinan yang lebih baru lebih dulu, lalu memasang rilis lama yang ditandatangani dengan kunci yang sama, karena Android menolak menempatkan version code yang lebih rendah di atas yang lebih tinggi dan Android mengembalikan kesalahan INSTALL_FAILED_VERSION_DOWNGRADE saat Anda mencoba. Menghapus lebih dulu membersihkan pemeriksaan versi sekaligus data tersimpan.

1. Hapus aplikasinya. Pengaturan, lalu Aplikasi, lalu aplikasinya, lalu Copot pemasangan. Untuk aplikasi sistem, pilih Copot pembaruan, yang memulihkan versi pabrikan.
2. Konfirmasi kunci penandatanganan. Rilis lama yang ditandatangani kunci berbeda gagal dengan INSTALL_FAILED_UPDATE_INCOMPATIBLE, yang terjadi setelah pengembang menyalakan Play App Signing.
3. Pasang paket yang lebih lama. Jalankan adb install old-app.apk, atau buka berkasnya dari pengelola berkas di ponsel.
4. Siapkan diri untuk kehilangan data. Menghapus pemasangan menghapus login dan simpanan, jadi ekspor apa yang bisa Anda ekspor sebelum langkah pertama.

Build yang dapat di-debug juga menerima flag adb install -d, yang melonggarkan pemeriksaan versi untuk paket yang mengizinkannya. Build rilis jarang mengizinkannya, jadi menghapus pemasangan tetap menjadi jalur yang andal. Versi sebelumnya hidup di arsip, dan cara memperbarui berkas APK mencantumkan urutan yang aman.

Apa yang Harus Dilakukan Jika APK Membutuhkan Android Lebih Lama

Hampir tidak pernah menjadi masalah. Aplikasi yang menyimpan batas bawah di bawah versi Anda berjalan baik, karena Android menjalankan aplikasi baru dengan perilaku lama melalui pengendalian targetSdk. Kegagalan yang jarang adalah fitur perangkat keras yang dinyatakan aplikasi sebagai wajib, seperti kamera atau sensor tertentu, yang merupakan ketidakcocokan perangkat, bukan ketidakcocokan versi. Daftar periksa izin di cara memeriksa izin APK membahas pemeriksaan itu.

Uji perangkat Anda terhadap daftar dukungan perangkat lengkap, lalu jalankan pemeriksaan versi di atas pada aplikasi yang benar-benar Anda inginkan.