Table of Contents

Guida alla migrazione di easyar sense unity plugin

Questo documento descrive come migrare dalla versione precedente di easyar sense unity plugin alla nuova versione.

Note sulla compatibilità

A partire dalla versione 4000, easyar sense unity plugin segue il controllo delle versioni 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 a 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 dei file tgz o l'aggiornamento incompleto dell'intero plugin dopo la decompressione causerà incompatibilità.

Guida generale alla migrazione

La migrazione a una nuova versione richiede prima la rimozione del pacchetto plugin della versione precedente utilizzando la package manager window e poi l'aggiunta del nuovo pacchetto.

Si consiglia di procedere come segue:

  1. Chiudere unity in uso.
  2. Eliminare le directory di compilazione della piattaforma generate durante la creazione dell'applicazione da unity.
  3. Riaprire il progetto unity e rimuovere la versione precedente 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 garantiscono la compatibilità tra le versioni. Dopo l'aggiornamento del plugin, gli esempi importati nel progetto potrebbero non funzionare correttamente. Si consiglia di eliminare gli esempi della versione precedente prima di procedere.

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

Importante

Prima di eliminare la versione precedente, è necessario assicurarsi che nessuna scena sia in esecuzione nell'editor e che nessuna applicazione sia stata creata per alcuna piattaforma. Generalmente si consiglia di chiudere unity prima di eliminare o sostituire il pacchetto e di sostituirlo immediatamente dopo la riapertura.

Prima di ricreare il pacchetto con la nuova versione del plugin, è necessario eliminare le directory di compilazione della piattaforma generate da unity, inclusa la directory del progetto gradle generata per android e la directory xcode generata per ios.

Consiglio

Generalmente queste directory potrebbero 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 riesci a trovare la directory della piattaforma corrispondente, si consiglia di eliminare l'intera cartella library.

Se dopo la migrazione si verifica un'eccezione schemahasnotmatched, ci sono generalmente due possibilità:

  1. Le operazioni precedenti non sono state eseguite correttamente, causando un aggiornamento fallito o incompleto, oppure le directory di compilazione generate da unity non sono state aggiornate correttamente (nota: se non sono state eliminate manualmente, è probabile che si verifichi un errore). Si consiglia di seguire i passaggi suggeriti o di utilizzare un progetto senza cache library per ricompilare.
  2. Hai modificato manualmente i file tgz di easyar o non hai aggiornato completamente l'intero plugin dopo la decompressione. 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 conservi i progetti gradle o xcode generati da unity, è necessario eliminare preventivamente tutti i file relativi a easyar, come easyar.aar, libeasyar.so, easyar.framework, ecc.

Migrazione alla versione 4001

Consiglio

Solo l'utilizzo di mega presenta modifiche incompatibili, l'utilizzo di altre funzionalità non è influenzato.

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

Modifiche alle interfacce

Modulo funzionale API v4000 API v4001 Istruzioni per l'uso
Mega megatrackerframefilter.resultposetype.enablelocalization <xref:u:easyar.megatrackerframefilter.enablelocalization?displayproperty=namewithtype> controllo del processo di tracciamento mega
Mega megatrackerframefilter.resultposetype.enablestabilization - Funzionalità rimossa

Migrazione delle versioni precedenti

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

Argomenti correlati