Memenuhi persyaratan API level target Google Play

Saat diupload, APK harus memenuhi persyaratan API level target Google Play. Aplikasi baru harus menargetkan Android 10 (API level 29)* atau yang lebih tinggi, dan update aplikasi harus menargetkan Android 9 (API level 28) atau yang lebih tinggi.

* Aplikasi Wear OS tidak tunduk pada persyaratan API level 29

Setiap versi Android baru memperkenalkan perubahan yang menghadirkan peningkatan keamanan dan performa yang signifikan serta meningkatkan 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>.

Melakukan migrasi dari Android 9 (API level 28) ke Android 10 (API level 29)

Untuk melihat daftar lengkap perubahan yang diperkenalkan pada Android 10 (API level 29), lihat halaman Perubahan Perilaku untuk versi platform tersebut.

Melakukan migrasi dari versi di bawah Android 9 (API level 28)

Harap pilih versi Android tempat 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 Waktu Proses

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

  • Mode 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 GPS dan Wi-Fi.
    • 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:

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)

Untuk melihat daftar lengkap perubahan yang diperkenalkan pada Android 9.0 (API level 28), lihat perubahan perilaku.

Lanjutkan untuk mengupdate ke API 29 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.

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.
  • Menangani foto/video baru yang sedang diambil
  • 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.