Saat diupload, APK harus memenuhi persyaratan API level target Google Play. Aplikasi baru dan update aplikasi harus menargetkan Android 10 (API level 29) atau yang lebih tinggi; kecuali untuk aplikasi Wear OS, yang harus menargetkan API level 28 atau yang lebih tinggi.
Mulai Agustus 2021, aplikasi baru harus:
- Dipublikasikan dengan format Android App Bundle.
- Menggunakan Play Asset Delivery atau Play Feature Delivery untuk mengirimkan aset atau fitur yang melebihi ukuran download 150 MB. File ekspansi (OBB) tidak lagi didukung untuk aplikasi baru.
- Menargetkan API level 30 (Android 11) atau yang lebih tinggi dan membuat penyesuaian untuk perubahan perilaku; kecuali untuk aplikasi Wear OS, yang harus terus menargetkan API level 28 atau yang lebih tinggi.
Mulai November 2021, update aplikasi wajib menargetkan API level 30 atau yang lebih tinggi dan membuat penyesuaian untuk perubahan perilaku di Android 11. Aplikasi saat ini yang tidak menerima update tidak akan terpengaruh dan bisa terus didownload dari Play Store. Aplikasi Wear OS harus terus menargetkan API level 28 atau yang lebih tinggi.
Peralihan ke pengiriman Android App Bundle juga akan berdampak pada pengalaman instan yang menggunakan format ZIP Aplikasi instan lama. Mulai Agustus 2021, pengalaman instan baru dan update untuk pengalaman instan yang sudah ada akan diwajibkan sebagai persyaratan pemublikasian app bundle yang diaktifkan secara instan.
Mengapa harus menargetkan SDK yang lebih baru?
Setiap versi Android baru memperkenalkan perubahan yang menghadirkan peningkatan keamanan dan performa yang signifikan serta memperbaiki pengalaman pengguna Android secara keseluruhan. Beberapa perubahan ini hanya berlaku untuk aplikasi yang secara eksplisit mendeklarasikan
dukungan melalui atribut manifes targetSdkVersion
(juga disebut sebagai
API level target).
Dengan mengonfigurasi aplikasi agar menargetkan API level terbaru, Anda memastikan pengguna dapat memperoleh manfaat dari peningkatan ini, serta tetap memungkinkan aplikasi berjalan pada versi Android yang lebih lama. Dengan menargetkan API level terbaru, aplikasi Anda juga dapat memanfaatkan fitur-fitur terbaru platform untuk menyenangkan pengguna. Selanjutnya, mulai Android 10 (API level 29), pengguna akan melihat peringatan saat memulai aplikasi untuk kali pertama jika aplikasi menargetkan Android 5.1 (API level 22) atau yang lebih lama.
Dokumen ini menyoroti poin-poin penting yang perlu Anda ketahui dalam mengupdate API level target Anda untuk memenuhi persyaratan Google Play.
Catatan: Jika file Gradle Anda berisi entri manifes, Anda dapat mengonfirmasi atau mengubah nilai
targetSdkVersion
saat ini dalam file Gradle aplikasi, seperti yang dijelaskan dalam
Mengonfigurasi build Anda.
Atau, Anda dapat menggunakan atribut android:targetSdkVersion
dalam file manifes, seperti yang dijelaskan dalam dokumentasi untuk
elemen manifes
<uses-sdk>.
Bermigrasi dari Android 10 (API level 29) ke Android 11 (API level 30)
- Privasi
- Penegakan penyimpanan terbatas: Aplikasi harus menerapkan model penyimpanan terbatas yang digunakan untuk menyimpan serta mengakses jenis file khusus aplikasi, media, dan jenis file lainnya menggunakan lokasi khusus.
- Reset otomatis izin: Jika pengguna tidak berinteraksi dengan aplikasi selama beberapa bulan, sistem akan otomatis mereset izin sensitif aplikasi. Hal ini tidak akan memengaruhi sebagian besar aplikasi. Jika aplikasi Anda menjalankan fungsi utamanya di latar belakang tanpa interaksi pengguna, Anda dapat mempertimbangkan untuk meminta pengguna menonaktifkan reset otomatis.
- Akses lokasi latar belakang: Aplikasi harus meminta izin akses lokasi latar depan dan latar belakang secara terpisah. Memberikan izin akses lokasi latar belakang hanya dapat dilakukan di setelan aplikasi, bukan dialog izin runtime.
- Visibilitas
paket: Saat
aplikasi mengajukan kueri terkait daftar layanan dan aplikasi terinstal di perangkat,
daftar yang ditampilkan akan difilter.
- Jika menggunakan layanan
Text-To-Speech atau
Pengenalan
Ucapan,
Anda perlu menambahkan elemen
<queries>
untuk layanan ke file manifes.
- Jika menggunakan layanan
Text-To-Speech atau
Pengenalan
Ucapan,
Anda perlu menambahkan elemen
- Keamanan
- File
resource.arsc
terkompresi tidak lagi didukung. - APK Signature Scheme v2 kini diwajibkan. Untuk menjaga kompatibilitas mundur, developer juga harus terus melakukan penandatanganan dengan APK Signature Scheme v1.
- Pembatasan antarmuka non-SDK. Sebaiknya Anda tidak menggunakan antarmuka non-SDK untuk aplikasi yang menargetkan API level 30, karena beberapa antarmuka non-SDK ini kini diblokir. Lihat Antarmuka non-SDK yang kini diblokir di Android 11 untuk mengetahui daftar selengkapnya.
- File
Untuk mengetahui daftar lengkap perubahan yang diperkenalkan di Android 11 (API level 30), lihat halaman Perubahan Perilaku.
Melakukan migrasi dari versi di bawah Android 10 (API level 29)
Pilih versi Android asal migrasi Anda:
Bermigrasi ke Android 5 (API level 21)
Lihat halaman Perubahan Perilaku yang terkait bagi setiap rilis berikut, untuk memastikan aplikasi Anda telah memperhitungkan perubahan yang diperkenalkan dalam rilis berikut:
Lanjutkan dengan mengikuti petunjuk di bagian berikutnya.
Bermigrasi ke Android 6 (API level 23)
Pertimbangan berikut berlaku untuk aplikasi yang menargetkan Android 6.0 dan versi platform yang lebih tinggi:
-
-
Izin berbahaya hanya diberikan selama runtime. Alur UI Anda harus menyediakan kemampuan untuk memberikan izin semacam ini.
-
Sedapat mungkin, pastikan aplikasi Anda agar siap menangani penolakan permintaan izin. Misalnya, jika pengguna menolak permintaan untuk mengakses GPS perangkat, pastikan aplikasi Anda memiliki cara lain untuk melanjutkan proses ini.
-
Untuk melihat daftar lengkap perubahan yang diperkenalkan pada Android 6.0 (API level 23), lihat halaman Perubahan Perilaku untuk versi platform tersebut.
Lanjutkan dengan mengikuti petunjuk di bagian berikutnya.
Bermigrasi ke Android 7 (API level 24)
Pertimbangan berikut berlaku untuk aplikasi yang menargetkan Android 7.0 dan versi platform yang lebih tinggi:
-
Istirahatkan dan Aplikasi Standby
Desain aplikasi untuk menangani perilaku yang dijelaskan dalam Mengoptimalkan Aplikasi untuk Mode Istirahatkan dan Aplikasi Standby, yang mencakup perubahan bertahap yang diperkenalkan pada beberapa rilis platform.
Saat perangkat berada dalam mode Istirahatkan dan Aplikasi Standby, sistem akan berperilaku sebagai berikut:
- Membatasi akses jaringan
- Menunda alarm, sinkronisasi, dan tugas
- Membatasi pemindaian Wi-Fi dan GPS
- Membatasi pesan Firebase Cloud Messaging dengan prioritas normal.
-
Perubahan Izin
- Sistem membatasi akses ke direktori pribadi aplikasi.
-
Mengekspos URI
file://
di luar aplikasi akan memicuFileUriExposedException
. Jika perlu berbagi file di luar aplikasi, implementasikanFileProvider
-
Sistem melarang penautan ke library non-NDK.
Untuk melihat daftar lengkap perubahan yang diperkenalkan pada Android 7.0 (API level 24), lihat halaman Perubahan Perilaku untuk versi platform tersebut.
Lanjutkan dengan mengikuti petunjuk di bagian berikutnya.
Bermigrasi ke Android 8 (API level 26)
Pertimbangan berikut berlaku untuk aplikasi yang menargetkan Android 8.0 dan versi platform yang lebih tinggi:
-
Batas Eksekusi Latar Belakang
-
Sistem membatasi layanan untuk aplikasi yang tidak berjalan di latar depan.
-
startService()
kini akan menampilkan pengecualian saat aplikasi mencoba memanggilnya, sementarastartService()
dilarang. -
Untuk memulai layanan latar depan, aplikasi harus menggunakan
startForeground()
danstartForegroundService()
. - Tinjau dengan cermat perubahan yang dibuat pada JobScheduler API, seperti yang didokumentasikan di halaman Perubahan Perilaku Android 8.0 (API level 26).
- Firebase Cloud Messaging memerlukan SDK layanan Google Play versi 10.2.1, atau yang lebih tinggi.
- Saat menggunakan Firebase Cloud Messaging, pengiriman pesan akan mematuhi batas eksekusi latar belakang. Jika pekerjaan di latar belakang diperlukan setelah pesan diterima, seperti untuk menjalankan sinkronisasi data latar belakang, aplikasi Anda harus menjadwalkan tugas melalui Firebase Job Dispatcher atau JobIntentService. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Firebase Cloud Messaging.
-
-
Siaran implisit
-
Siaran implisit dibatasi. Untuk mengetahui informasi tentang menangani peristiwa latar belakang, baca dokumentasi untuk
JobScheduler
API.
-
Siaran implisit dibatasi. Untuk mengetahui informasi tentang menangani peristiwa latar belakang, baca dokumentasi untuk
-
Batas Lokasi Latar Belakang
-
Aplikasi yang berjalan di latar belakang memiliki akses terbatas ke data lokasi.
- Di perangkat yang menjalankan layanan Google Play, gunakan penyedia lokasi gabungan untuk mendapatkan pembaruan lokasi secara berkala.
-
Aplikasi yang berjalan di latar belakang memiliki akses terbatas ke data lokasi.
-
Sistem membatasi layanan untuk aplikasi yang tidak berjalan di latar depan.
-
Saluran Notifikasi
- Anda harus menentukan properti interupsi notifikasi untuk setiap saluran.
- Anda harus menetapkan notifikasi ke saluran agar notifikasi dapat ditampilkan.
-
Versi platform ini mendukung
NotificationCompat.Builder
.
-
Privasi
- ANDROID_ID disesuaikan lingkupnya per kunci penandatanganan aplikasi.
Untuk melihat daftar lengkap perubahan yang diperkenalkan pada Android 8.0 (API level 26), lihat halaman Perubahan Perilaku untuk versi platform tersebut.
Melakukan migrasi dari Android 8 (API 26) ke Android 9 (API 28)
-
Pengelolaan Daya
- Bucket Aplikasi Standby menetapkan pembatasan latar belakang baru berdasarkan interaksi aplikasi, seperti tugas yang ditangguhkan, alarm, dan kuota pada pesan berprioritas tinggi
- Peningkatan penghemat baterai meningkatkan batasan untuk aplikasi pada mode aplikasi standby
-
Izin layanan latar depan
- Perlu meminta izin normal
FOREGROUND_SERVICE
(bukan izin runtime)
- Perlu meminta izin normal
-
Perubahan privasi
- Akses terbatas ke sensor latar belakang
- Akses terbatas ke log panggilan, kini ada di grup izin
CALL_LOG
- Akses terbatas ke nomor telepon, memerlukan
izin
READ_CALL_LOG
- Akses terbatas ke informasi Wi-Fi
Untuk melihat daftar lengkap perubahan yang diperkenalkan pada Android 9.0 (API level 28), lihat perubahan perilaku.
Melakukan migrasi dari Android 9 (API level 28) ke Android 10 (API level 29)
-
Notifikasi
dengan intent layar penuh
-
Perlu meminta izin normal
USE_FULL_SCREEN_INTENT
(bukan izin runtime).
-
Perlu meminta izin normal
-
Dukungan untuk perangkat foldable dan
perangkat layar besar
-
Beberapa aktivitas kini dapat berada dalam status "dilanjutkan" secara bersamaan, tetapi hanya satu aktivitas yang benar-benar memiliki fokus.
-
Perubahan ini memengaruhi perilaku
onResume()
danonPause()
. -
Konsep siklus proses baru dari "dilanjutkan teratas" yang dapat dideteksi
dengan berlangganan ke
onTopResumedActivityChanged()
.- Hanya satu aktivitas yang dapat menjadi "dilanjutkan teratas".
-
Perubahan ini memengaruhi perilaku
-
Saat
resizeableActivity
disetel kefalse
, aplikasi juga dapat menentukanminAspectRatio
, yang otomatis menjadikan aplikasi tersebut memiliki tampilan lebar pada rasio lebar tinggi yang lebih sempit.
-
Beberapa aktivitas kini dapat berada dalam status "dilanjutkan" secara bersamaan, tetapi hanya satu aktivitas yang benar-benar memiliki fokus.
-
Perubahan privasi
-
Penyimpanan terbatas
- Akses penyimpanan eksternal hanya terbatas untuk direktori khusus aplikasi dan untuk jenis media tertentu yang telah dibuat oleh aplikasi.
-
Akses terbatas ke lokasi saat aplikasi berada di latar belakang,
yang memerlukan
izin
ACCESS_BACKGROUND_LOCATION
. - Akses terbatas ke ID yang tidak dapat direset seperti IMEI dan nomor seri.
-
Akses terbatas ke informasi aktivitas fisik seperti
jumlah langkah pengguna, yang memerlukan
izin
ACTIVITY_RECOGNITION
. -
Akses terbatas ke
beberapa
API telepon, Bluetooth, dan Wi-Fi, yang memerlukan
izin
ACCESS_FINE_LOCATION
. -
Akses terbatas ke setelan Wi-Fi
- Aplikasi tidak dapat lagi mengaktifkan atau menonaktifkan Wi-Fi secara langsung dan perlu melakukannya menggunakan panel setelan.
-
Batasan saat memulai koneksi ke jaringan Wi-Fi,
yang mengharuskan penggunaan
WifiNetworkSpecifier
atauWifiNetworkSuggestion
.
-
Penyimpanan terbatas
Lanjutkan untuk mengupdate ke API 30 dengan mengikuti petunjuk di bagian sebelumnya.
Memodernisasi aplikasi
Saat mengupdate API level target untuk aplikasi, sebaiknya gunakan fitur platform terbaru untuk memodernkan aplikasi Anda demi kepuasan pengguna.
- Pertimbangkan untuk menggunakan CameraX, yang masih dalam versi Beta, untuk memaksimalkan penggunaan kamera.
- Gunakan komponen Jetpack untuk membantu Anda mengikuti praktik terbaik, menghindari penulisan kode boilerplate, dan menyederhanakan tugas kompleks sehingga Anda dapat fokus pada kode yang perlu ditangani.
- Gunakan Kotlin untuk menulis aplikasi yang lebih baik dengan lebih cepat, dan dengan kode yang lebih sedikit.
- Pastikan Anda mengikuti persyaratan dan praktik terbaik privasi.
- Tambahkan dukungan tema gelap ke aplikasi Anda.
- Tambahkan dukungan navigasi gestur ke aplikasi Anda.
- Migrasikan aplikasi Anda dari Google Cloud Messaging (GCM) ke versi terbaru Firebase Cloud Messaging.
- Manfaatkan pengelolaan jendela tingkat lanjut.
- Dukung rasio lebar tinggi yang lebih besar (di atas 16:9) untuk memanfaatkan inovasi hardware terbaru. Pastikan aplikasi Anda dapat menyesuaikan ukuran untuk mengisi ruang layar yang tersedia. Hanya deklarasikan rasio lebar tinggi maksimal sebagai upaya terakhir. Untuk mengetahui informasi selengkapnya tentang rasio lebar tinggi maksimal, baca Mendeklarasikan Dukungan Layar Terbatas.
- Tambahkan dukungan multi-aplikasi untuk membantu aplikasi Anda meningkatkan produktivitas, dan untuk mengelola beberapa layar.
- Jika pengalaman hebat aplikasi yang diminimalkan dapat memperbaiki pengalaman pengguna, tambahkan dukungan untuk fungsionalitas Picture-in-Picture.
- Lakukan pengoptimalan untuk perangkat dengan potongan layar.
- Jangan mengasumsikan tinggi status bar. Namun, sebaiknya gunakan
WindowInsets
danView.OnApplyWindowInsetsListener
. Tonton video ini untuk melihat penjelasannya. - Jangan berasumsi bahwa aplikasi dapat mengisi seluruh jendela. Namun, konfirmasikan
lokasinya menggunakan
View.getLocationInWindow()
, bukanView.getLocationOnScreen()
. - Saat menangani
MotionEvent
, gunakanMotionEvent.getX()
danMotionEvent.getY()
, bukanMotionEvent.getRawX()
danMotionEvent.getRawY()
.
Memeriksa serta mengupdate SDK dan library
Pastikan dependensi SDK pihak ketiga Anda mendukung API 29: Beberapa penyedia SDK memublikasikannya dalam manifes mereka, sedangkan yang lainnya memerlukan penyelidikan tambahan. Jika Anda menggunakan SDK yang tidak mendukung API 29, sebaiknya segera hubungi penyedia SDK untuk mengatasi masalah tersebut.
Selain itu, perlu diperhatikan bahwa targetSdkVersion
aplikasi atau game Anda dapat membatasi
akses ke library platform Android pribadi; lihat Penautan Aplikasi NDK
ke Library Platform untuk mengetahui detailnya.
Anda juga harus memverifikasi pembatasan apa pun yang mungkin ada dalam versi Android Support Library yang Anda gunakan.
Seperti biasa, Anda harus memastikan kompatibilitas versi utama Android Support Library dengan compileSdkVersion
aplikasi Anda.
Sebaiknya pilih targetSdkVersion
yang lebih kecil dari atau sama dengan versi utama Support Library. Kami mengimbau Anda untuk melakukan update ke Support Library terbaru yang kompatibel agar dapat memanfaatkan fitur kompatibilitas dan perbaikan bug terbaru.
Menguji aplikasi
Setelah memperbarui level dan fitur API aplikasi sebagaimana mestinya, Anda harus menguji beberapa kasus penggunaan inti. Saran berikut tidak lengkap, tetapi dimaksudkan untuk memandu proses pengujian. Sebaiknya uji:
- Apakah aplikasi Anda dikompilasi ke API 29 tanpa error atau peringatan.
- Apakah aplikasi Anda memiliki strategi untuk kasus ketika pengguna menolak
permintaan izin, dan meminta pengguna untuk memberikan izin. Untuk melakukannya:
- Buka layar Info Aplikasi pada aplikasi Anda, dan nonaktifkan setiap izin.
- Buka aplikasi dan pastikan tidak ada error.
- Lakukan tes kasus penggunaan inti dan pastikan izin yang diperlukan diminta kembali.
- Menangani mode Istirahatkan dengan hasil yang diharapkan dan tanpa error.
- Dengan adb, atur perangkat uji ke dalam mode Istirahatkan saat aplikasi sedang berjalan.
- Uji setiap kasus penggunaan yang memicu pesan Firebase Cloud Messaging.
- Uji setiap kasus penggunaan yang menggunakan Alarm atau Tugas.
- Hilangkan semua dependensi pada layanan latar belakang.
- Setel aplikasi ke mode Aplikasi Standby
- Uji setiap kasus penggunaan yang memicu pesan Firebase Cloud Messaging.
- Uji setiap kasus penggunaan yang menggunakan Alarm.
- Dengan adb, atur perangkat uji ke dalam mode Istirahatkan saat aplikasi sedang berjalan.
- Menangani foto/video baru yang sedang diambil
- Periksa apakah aplikasi Anda
menangani siaran
ACTION_NEW_PICTURE
danACTION_NEW_VIDEO
yang dibatasi dengan benar (yaitu, dipindahkan ke tugas JobScheduler). - Pastikan setiap kasus penggunaan penting yang bergantung pada peristiwa tersebut tetap berjalan.
- Periksa apakah aplikasi Anda
menangani siaran
- Menangani berbagi file ke aplikasi lain
- Uji setiap kasus penggunaan yang membagikan data file dengan aplikasi lain (bahkan aplikasi lain dari developer yang sama)
- Uji bahwa konten terlihat di aplikasi lain dan tidak memicu error.
Informasi lebih lanjut
Ikut serta dalam langganan email di Konsol Google Play agar kami dapat mengirimkan informasi terbaru dan pengumuman penting dari Android dan Google Play, termasuk newsletter partner bulanan kami.