Keperluan tahap API sasaran untuk apl Google Play

Untuk menjadikan tarikh akhir tahap API sasaran lebih jelas, kami menyeragamkan tarikh pada 31 Ogos setiap tahun.

Mulai 31 Ogos 2023:

  • Apl baharu perlu menyasarkan Android 13 (tahap API 33) atau lebih tinggi; kecuali untuk apl Wear OS, yang perlu menyasarkan Android 11 (tahap API 30) atau maksimum Android 13 (tahap API 33).
  • Apl sedia ada mestilah menyasarkan tahap API 31 ke atas untuk kekal tersedia kepada pengguna pada peranti yang menjalankan Android OS yang lebih tinggi daripada tahap API sasaran apl anda. Apl yang menyasarkan tahap API 30 ke bawah (tahap API sasaran 29 ke bawah untuk Wear OS) hanya akan tersedia pada peranti yang menjalankan Android OS yang setara atau lebih rendah daripada tahap API sasaran apl anda.
Anda boleh meminta pelanjutan hingga 1 November 2023, jika anda memerlukan lebih banyak masa untuk mengemaskinikan apl anda. Anda boleh mengakses borang pelanjutan apl anda dalam Play Console pada awal bulan Ogos jika anda terjejas, pada halaman status Dasar dengan mengklik pada amaran atau masalah yang berkaitan.

Setiap versi Android baharu memperkenalkan perubahan yang meningkatkan pengalaman pengguna, keselamatan dan prestasi platform Android secara keseluruhan. Setiap apl menetapkan targetSdkVersion (turut dikenali sebagai tahap API sasaran) dalam fail manifes. Tahap API sasaran menunjukkan cara apl anda seharusnya dijalankan pada pelbagai versi Android.

Tindakan mengkonfigurasikan apl anda untuk menyasarkan tahap API terbaharu akan memastikan pengguna mendapat manfaat daripada peningkatan keselamatan, privasi dan prestasi, di samping masih membenarkan apl dijalankan pada versi Android yang lebih lama (setakat minSdkVersion yang ditentukan).

Untuk menyediakan pengalaman yang selamat bagi pengguna Android dan Google Play, Google Play menghendaki semua apl memenuhi keperluan tahap API sasaran yang disenaraikan di bawah.

Pengecualian terhadap keperluan ini termasuk:

  • Apl peribadi kekal yang terhad kepada pengguna dalam organisasi tertentu dan khusus untuk pengedaran dalaman sahaja. 
  • Apl yang menyasarkan faktor bentuk automotif dan dihimpunkan dalam pakej yang sama boleh ditemukan secara kekal oleh semua pengguna Google Play.

Takrif

Apl baharu Apl yang belum diterbitkan pada Google Play (sebagai contoh, apl serba baharu).
Apl sedia ada Apl yang diterbitkan pada Google Play.
Kemaskinian apl Versi baharu apl yang diserahkan untuk semakan untuk menggantikan apl anda yang sedia ada.

Keperluan kemaskinian apl

Versi Android OS
(Tahap API)

Bilakah serahan apl baharu dan kemaskinian apl diperlukan untuk menyasarkan tahap API ini?
Apl baharu Kemaskinian apl

Android 13 (tahap API 33)*

31 Ogos 2023

31 Ogos 2023

Android 12 (tahap API 31)

31 Ogos 2022

1 November 2022

*Untuk memudahkan lagi proses peralihan bagi pembangun, pembangun boleh meminta pelanjutan hingga 1 November.

Petua: Dapatkan panduan teknikal tentang cara menukar tahap API sasaran apl anda untuk memenuhi keperluan ini dengan merujuk panduan penghijrahan.

Keperluan apl Wear OS

Versi Android OS (tahap API)

Bilakah serahan apl Wear OS perlu menyasarkan tahap API ini?
Apl baharu Kemaskinian apl
Android 11 (tahap API 30) (tiada perubahan) 1 Ogos 2022 1 November 2022

Keperluan ketersediaan apl

Pada masa ini, apl sedia ada (merentas telefon mudah alih, Android Auto, Android TV) hendaklah menyasarkan tahap API 31 ke atas selewat-lewatnya pada 31 Ogos 2023 (API sasaran 30 atau maksimum tahap API 33 untuk Wear OS). Jika tidak, apl itu tidak dapat ditemukan lagi oleh semua pengguna Google Play yang menjalankan versi Android OS yang lebih baharu pada peranti mereka berbanding tahap API sasaran apl anda kerana apl anda tidak dibina untuk memenuhi standard keselamatan dan kualiti yang dijangkakan oleh pengguna ini daripada versi Android OS yang lebih baharu.

  • Apl pada tahap sasaran Android 11 (tahap API 30)* ke bawah tidak akan tersedia untuk pengguna baharu yang menjalankan Android OS yang lebih tinggi daripada API sasaran apl selepas 31 Ogos 2023.
  • Apl dengan tahap sasaran Android 10 (tahap API 29) ke bawah tidak tersedia untuk pengguna baharu yang menjalankan Android OS yang lebih tinggi daripada API sasaran apl selepas 1 November 2022 atau 1 Mei 2023, jika apl anda diberi pelanjutan.

*Untuk memudahkan proses peralihan bagi pembangun, pembangun boleh meminta pelanjutan hingga 1 November 2023. Anda boleh mengakses borang pelanjutan apl anda dalam Play Console pada awal bulan Ogos jika anda terjejas, pada halaman status Dasar dengan mengklik pada masalah yang berkaitan.


Perkara yang perlu dilakukan untuk mematuhi dasar

Apl baharu

Apl sedia ada

Apabila anda menerbitkan apl baharu, anda hendaklah menyasarkan API 33 ke atas.

Jika tahap API sasaran apl anda yang sedia ada ialah 31 ke atas, maka apl anda mematuhi dasar ini.

Jika sasaran apl anda yang sedia ada kurang daripada API 31, apl itu tidak akan tersedia lagi untuk semua pengguna Google Play yang menjalankan versi Android OS yang lebih baharu pada peranti mereka berbanding dengan tahap API sasaran apl anda kerana apl anda tidak dibina untuk memenuhi standard keselamatan dan kualiti yang dijangkakan oleh pengguna ini daripada versi Android OS yang lebih baharu.

  • Jika anda merancang untuk mengemaskinikan apl ini kepada tahap API sasaran yang lebih tinggi, anda boleh menyerahkan permintaan pelanjutan masa supaya apl anda dapat terus diedarkan kepada semua pengguna pada Google Play hingga 1 November 2023. Apl yang terjejas akan menerima amaran dasar dan mesej peti masuk dalam Play Console dan anda akan dapat mengakses borang permintaan pelanjutan daripada halaman butiran amaran atau masalah, yang diakses melalui halaman status Dasar.
Apabila anda mengemaskinikan apl, anda mestilah menyasarkan API 33 ke atas.


keperluan Wear OS

Apl baharu

Apl sedia ada

Apabila anda menerbitkan apl baharu, anda mestilah menyasarkan API 30 atau maksimum Android 13 (tahap API 33).

Jika tahap API sasaran apl sedia ada anda ialah 30 atau maksimum Android 13 (tahap API 33), maka apl anda mematuhi dasar ini.

Jika sasaran apl anda yang sedia ada kurang daripada API 30, apl itu tidak akan tersedia lagi untuk semua pengguna Google Play yang menjalankan versi Android OS yang lebih baharu pada peranti mereka berbanding dengan tahap API sasaran apl anda kerana apl anda tidak dibina untuk memenuhi standard keselamatan dan kualiti yang dijangkakan oleh pengguna ini daripada versi Android OS yang lebih baharu.

  • Jika anda merancang untuk mengemaskinikan apl ini kepada tahap API sasaran 30, anda boleh menyerahkan permintaan pelanjutan masa supaya apl anda dapat terus diedarkan kepada semua pengguna pada Google Play hingga 1 November 2023. Apl yang terjejas akan menerima amaran dasar dan mesej peti masuk dalam Play Console dan anda akan dapat mengakses borang permintaan pelanjutan daripada halaman butiran amaran atau masalah, yang diakses melalui halaman status Dasar.
Apabila anda mengemaskinikan apl, anda mestilah menyasarkan API 30 atau maksimum Android 13 (tahap API 33).

Soalan lazim

Untuk apl yang menyasarkan API 30 ke bawah

Saya mempunyai apl langsung pada Google Play yang menyasarkan API 30 ke bawah (apl menyasarkan API 29 ke bawah untuk Wear OS) yang saya tidak mahu kemas kinikan. Apakah pilihan saya?

Jika anda mahu terus menyediakan apl ini untuk pengguna anda yang sedia ada, anda tidak perlu melakukan apa-apa. Walau bagaimanapun, apl anda tidak akan tersedia pada Google Play kepada pengguna baharu pada peranti yang menjalankan Android OS yang lebih baharu berbanding dengan sasaran apl anda. Apl tersebut akan tersedia hanya untuk pengguna Google Play yang menggunakan peranti yang menjalankan Android OS pada tahap API apl anda atau lebih rendah.

Selewat-lewatnya pada 31 Ogos 2023, apl anda mestilah memenuhi keperluan tahap API sasaran ini, jika tidak apl itu tidak akan dapat ditemukan lagi oleh semua pengguna Google Play yang menjalankan versi Android OS yang lebih baharu pada peranti mereka berbanding dengan tahap API sasaran apl anda.

Jika anda merancang untuk mengemaskinikan apl anda kepada API sasaran yang lebih baharu dan memerlukan lebih banyak masa hingga selepas 31 Ogos, anda boleh meminta pelanjutan masa supaya dapat terus mengedarkan apl anda kepada semua pengguna Google Play hingga 1 November. Borang pelanjutan akan tersedia nanti pada tahun ini dalam Play Console.

Jika anda mahu berhenti menyediakan apl anda kepada pengguna baharu walaupun pada peranti yang lebih lama, anda boleh menyahterbitkan apl anda.

Di manakah saya boleh mendapatkan borang pelanjutan untuk terus mengedarkan apl kepada semua pengguna Google Play hingga 1 November 2023?

Hanya apl yang tidak mematuhi dasar akan menerima amaran dasar dan mesej Peti Masuk dalam Play Console. Borang pelanjutan tersedia melalui halaman butiran amaran atau masalah, yang tersedia pada halaman status Dasar dalam Play Console.

Saya mempunyai apl yang tidak mahu saya terbitkan pada Google Play lagi. Apakah tindakan yang boleh saya lakukan?

Untuk mengakses arahan tentang cara menyahterbitkan apl anda, lihat Kemas kinikan atau nyahterbitkan apl anda.

Adakah perkara ini akan menjejaskan pengguna saya yang telah memuat turun apl saya?

Pengguna yang sebelum ini telah memasang apl daripada Google Play tidak akan terjejas dan masih dapat menemukan, memasang semula dan menggunakan apl itu pada mana-mana versi Android OS yang disokong oleh apl anda.

Adakah kemaskinian ini akan memberikan kesan kepada muat turun apl?

Kemaskinian ini mungkin memberikan kesan kepada tahap muat turun apl jika pengguna baharu yang menggunakan peranti dengan versi Android OS yang lebih baharu tidak dapat menemukan atau memuat turun apl anda daripada Google Play.

Bagaimanakah pengalaman pengguna jika pengguna yang menggunakan peranti lebih baharu melawati pautan dalam kepada halaman gedung apl tetapi apl itu menyasarkan API 30 ke bawah?

Google Play akan memaklumi pengguna bahawa "apl ini tidak tersedia untuk dipasang pada peranti mereka kerana apl tersebut dibuat untuk versi Android yang lebih lama".

Adakah terdapat sebarang pengecualian untuk apl sedia ada yang menyasarkan API 30 ke bawah?

Ya. Kami menyediakan pengecualian untuk apl peribadi kekal yang terhad kepada pengguna dalam organisasi tertentu dan khusus untuk pengedaran dalaman sahaja serta apl yang menyasarkan faktor bentuk Android Automotive OS juga dikecualikan.

Adakah perkara ini membantu?

Bagaimanakah dapat kami meningkatkannya?

Perlukan bantuan lanjut?

Cuba langkah seterusnya ini:

Cari
Kosongkan carian
Tutup carian
Menu utama
6858168811912055397
true
Cari di Pusat Bantuan
true
true
true
true
true
92637
false
false