Table of Contents

EasyAR Sense Unity Plugin Guida alla migrazione

Questo documento descrive come migrare dalla vecchia versione di EasyAR Sense Unity Plugin alla nuova versione.

Note sulla compatibilità

A partire dalla versione 4000, EasyAR Sense Unity Plugin segue il versioning dei pacchetti (utilizzando Semantic Versioning) richiesto da Unity; la compatibilità può essere determinata in base al numero di versione.

4.7 è una versione di aggiornamento graduale; qualsiasi due versioni 4.7 non sono compatibili.

Per le versioni precedenti alla 4.7, solo il terzo numero di versione indica la compatibilità con le versioni precedenti; le modifiche ai primi due numeri di versione indicano incompatibilità. Ad esempio, 4.6.2 è compatibile con 4.6.1, ma 4.6.0 non è compatibile con 4.5.0.

Avvertenza

La modifica del file tgz o l'aggiornamento incompleto dell'intero plugin dopo l'estrazione porterà all'incompatibilità.

Guida generale alla migrazione

Per migrare alla nuova versione, è necessario utilizzare prima la finestra di Package Manager per rimuovere il vecchio pacchetto plugin e aggiungere il nuovo pacchetto.

Si consiglia di seguire questi passaggi:

  1. Chiudere Unity in uso.
  2. Eliminare la directory di compilazione della piattaforma generata quando Unity crea il pacchetto dell'applicazione.
  3. Riaprire il progetto Unity e rimuovere la vecchia versione di EasyAR Sense Unity Plugin dal progetto.
  4. Importare la nuova versione di EasyAR Sense Unity Plugin.

Nota

I file di esempio forniti dal plugin non sono garantiti per essere compatibili tra le versioni. Dopo l'aggiornamento del plugin, gli esempi importati nel progetto potrebbero non funzionare correttamente; si consiglia di eliminare i vecchi esempi prima di procedere.

EasyAR contiene file di librerie native. Se le funzioni della libreria sono state eseguite prima dell'eliminazione o della sostituzione (vengono chiamate anche durante la creazione del pacchetto), questi file di libreria verranno bloccati dal sistema e non potranno essere eliminati o sostituiti.

Importante

Prima di eliminare la vecchia versione, assicurarsi di non aver eseguito alcuna scena nell'editor o di aver creato il pacchetto dell'applicazione per alcuna piattaforma. In genere, si consiglia di chiudere Unity prima di eliminare o sostituire il pacchetto e di sostituirlo immediatamente dopo la riapertura.

Prima di creare nuovamente il pacchetto con la nuova versione del plugin, è necessario eliminare la directory di compilazione della piattaforma generata da Unity, inclusa la directory del progetto Gradle generata per Android e la directory Xcode generata per iOS.

Consiglio

Spesso queste directory possono trovarsi all'interno della cartella Library del progetto Unity (ad esempio Library/Bee/Android/Prj/IL2CPP/Gradle), ma potrebbero variare a seconda della versione di Unity.

Se hai creato il pacchetto ma non trovi la directory della piattaforma corrispondente, si consiglia di eliminare l'intera cartella Library.

Se dopo la migrazione si verifica l'eccezione SchemaHashNotMatched, di solito ci sono due possibilità

  1. Le operazioni sopra indicate non sono state eseguite correttamente, causando un aggiornamento non riuscito o incompleto, oppure la directory di compilazione generata da Unity non è stata aggiornata correttamente (Nota: se non viene eliminata manualmente, è molto probabile che si verifichino errori). Si consiglia di seguire i passaggi suggeriti o ricompilare utilizzando un progetto senza la cache Library.
  2. Il file tgz di EasyAR è stato modificato manualmente o l'intero plugin non è stato aggiornato completamente dopo l'estrazione. In questo caso, EasyAR non può garantire l'usabilità ed è necessario scaricare nuovamente il pacchetto corretto e importarlo.
Importante

Poiché i file di libreria di EasyAR Sense e la loro posizione dopo la creazione del pacchetto potrebbero cambiare, se hai conservato il progetto Gradle o Xcode generato da Unity, devi eliminare in anticipo tutti i file relativi a EasyAR, come EasyAR.aar, libEasyAR.so, easyar.framework, ecc.

Migrazione alla versione 4002

Quando si migra dalla versione 4001 alla 4002, oltre alla guida generale alla migrazione sopra indicata, è necessario prestare attenzione ai seguenti contenuti.

Modifiche all'interfaccia

Modulo funzionale API v4001 API v4002 Istruzioni per l'uso
Funzionalità ausiliaria Image.Image(Buffer, PixelFormat, int, int) Image.create

Migrazione alla versione 4001

Consiglio

Ci sono modifiche incompatibili solo quando si utilizza Mega; l'utilizzo di altre funzionalità non è interessato.

Quando si migra dalla versione 4000 alla 4001, oltre alla guida generale alla migrazione sopra indicata, è necessario prestare attenzione ai seguenti contenuti.

Modifiche all'interfaccia

Modulo funzionale API v4000 API v4001 Istruzioni per l'uso
Mega MegaTrackerFrameFilter.ResultPoseType.EnableLocalization MegaTrackerFrameFilter.EnableLocalization Controllare il processo di tracciamento Mega
Mega MegaTrackerFrameFilter.ResultPoseType.EnableStabilization - Funzione rimossa

Migrazione delle versioni precedenti

Quando si migra da versioni precedenti alla 4000, fare riferimento ai seguenti contenuti:

Argomenti correlati