Memenuhi persyaratan level API target Google Play

Bermigrasi dari versi di bawah Android 11 (level API 30)

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:

• Android 5.0 (API Level 21)
• Android 4.4 (API level 19).
• Android 4.1.x (level API 16).

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 Runtime

  • 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 memicu FileUriExposedException. Jika perlu berbagi file di luar aplikasi, implementasikan FileProvider

• 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, sementara startService() dilarang.
    • Untuk memulai layanan latar depan, aplikasi harus menggunakan startForeground() dan startForegroundService().
    • 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 menggunakan 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.
  • 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.
• 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.

Bermigrasi 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)
• 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.

Bermigrasi dari Android 9 (level API 28) ke Android 10 (level API 29)

• Notifikasi dengan intent layar penuh
  • Perlu meminta izin normal USE_FULL_SCREEN_INTENT (bukan izin runtime).
• 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() dan onPause().
    • Konsep siklus proses baru dari "dilanjutkan teratas" yang dapat dideteksi dengan berlangganan ke onTopResumedActivityChanged().
      • Hanya satu aktivitas yang dapat menjadi "dilanjutkan teratas".
  • Saat resizeableActivity disetel ke false, aplikasi juga dapat menentukan minAspectRatio, yang otomatis menjadikan aplikasi tersebut memiliki tampilan lebar pada rasio lebar tinggi yang lebih sempit.
• 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 atau WifiNetworkSuggestion.

Bermigrasi dari Android 10 (API level 29) ke Android 11 (API level 30)

• Privasi
  • Penerapan 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 utamanya berfungsi 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 kueri untuk layanan ke file manifes.
• 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.

Untuk mengetahui daftar lengkap perubahan yang diperkenalkan di Android 11 (API level 30), lihat halaman Perubahan Perilaku.

Lanjutkan untuk mengupdate ke API 31 dengan mengikuti petunjuk di bagian sebelumnya.