Guia de migração do EasyAR Sense Unity Plugin
Este documento descreve como migrar de versões antigas do EasyAR Sense Unity Plugin para a nova versão.
Declaração de compatibilidade
A partir da versão 4000, o EasyAR Sense Unity Plugin segue o controle de versão de pacotes (usando Semantic Versioning) exigido pela Unity, e a compatibilidade pode ser determinada pelo número da versão.
4.7 é uma versão de atualização gradual. Quaisquer duas versões 4.7 são incompatíveis.
Para versões anteriores a 4.7, apenas o terceiro número de versão indica compatibilidade retroativa. Mudanças nos dois primeiros números de versão indicam incompatibilidade. Por exemplo, 4.6.2 é compatível com 4.6.1, mas 4.6.0 é incompatível com 4.5.0.
Aviso
Modificar arquivos tgz ou atualizar o plugin de forma incompleta após descompactar causará incompatibilidade.
Guia de migração geral
Migrar para uma nova versão requer primeiro remover o pacote do plugin antigo usando a janela Package Manager e adicionar o novo pacote.
Recomenda-se seguir estas etapas:
- Feche a Unity em uso.
- Exclua os diretórios de compilação de plataforma gerados ao criar builds da aplicação.
- Reabra o projeto Unity e remova a versão antiga do EasyAR Sense Unity Plugin.
- Importe a nova versão do EasyAR Sense Unity Plugin.
Nota
Os arquivos de exemplo fornecidos pelo plugin não garantem compatibilidade entre versões. Após atualizar o plugin, os exemplos importados podem não funcionar corretamente. Recomenda-se excluir os exemplos da versão antiga antes de prosseguir.
O EasyAR contém bibliotecas nativas. Se funções dessas bibliotecas foram executadas antes da exclusão ou substituição (como durante a criação de builds), esses arquivos serão bloqueados pelo sistema e não poderão ser excluídos ou substituídos.
Importante
Antes de remover a versão antiga, certifique-se de que nenhuma cena está sendo executada no editor e nenhum build de aplicativo está sendo criado para qualquer plataforma. Geralmente, recomenda-se fechar a Unity antes de excluir ou substituir o pacote e substituí-lo imediatamente após reabrir.
Antes de criar novos builds com a nova versão do plugin, é necessário excluir os diretórios de compilação de plataforma gerados pela Unity, incluindo o projeto Gradle gerado para Android e o diretório Xcode gerado para iOS.
Dica
Normalmente, esses diretórios podem estar dentro da pasta Library do projeto Unity (por exemplo, Library/Bee/Android/Prj/IL2CPP/Gradle), mas isso pode variar entre versões da Unity.
Se você criou builds mas não encontra o diretório da plataforma correspondente, recomenda-se excluir toda a pasta Library.
Se ocorrer uma exceção SchemaHashNotMatched após a migração, geralmente há duas possibilidades:
- As operações anteriores não foram realizadas corretamente, resultando em falha ou incompletude na atualização, ou os diretórios de compilação gerados pela Unity não foram atualizados corretamente (nota: se não excluídos manualmente, há grande chance de erro). Recomenda-se seguir as etapas sugeridas ou recompilar usando um projeto sem cache
Library. - O arquivo tgz do EasyAR foi modificado manualmente ou o plugin não foi atualizado completamente após descompactar. Nesse caso, o EasyAR não garante usabilidade. É necessário baixar novamente o pacote correto e importá-lo.
Importante
Como os arquivos de biblioteca do EasyAR Sense e sua localização após empacotamento podem mudar, se você mantiver os projetos Gradle ou Xcode gerados pela Unity, é essencial excluir previamente todos os arquivos relacionados ao EasyAR, como EasyAR.aar, libEasyAR.so, easyar.framework, etc.
Migração para a versão 4001
Dica
Apenas o uso do Mega tem alterações incompatíveis. O uso de outros recursos não é afetado.
Ao migrar da versão 4000 para a 4001, além do guia de migração geral acima, observe também o seguinte conteúdo.
Alterações na interface
| Módulo | API v4000 | API v4001 | Instruções de uso |
|---|---|---|---|
| Mega | MegaTrackerFrameFilter.ResultPoseType.EnableLocalization | MegaTrackerFrameFilter.EnableLocalization | Controle do processo de rastreamento Mega |
| Mega | MegaTrackerFrameFilter.ResultPoseType.EnableStabilization | - | Funcionalidade removida |
Migração de versões históricas
Ao migrar de versões anteriores à 4000, consulte os seguintes conteúdos: