Table of Contents

Panduan migrasi EasyAR Sense Unity Plugin

Artikel ini menjelaskan cara bermigrasi dari versi EasyAR Sense Unity Plugin lama ke versi baru。

Catatan kompatibilitas

Mulai dari versi 4000, EasyAR Sense Unity Plugin mengikuti Package Versioning (menggunakan Semantic Versioning) yang disyaratkan oleh Unity, dan kompatibilitas dapat ditentukan berdasarkan nomor versi.

4.7 adalah versi pembaruan bertahap, dan dua versi 4.7 mana pun tidak kompatibel.

Untuk versi sebelum 4.7, hanya nomor versi ketiga yang menunjukkan kompatibilitas mundur, perubahan pada dua nomor versi pertama menunjukkan ketidakcocokan. Misalnya, 4.6.2 kompatibel dengan 4.6.1, tetapi 4.6.0 tidak kompatibel dengan 4.5.0.

Peringatan

Memodifikasi file tgz atau tidak memperbarui seluruh plugin secara lengkap setelah diekstrak akan menyebabkan ketidakcocokan.

Panduan migrasi umum

Bermigrasi ke versi baru memerlukan penghapusan paket plugin versi lama dan penambahan paket baru terlebih dahulu menggunakan Package Manager window.

Disarankan untuk mengikuti langkah-langkah berikut:

  1. Tutup Unity yang sedang digunakan.
  2. Hapus direktori kompilasi platform yang dibuat saat Unity memaket aplikasi.
  3. Buka kembali proyek Unity, lalu hapus EasyAR Sense Unity Plugin versi lama dari proyek.
  4. Impor versi EasyAR Sense Unity Plugin yang baru.

Catatan

File contoh yang disediakan oleh plugin tidak dijamin kompatibel antar versi. Setelah plugin ditingkatkan, contoh yang diimpor ke proyek mungkin tidak berfungsi dengan baik, disarankan untuk menghapus contoh versi lama sebelum melanjutkan.

EasyAR berisi file pustaka asli. Jika fungsi pustaka dijalankan sebelum penghapusan atau penggantian (juga dipanggil saat pemaketan), file pustaka ini akan dikunci oleh sistem dan tidak dapat dihapus atau diganti.

Penting

Sebelum menghapus versi lama, pastikan tidak ada skenario yang berjalan di editor atau aplikasi yang dipaket untuk platform apa pun. Biasanya disarankan untuk menutup Unity sebelum menghapus atau mengganti paket, dan menggantinya segera setelah dibuka kembali.

Sebelum memaket ulang menggunakan plugin versi baru, Anda perlu menghapus direktori kompilasi platform yang dihasilkan oleh pemaketan Unity, termasuk direktori proyek Gradle yang dihasilkan oleh pemaketan Android, dan direktori Xcode yang dihasilkan oleh pemaketan iOS.

Kiat

Biasanya direktori ini mungkin berada di dalam folder Library proyek Unity (misalnya Library/Bee/Android/Prj/IL2CPP/Gradle), tetapi mungkin berbeda untuk versi Unity yang berbeda.

Jika Anda pernah memaket tetapi tidak dapat menemukan direktori platform yang sesuai, disarankan untuk menghapus seluruh folder Library.

Jika pengecualian SchemaHashNotMatched muncul setelah migrasi, biasanya ada dua kemungkinan

  1. Operasi sebelumnya tidak dilakukan dengan benar menyebabkan kegagalan atau ketidaklengkapan peningkatan, atau direktori kompilasi yang dibuat Unity tidak diperbarui dengan benar (Catatan: jika tidak dihapus secara manual, kemungkinan besar akan terjadi kesalahan). Disarankan untuk mengikuti langkah yang disarankan atau mengompilasi ulang menggunakan proyek tanpa cache Library.
  2. File tgz EasyAR dimodifikasi secara manual atau seluruh plugin tidak diperbarui secara lengkap setelah diekstrak. Dalam kasus ini, EasyAR tidak dapat menjamin ketersediaan, Anda perlu mengunduh ulang paket yang benar dan mengimpornya.
Penting

Karena file pustaka EasyAR Sense dan lokasi file pustaka setelah pemaketan mungkin berubah, jika Anda menyimpan proyek Gradle atau Xcode yang dibuat oleh Unity, Anda harus menghapus semua file yang terkait dengan EasyAR sebelumnya, seperti EasyAR.aar, libEasyAR.so, easyar.framework, dll.

Bermigrasi ke versi 4002

Saat bermigrasi dari versi 4001 ke 4002, selain panduan migrasi umum di atas, Anda juga perlu memperhatikan konten berikut.

Perubahan antarmuka

Modul Fungsi v4001 API v4002 API Petunjuk Penggunaan
Fungsi Bantuan Image.Image(Buffer, PixelFormat, int, int) Image.create

Bermigrasi ke versi 4001

Kiat

Hanya ada perubahan yang tidak kompatibel saat menggunakan Mega, penggunaan fungsi lain tidak terpengaruh.

Saat bermigrasi dari versi 4000 ke 4001, selain panduan migrasi umum di atas, Anda juga perlu memperhatikan konten berikut.

Perubahan antarmuka

Modul Fungsi v4000 API v4001 API Petunjuk Penggunaan
Mega MegaTrackerFrameFilter.ResultPoseType.EnableLocalization MegaTrackerFrameFilter.EnableLocalization Kontrol proses pelacakan Mega
Mega MegaTrackerFrameFilter.ResultPoseType.EnableStabilization - Fungsi telah dihapus

Migrasi versi historis

Saat bermigrasi dari versi sebelum 4000, Anda perlu merujuk pada konten berikut:

Topik terkait