Руководство по миграции плагина EasyAR Sense для Unity
В этом документе объясняется, как перейти со старой версии плагина EasyAR Sense Unity на новую.
Совместимость
Начиная с версии 4000, плагин EasyAR Sense Unity Plugin следует системе управления версиями пакетов Unity (с использованием Semantic Versioning). Совместимость можно определить по номеру версии.
Версия 4.7 является постепенно обновляемой; любые две версии 4.7 несовместимы между собой.
Для версий до 4.7 только третья цифра в номере версии указывает на обратную совместимость. Изменение первых двух цифр означает несовместимость. Например, версия 4.6.2 совместима с 4.6.1, но версия 4.6.0 несовместима с 4.5.0.
Предупреждение
Изменение файлов tgz или неполное обновление всего плагина после распаковки приведет к несовместимости.
Универсальное руководство по миграции
Для перехода на новую версию необходимо сначала удалить старую версию плагина с помощью Package Manager window, а затем добавить новый пакет.
Рекомендуется выполнить следующие шаги:
- Закройте используемый Unity.
- Удалите каталоги сборки платформ, созданные Unity при сборке приложения.
- Снова откройте проект Unity и удалите старую версию плагина EasyAR Sense Unity Plugin из проекта.
- Импортируйте новую версию плагина EasyAR Sense Unity Plugin.
Примечание
Примеры файлов, предоставляемые плагином, не гарантируют совместимость между версиями. После обновления плагина импортированные в проект примеры могут работать некорректно. Рекомендуется удалить старые примеры перед операцией.
EasyAR содержит нативные библиотечные файлы. Если перед удалением или заменой были вызваны функции библиотек (это происходит и при сборке), эти файлы блокируются системой и не могут быть удалены или заменены.
Важно
Перед удалением старой версии убедитесь, что вы не запускаете никакие сцены в редакторе и не собираете приложения для каких-либо платформ. Обычно рекомендуется закрыть Unity перед удалением или заменой пакета, а после повторного открытия немедленно произвести замену.
Перед повторной сборкой с новой версией плагина необходимо удалить каталоги сборки платформ, созданные Unity, включая каталог проекта Gradle (для Android) и каталог Xcode (для iOS).
Совет
Обычно эти каталоги могут находиться в папке Library проекта Unity (например, Library/Bee/Android/Prj/IL2CPP/Gradle), но в разных версиях Unity это может отличаться.
Если вы собирали проект, но не можете найти каталог для соответствующей платформы, рекомендуется удалить всю папку Library.
Если после миграции возникает исключение SchemaHashNotMatched, обычно есть две возможные причины:
- Предыдущие операции были выполнены некорректно, что привело к неудачному или неполному обновлению, или сгенерированные Unity каталоги сборки не обновились должным образом (примечание: если вы не удалили их вручную, высока вероятность ошибки). Рекомендуется выполнить шаги в соответствии с инструкциями или пересобрать проект без кэша
Library. - Вручную изменены файлы tgz EasyAR или после распаковки плагин не был полностью обновлен. В этом случае EasyAR не может гарантировать работоспособность; необходимо заново скачать правильный пакет и импортировать его.
Важно
Поскольку библиотечные файлы EasyAR Sense и их расположение после сборки могут меняться, если вы сохранили сгенерированные Unity проекты Gradle или Xcode, необходимо заранее удалить все файлы, связанные с EasyAR, такие как EasyAR.aar, libEasyAR.so, easyar.framework и т.д.
Миграция на версию 4001
Совет
Несовместимые изменения затрагивают только использование Mega; использование других функций не затронуто.
При переходе с версии 4000 на 4001, помимо универсального руководства по миграции, обратите внимание на следующее.
Изменения в API
| Функциональный модуль | API v4000 | API v4001 | Примечания по использованию |
|---|---|---|---|
| Mega | MegaTrackerFrameFilter.ResultPoseType.EnableLocalization | MegaTrackerFrameFilter.EnableLocalization | Управление процессом отслеживания Mega |
| Mega | MegaTrackerFrameFilter.ResultPoseType.EnableStabilization | - | Функция удалена |
Миграция с исторических версий
При переходе с версий старше 4000 обратитесь к следующим материалам: