Table of Contents

Guía de migración del EasyAR Sense Unity Plugin

Este documento describe cómo migrar desde una versión antigua del EasyAR Sense Unity Plugin a una nueva versión.

Notas de compatibilidad

A partir de la versión 4000, el EasyAR Sense Unity Plugin sigue el [control de versiones de paquetes (usando Semantic Versioning)] requerido por Unity, y la compatibilidad se puede determinar por el número de versión.

4.7 es una versión de actualización gradual; dos versiones 4.7 cualesquiera no son compatibles.

Para versiones anteriores a 4.7, solo el tercer número de versión indica compatibilidad hacia atrás; los cambios en los dos primeros números de versión indican incompatibilidad. Por ejemplo, 4.6.2 es compatible con 4.6.1, pero 4.6.0 no es compatible con 4.5.0.

Advertencia

Modificar el archivo tgz o no actualizar completamente todo el complemento después de descomprimirlo provocará incompatibilidad.

Guía general de migración

Para migrar a una nueva versión, primero debe eliminar el paquete del complemento de la versión anterior y agregar el nuevo paquete utilizando la ventana del Package Manager.

Se recomienda seguir los siguientes pasos:

  1. Cerrar Unity en uso.
  2. Eliminar el directorio de compilación de la plataforma generado cuando Unity empaqueta la aplicación.
  3. Volver a abrir el proyecto de Unity y eliminar la versión anterior del EasyAR Sense Unity Plugin del proyecto.
  4. Importar la nueva versión del EasyAR Sense Unity Plugin.

Nota

Los archivos de ejemplo proporcionados por el complemento no garantizan la compatibilidad entre versiones. Después de actualizar el complemento, es posible que los ejemplos importados al proyecto no funcionen correctamente; se recomienda eliminar los ejemplos de la versión anterior antes de operar.

EasyAR contiene archivos de biblioteca nativos. Si se han ejecutado funciones de biblioteca antes de eliminar o reemplazar (esto también se llama al empaquetar), estos archivos de biblioteca serán bloqueados por el sistema y no se podrán eliminar ni reemplazar.

Importante

Antes de eliminar la versión anterior, debe asegurarse de no haber ejecutado ninguna escena en el editor ni haber empaquetado ninguna aplicación para ninguna plataforma. Por lo general, se recomienda cerrar Unity antes de eliminar o reemplazar el paquete y reemplazarlo inmediatamente después de volver a abrirlo.

Antes de volver a empaquetar con la nueva versión del complemento, primero debe eliminar el directorio de compilación de la plataforma generado por Unity, incluido el directorio del proyecto Gradle generado al empaquetar para Android y el directorio Xcode generado al empaquetar para iOS.

Consejo

Por lo general, estos directorios pueden estar dentro de la carpeta Library del proyecto de Unity (por ejemplo, Library/Bee/Android/Prj/IL2CPP/Gradle), pero puede variar según la versión de Unity.

Si ha empaquetado pero no puede encontrar el directorio de la plataforma correspondiente, se recomienda eliminar toda la carpeta Library.

Si aparece la excepción SchemaHashNotMatched después de la migración, generalmente hay dos posibilidades

  1. Las operaciones anteriores no se realizaron correctamente, lo que provocó una falla o una actualización incompleta, o el directorio de compilación generado por Unity no se actualizó correctamente (Nota: si no se elimina manualmente, es muy probable que ocurra un error). Se recomienda seguir los pasos sugeridos o recompilar con un proyecto que no tenga caché de Library.
  2. Modificó manualmente el archivo tgz de EasyAR o no actualizó completamente todo el complemento después de descomprimirlo. En este caso, EasyAR no puede garantizar la disponibilidad, y es necesario volver a descargar el paquete correcto e importarlo.
Importante

Dado que las ubicaciones de los archivos de biblioteca de EasyAR Sense y después del empaquetado pueden cambiar, si ha conservado el proyecto Gradle o Xcode generado por Unity, debe eliminar todos los archivos relacionados con EasyAR de antemano, como EasyAR.aar, libEasyAR.so, easyar.framework, etc.

Migración a la versión 4002

Al migrar de la versión 4001 a la 4002, además de la guía de migración general anterior, debe prestar atención a lo siguiente.

Cambios en la interfaz

Módulo de función API v4001 API v4002 Instrucciones de uso
Funciones auxiliares Image.Image(Buffer, PixelFormat, int, int) Image.create

Migración a la versión 4001

Consejo

Solo hay cambios incompatibles cuando se usa Mega; el uso de otras funciones no se ve afectado.

Al migrar de la versión 4000 a la 4001, además de la guía de migración general anterior, debe prestar atención a lo siguiente.

Cambios en la interfaz

Módulo de función API v4000 API v4001 Instrucciones de uso
Mega MegaTrackerFrameFilter.ResultPoseType.EnableLocalization MegaTrackerFrameFilter.EnableLocalization Controlar el proceso de seguimiento de Mega
Mega MegaTrackerFrameFilter.ResultPoseType.EnableStabilization - Función eliminada

Migración de versiones históricas

Al migrar desde versiones anteriores a 4000, debe consultar el siguiente contenido:

Temas relacionados