EasyAR Sense Unity Plugin Guide de migration
Cet article explique comment migrer de l'ancienne version du plugin EasyAR Sense Unity Plugin vers la nouvelle version.
Notes de compatibilité
Depuis la version 4000, le plugin EasyAR Sense Unity Plugin suit le [contrôle de version des packages (utilisant Semantic Versioning)] requis par Unity, et la compatibilité peut être déterminée par le numéro de version.
4.7 est une version de mise à jour progressive, deux versions 4.7 quelconques ne sont pas compatibles.
Pour les versions antérieures à 4.7, seul le troisième numéro de version indique la compatibilité ascendante ; tout changement dans les deux premiers numéros de version indique 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 le plugin après décompression entraînera une incompatibilité.
Guide de migration général
La migration vers une nouvelle version nécessite d'abord d'utiliser la [fenêtre du Gestionnaire de packages] pour supprimer l'ancien package du plugin et d'ajouter le nouveau package.
Il est recommandé de suivre les étapes suivantes :
- Fermez Unity en cours d'utilisation.
- Supprimez le répertoire de compilation de la plateforme généré lors du packaging de l'application par Unity.
- Rouvrez le projet Unity et supprimez l'ancienne version du plugin EasyAR Sense Unity Plugin du projet.
- Importez la nouvelle version du plugin EasyAR Sense Unity Plugin.
Note
La compatibilité entre les versions n'est pas garantie pour les fichiers d'exemple fournis par le plugin. Après la mise à niveau du plugin, les exemples importés dans le projet risquent de ne pas fonctionner correctement ; il est recommandé de supprimer les anciens exemples avant de procéder.
EasyAR contient des fichiers de bibliothèque natifs. Si des fonctions de bibliothèque ont été exécutées avant la suppression ou le remplacement (elles sont également appelées lors du packaging), ces fichiers de bibliothèque seront verrouillés par le système et ne pourront pas être supprimés ou remplacés.
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 empaquetée pour une plateforme. En général, il est recommandé de fermer Unity avant de supprimer ou de remplacer le package, et de le remplacer immédiatement après l'avoir rouvert.
Avant de reconditionner avec la nouvelle version du plugin, vous devez d'abord supprimer le répertoire de compilation de la plateforme généré 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
Habituellement, 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 différentes versions d'Unity.
Si vous avez effectué un packaging mais que vous ne trouvez pas le répertoire de la plateforme correspondante, il est recommandé de supprimer le dossier Library entier.
Si l'exception SchemaHashNotMatchMatched apparaît après la migration, il y a généralement deux possibilités
- Les opérations précédentes n'ont pas été effectuées correctement, entraînant l'échec ou l'incomplétude de la mise à niveau, ou le répertoire de compilation généré par Unity n'a pas été mis à jour correctement (note : si vous ne le supprimez pas manuellement, il y a de fortes chances d'erreur). Il est recommandé de suivre les étapes suggérées ou de recompiler avec un projet sans cache
Library. - Le fichier tgz d'EasyAR a été modifié manuellement ou le plugin n'a pas été entièrement mis à jour après décompression. Dans ce cas, EasyAR ne peut pas garantir la disponibilité ; vous devez télécharger à nouveau le package correct et l'importer.
Important
Comme les fichiers de bibliothèque d'EasyAR Sense et leur emplacement après packaging peuvent changer, si vous avez conservé le projet Gradle ou Xcode généré par Unity, you devez supprimer à l'avance tous les fichiers liés à EasyAR, tels que EasyAR.aar , libEasyAR.so , easyar.framework , etc.
Migration vers la version 4002
Lors de la migration de la version 4001 vers la 4002, en plus du guide de migration général ci-dessus, vous devez également prêter attention au contenu suivant.
Changements d'interface
| Module de fonction | v4001 API | v4002 API | Instructions d'utilisation |
|---|---|---|---|
| Fonctionnalité d'aide | Image.Image(Buffer, PixelFormat, int, int) | Image.create |
Migration vers la version 4001
Astuce
Seules des modifications incompatibles sont présentes lors de l'utilisation de Mega, l'utilisation d'autres fonctionnalités n'est pas affectée.
Lors de la migration de la version 4000 vers la 4001, en plus du guide de migration général ci-dessus, vous devez également prêter attention au contenu suivant.
Changements d'interface
| Module de fonction | v4000 API | v4001 API | Instructions d'utilisation |
|---|---|---|---|
| Mega | MegaTrackerFrameFilter.ResultPoseType.EnableLocalization | MegaTrackerFrameFilter.EnableLocalization | Contrôler le processus de suivi Mega |
| Mega | MegaTrackerFrameFilter.ResultPoseType.EnableStabilization | - | Fonction supprimée |
Migration des versions historiques
Lors de la migration à partir de versions antérieures à 4000, reportez-vous au contenu suivant :