Pada November 2022, Layanan Google Play untuk AR akan menghapus metode yang tidak digunakan lagi terkait gambar dan metadata kamera NDK.
Aplikasi yang menggunakan metode ini dalam versi ARCore SDK yang terpengaruh mungkin mulai berperilaku berbeda atau error saat pengguna mengupdate Layanan Google Play untuk AR.
Aplikasi yang terkena dampak
Mulai November 2022, aplikasi Anda dapat berhenti berfungsi atau tidak berfungsi saat pengguna mengupdate ke Layanan Google Play untuk AR versi terbaru jika:
- Aplikasi Anda dikompilasi dengan SDK yang terpengaruh
- Aplikasi Anda menggunakan salah satu API yang terpengaruh berikut:
Jika aplikasi Anda dikompilasi dengan versi ARCore SDK... |
Dan menggunakan API yang terpengaruh... | Perilaku yang dapat menyebabkan gangguan mulai November 2022 |
---|---|---|
1.22.0 atau yang lebih rendah | ArImage_getNdkImage() (dihapus di ARCore SDK 1.23.0) |
Menampilkan NULL dalam struct AImage yang dihasilkan. |
1.22.0 atau yang lebih rendah | ArImage_getNdkCameraMetadata() (dihapus di ARCore SDK 1.23.0) |
Menampilkan NULL dalam struct ACameraMetadata yang dihasilkan. |
Perbaiki aplikasi yang terpengaruh
Aplikasi yang terpengaruh mungkin akan mengalami kerusakan pada November 2022. Untuk mengurangi hal ini, gunakan pengganti drop-in untuk metode yang terpengaruh:
- Metode
ArImage_getNdkImage()
danAImage_*
: Gunakan metode yang sesuai dariArImage
. Contoh: ArImage_getNdkCameraMetadata()
: GunakanArImageMetadata_getConstEntry()
sebagai gantinya
Memverifikasi bahwa aplikasi yang terpengaruh telah diperbaiki
Uji aplikasi dengan menyimulasikan perubahan November 2022 terlebih dahulu dengan menambahkan entri meta-data
khusus ke AndroidManifest.xml
aplikasi Anda:
- Pastikan Layanan Play untuk AR versi 1.29.0 atau yang lebih tinggi diinstal di perangkat target.
Tambahkan tag
<meta-data>
baru sebagai turunan dari elemen<application>
yang ada di fileAndroidManifest.xml
aplikasi:<application …> … <!-- Simulate the November 2022 changes in advance. IMPORTANT: Remove this tag when testing is completed. Do not include this tag in published versions of your app. --> <meta-data android:name="com.google.ar.core.session_settings" android:value="camera_stack_option,unified_mono" /> </application>
Uji aplikasi Anda dan pastikan semua fitur ARCore berfungsi seperti yang diharapkan.
Hapus tag
<meta-data>
saat pengujian selesai. Membiarkan tag ini di aplikasi yang dipublikasikan dapat menyebabkan perilaku tidak terduga di masa mendatang.
Jika aplikasi berfungsi normal, aplikasi tersebut sudah siap untuk melakukan perubahan pada November 2022.
Rentang waktu
Periode | Peristiwa |
---|---|
November 2020 (ARCore SDK versi 1.20.0) |
Menghentikan penggunaan API yang terpengaruh, memperkenalkan alternatif API siap pakai. |
Februari 2021 (ARCore SDK versi 1.23.0) |
Menghapus tanda tangan API sebelumnya yang tidak digunakan lagi dari ARCore SDK. |
November 2021 | Mengumumkan perubahan yang dapat menyebabkan gangguan pada masa mendatang karena implementasi API yang terpengaruh masih menunggu penghapusan dari Layanan Google Play untuk AR pada November 2022. |
November 2022 |
Menghapus implementasi API yang terpengaruh dari
Layanan Google Play untuk AR. Memperkenalkan perubahan yang dapat menyebabkan gangguan untuk aplikasi yang menggunakan versi ARCore sebelum 1.23.0. |