Table of Contents

Panduan migrasi EasyAR Sense Unity Plugin

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

Kompatibilitas penjelasan

Dimulai dari versi 4000, EasyAR Sense Unity Plugin mengikuti kontrol versi paket (menggunakan Semantic Versioning) yang diperlukan oleh Unity, kompatibilitas dapat dinilai berdasarkan nomor versi.

4.7 adalah versi pembaruan bertahap, tidak ada dua versi 4.7 yang 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 memperbarui seluruh plugin secara tidak lengkap setelah mengekstrak akan menyebabkan ketidakcocokan.

Panduan migrasi umum

Migrasi ke versi baru memerlukan penghapusan paket plugin versi lama menggunakan Package Manager window dan menambahkan paket baru.

Disarankan untuk mengikuti langkah-langkah berikut:

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

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 beroperasi.

EasyAR berisi file pustaka asli, jika fungsi pustaka telah dieksekusi (juga akan dipanggil saat pembuatan paket) sebelum penghapusan atau penggantian, file-file ini akan dikunci oleh sistem dan tidak dapat dihapus atau diganti.

Penting

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

Sebelum membuat paket ulang dengan versi plugin baru, Anda perlu menghapus direktori kompilasi platform yang dihasilkan oleh Unity, termasuk direktori proyek Gradle yang dihasilkan untuk Android, serta direktori Xcode yang dihasilkan untuk iOS.

Kiat

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

Jika Anda telah membuat paket tetapi tidak dapat menemukan direktori untuk platform yang sesuai, disarankan untuk menghapus seluruh folder Library.

Jika setelah migrasi muncul pengecualian SchemaHashNotMatched, biasanya ada dua kemungkinan

  1. Operasi sebelumnya tidak dilakukan dengan benar yang mengakibatkan kegagalan atau ketidaklengkapan pembaruan, atau direktori kompilasi yang dihasilkan Unity tidak diperbarui dengan benar (perhatikan: jika tidak dihapus secara manual, kemungkinan besar akan terjadi kesalahan). Disarankan untuk mengikuti langkah-langkah yang disarankan atau menggunakan proyek tanpa cache Library untuk mengkompilasi ulang.
  2. File tgz EasyAR dimodifikasi secara manual atau tidak diperbarui seluruhnya setelah diekstrak. Dalam hal ini EasyAR tidak dapat menjamin ketersediaan, perlu mengunduh ulang paket yang benar dan mengimpornya.
Penting

Karena file pustaka EasyAR Sense serta lokasi file pustaka setelah dipaketkan dapat berubah, jika Anda menyimpan proyek Gradle atau Xcode yang dihasilkan Unity, Anda harus menghapus semua file yang terkait dengan EasyAR terlebih dahulu, seperti EasyAR.aar, libEasyAR.so, easyar.framework, dll.

Migrasi 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, perhatikan juga konten berikut.

Perubahan antarmuka

Modul fungsional API v4000 API v4001 Instruksi penggunaan
Mega MegaTrackerFrameFilter.ResultPoseType.EnableLocalization MegaTrackerFrameFilter.EnableLocalization Kontrol proses pelacakan Mega
Mega MegaTrackerFrameFilter.ResultPoseType.EnableStabilization - Fitur dihapus

Migrasi versi sebelumnya

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

Topik terkait