Persyaratan ARCore 64-bit

Pada Agustus 2020, Layanan Google Play untuk AR (ARCore) menghapus dukungan untuk aplikasi khusus 32-bit di beberapa perangkat 64-bit. Dukungan untuk aplikasi dengan ARCore khusus 32-bit pada perangkat 64-bit yang tersisa dapat dihapus tanpa pemberitahuan dalam rilis ARCore mendatang. Aplikasi berkemampuan ARCore khusus 32-bit yang berjalan di perangkat 32-bit tidak akan terpengaruh dan akan terus didukung.

Jika Anda memublikasikan versi 32-bit saja (misalnya, armeabi-v7a) aplikasi berkemampuan ARCore tanpa memublikasikan versi 64-bit (arm64-v8a) yang sesuai untuk perangkat 64-bit, Anda harus mengupdate aplikasi dengan versi 64-bit yang kompatibel untuk perangkat 64-bit.

Aplikasi berkemampuan ARCore khusus 32-bit yang tidak diupdate akan gagal membuat sesi ARCore dan mungkin mengalami error saat mencoba memulai sesi augmented reality (AR) pada perangkat 64-bit yang terpengaruh.

Jika Anda menetapkan atribut android:use32bitAbi="true" di AndroidManifest.xml aplikasi, aplikasi hanya akan menggunakan library 32-bit. Pengalaman AR apa pun di aplikasi Anda akan mencoba menggunakan ARCore dalam mode 32-bit. Namun, library 32-bit tidak akan ada dalam layanan Layanan Google Play untuk AR di beberapa perangkat 64-bit. Tanpa library ini, aplikasi Anda akan gagal membuat sesi ARCore dan dapat mengalami error saat mencoba memulai sesi augmented reality (AR) di perangkat 64-bit yang terpengaruh. Hal ini memengaruhi pengalaman AR native dan pengalaman AR berbasis WebXR dalam komponen WebView.

Persyaratan Google Play Store 64-bit

Persyaratan ARCore 64-bit yang dijelaskan di bagian sebelumnya berlaku untuk semua perangkat 64-bit, terlepas dari versi Android dan level API. Persyaratan ini terpisah dan tidak terkait dengan persyaratan 64-bit Google Play yang berlaku pada 1 Agustus 2019, yang dievaluasi pada tingkat rilis aplikasi dan hanya berlaku untuk APK atau app bundle yang didistribusikan ke perangkat yang menjalankan Android 9 Pie (level API 28) atau yang lebih baru.

Memahami dukungan ABI ARCore

ARCore memungkinkan Anda membuat aplikasi yang mendukung ABI Android berikut:

Saat Anda mem-build aplikasi yang mendukung ARCore, sistem build Android akan menyertakan satu atau beberapa library native ARCore (lib/…/libarcore_sdk*.so) untuk ABI Android yang ditargetkan oleh aplikasi Anda.

Aplikasi khusus 32-bit yang mendukung ARCore sebelumnya dapat berjalan di perangkat 32-bit dan 64-bit. Pada bulan Agustus 2020, Layanan Google Play untuk AR (ARCore) berhenti menyertakan library native 32-bit di beberapa perangkat 64-bit, dan pada saat itu hanya aplikasi berkemampuan ARCore 32-bit tidak lagi dapat berjalan di perangkat 64-bit yang terpengaruh. Dalam rilis mendatang, dukungan untuk aplikasi khusus 32-bit yang mendukung ARCore juga dapat dihapus tanpa pemberitahuan dari perangkat 64-bit lainnya.

Aplikasi berkemampuan ARCore khusus 32-bit yang tidak diupdate akan gagal membuat sesi dan mungkin akan error saat mencoba memulai sesi augmented reality (AR) pada perangkat 64-bit yang terpengaruh, khususnya:

SDK ARCore Detail kegagalan pembuatan sesi
ARCore SDK untuk Android (NDK) ArSession_create dan ArSession_createWithFeatures akan menampilkan AR_ERROR_FATAL.
ARCore SDK untuk Android (Java) Konstruktor Sesi, Session(Context) dan Session(Context, Set<Session.Feature>), akan menampilkan FatalException.
ARCore SDK untuk Unity Saat Anda mengaktifkan komponen ARCoreSession, yang biasanya ditemukan di prefab Perangkat ARCore, ARCore akan gagal membuat sesi ARCore dan Session.Status akan menjadi SessionStatus.FatalError.
AR Foundation (Unity)
+ Plugin ARCore XR
Aplikasi akan berhenti melakukan rendering (layar hitam) saat mencoba memulai sesi AR, karena terjadi error pada thread utama saat mencoba memuat library native ARCore 32-bit yang tidak ada.

Menentukan apakah aplikasi Anda harus diupdate

Untuk memeriksa apakah aplikasi yang dipublikasikan menyertakan library ARCore native yang diperlukan untuk mendukung perangkat 64-bit:

  1. Buka Konsol Google Play.

  2. Pilih aplikasi berkemampuan ARCore.

  3. Perluas rilis aktif aplikasi untuk memverifikasi bahwa Platform native menyertakan dukungan 64-bit (arm64-v8a).

Mengupdate aplikasi Anda untuk mendukung perangkat 64-bit

Untuk mengupdate aplikasi khusus 32-bit yang mendukung ARCore agar menyertakan library native 64-bit:

  1. Update project Anda untuk menggunakan ARCore SDK terbaru.

  2. Build aplikasi dan publikasikan menggunakan Konsol Google Play.

Google Play akan memverifikasi bahwa aplikasi Anda memenuhi persyaratan 64-bit Google Play Store yang sebelumnya berlaku pada 1 Agustus 2019. Untuk memastikan bahwa aplikasi Anda yang berkemampuan ARCore menyertakan dukungan 64-bit (arm64-v8a) untuk semua perangkat 64-bit, apa pun versi Android atau level API.