Table of Contents

Guide de migration du plugin Unity d'EasyAR Sense

Cet article explique comment migrer d'une ancienne version du plugin Unity d'EasyAR Sense vers une nouvelle version.

Compatibilité

À partir de la version 4000, le plugin Unity d'EasyAR Sense suit le contrôle de version des packages (utilisant Semantic Versioning) requis par Unity. La compatibilité peut être déterminée par le numéro de version.

4.7 était une version de mise à jour progressive. Aucune version 4.7 n'est compatible avec une autre.

Pour les versions antérieures à 4.7, seul le troisième numéro de version indique la compatibilité ascendante. Les modifications des deux premiers numéros de version indiquent une incompatibilité. Par exemple, 4.6.2 est compatible avec 4.6.1, mais 4.6.0 n'est pas compatible avec 4.5.0.

Avertissement

Modifier le fichier .tgz ou ne pas mettre à jour complètement l'ensemble du plugin après la décompression entraînera une incompatibilité.

Guide de migration général

Migrer vers une nouvelle version nécessite d'abord d'utiliser la fenêtre Package Manager pour supprimer l'ancienne version du package plugin et ajouter le nouveau package.

Il est recommandé de suivre les étapes suivantes :

  1. Fermez Unity s'il est ouvert.
  2. Supprimez les répertoires de compilation de plateforme générés par Unity lors de la création de builds d'applications.
  3. Rouvrez le projet Unity et supprimez l'ancienne version du plugin Unity d'EasyAR Sense du projet.
  4. Importez la nouvelle version du plugin Unity d'EasyAR Sense.

Note

Les fichiers d'exemple fournis par le plugin ne garantissent pas la compatibilité entre les versions. Après une mise à niveau du plugin, les exemples importés dans le projet peuvent ne plus fonctionner correctement. Il est recommandé de supprimer les anciens exemples avant de procéder.

EasyAR contient des fichiers de bibliothèques natives. Si les fonctions de bibliothèque ont été exécutées avant la suppression ou le remplacement (cela se produit également lors de la création de builds), ces fichiers peuvent être verrouillés par le système et impossibles à supprimer ou remplacer.

Important

Avant de supprimer l'ancienne version, assurez-vous qu'aucune scène n'est en cours d'exécution dans l'éditeur et qu'aucune application n'est en cours de création pour aucune plateforme. Il est généralement recommandé de fermer Unity avant de supprimer ou remplacer le package, et de le remplacer immédiatement après la réouverture.

Avant de créer de nouvelles builds avec la nouvelle version du plugin, vous devez supprimer les répertoires de compilation de plateforme générés par Unity, y compris le répertoire du projet Gradle généré pour Android et le répertoire Xcode généré pour iOS.

Astuce

Généralement, ces répertoires peuvent se trouver dans le dossier Library du projet Unity (par exemple Library/Bee/Android/Prj/IL2CPP/Gradle), mais cela peut varier selon les versions d'Unity.

Si vous avez créé des builds mais ne trouvez pas les répertoires correspondant à votre plateforme, il est recommandé de supprimer l'intégralité du dossier Library.

Si une exception SchemaHashNotMatched se produit après la migration, deux possibilités existent généralement :

  1. Les opérations précédentes n'ont pas été effectuées correctement, entraînant un échec ou une mise à niveau incomplète, ou les répertoires de compilation générés par Unity n'ont pas été correctement mis à jour (remarque : si vous ne les supprimez pas manuellement, il est probable qu'une erreur se produise). Il est recommandé de suivre les étapes suggérées ou d'utiliser un projet sans cache Library pour recompiler.
  2. Le fichier .tgz d'EasyAR a été modifié manuellement ou le plugin n'a pas été entièrement mis à jour après la décompression. Dans ce cas, EasyAR ne peut garantir la fonctionnalité. Vous devez télécharger à nouveau le package correct et l'importer.
Important

Étant donné que les fichiers de bibliothèque d'EasyAR Sense et leur emplacement après l'empaquetage peuvent changer, si vous conservez les projets Gradle ou Xcode générés par Unity, vous devez supprimer au préalable tous les fichiers liés à EasyAR, tels que EasyAR.aar, libEasyAR.so, easyar.framework, etc.

Migration vers la version 4001

Astuce

Seules des modifications incompatibles affectent l'utilisation de Mega. L'utilisation des autres fonctionnalités n'est pas affectée.

Lors de la migration de la version 4000 à la version 4001, en plus des directives générales de migration ci-dessus, notez également les éléments suivants.

Changements d'interface

Module fonctionnel API v4000 API v4001 Instructions d'utilisation
Mega MegaTrackerFrameFilter.ResultPoseType.EnableLocalization MegaTrackerFrameFilter.EnableLocalization Contrôler le processus de suivi Mega
Mega MegaTrackerFrameFilter.ResultPoseType.EnableStabilization - Fonctionnalité supprimée

Migration des versions historiques

Lors de la migration à partir de versions antérieures à 4000, consultez les contenus suivants :

Sujets connexes