Table of Contents

EasyAR Sense Unity Plugin guía de migración

Este documento explica cómo migrar desde versiones anteriores del EasyAR Sense Unity Plugin a la nueva versión.

Compatibilidad

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

4.7 es una versión de actualización gradual. Cualesquiera dos versiones 4.7 son incompatibles.

En 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 significan 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 archivos tgz o actualizar el plugin de forma incompleta después de descomprimir causará incompatibilidad.

Guía de migración general

Migrar a una nueva versión requiere eliminar el paquete de la versión anterior y agregar el nuevo usando la ventana Package Manager.

Se recomienda seguir estos pasos:

  1. Cerrar Unity si está en uso.
  2. Eliminar los directorios de compilación de plataforma generados al crear builds de Unity.
  3. Reabrir el proyecto de Unity y eliminar la versión anterior de EasyAR Sense Unity Plugin.
  4. Importar la nueva versión de EasyAR Sense Unity Plugin.

Nota

Los archivos de ejemplo proporcionados por el plugin no garantizan compatibilidad entre versiones. Después de actualizar el plugin, los ejemplos importados al proyecto pueden no funcionar. Se recomienda eliminar los ejemplos antiguos antes de operar.

EasyAR incluye archivos de biblioteca nativa. Si se ejecutan funciones de biblioteca antes de eliminarlas o reemplazarlas (también se llama durante la compilación), estos archivos se bloquean y no se pueden eliminar ni reemplazar.

Importante

Antes de eliminar la versión anterior, asegúrese de no estar ejecutando ninguna escena en el editor ni compilando aplicaciones para ninguna plataforma. Generalmente se recomienda cerrar Unity antes de eliminar o reemplazar el paquete, y reemplazarlo inmediatamente después de volver a abrir.

Antes de volver a compilar con la nueva versión del plugin, elimine los directorios de compilación de plataforma generados por Unity, incluido el proyecto Gradle generado para Android y el directorio Xcode generado para iOS.

Consejo

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

Si ha compilado pero no encuentra el directorio de la plataforma correspondiente, se recomienda eliminar toda la carpeta Library.

Si aparece una 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 actualización fallida o incompleta, o los directorios de compilación generados por Unity no se actualizaron correctamente (nota: si no se eliminaron manualmente, es probable que falle). Se recomienda seguir los pasos sugeridos o usar un proyecto sin caché Library para recompilar.
  2. Modificó manualmente los archivos tgz de EasyAR o actualizó el plugin de forma incompleta después de descomprimirlo. En este caso, EasyAR no puede garantizar la usabilidad. Es necesario volver a descargar el paquete correcto e importarlo.
Importante

Dado que los archivos de biblioteca de EasyAR Sense y su ubicación después del empaquetado pueden cambiar, si conserva los proyectos Gradle o Xcode generados por Unity, debe eliminar previamente todos los archivos relacionados con EasyAR, como EasyAR.aar, libEasyAR.so, easyar.framework, etc.

Migración a la versión 4001

Consejo

Solo hay cambios incompatibles al usar Mega. El uso de otras funciones no se ve afectado.

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

Cambios en la API

Módulo API v4000 API v4001 Notas de uso
Mega MegaTrackerFrameFilter.ResultPoseType.EnableLocalization MegaTrackerFrameFilter.EnableLocalization Control del proceso de seguimiento de Mega
Mega MegaTrackerFrameFilter.ResultPoseType.EnableStabilization - Función eliminada

Migración de versiones anteriores

Al migrar desde versiones anteriores a 4000, consulte:

Temas relacionados