EasyAR Sense Unity Plugin Guia de migração
Este artigo descreve como migrar da versão antiga do EasyAR Sense Unity Plugin para a nova versão.
Notas 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 pelo Unity, e a compatibilidade pode ser determinada pelo número da versão.
4.7 é uma versão de atualização incremental, quaisquer duas versões 4.7 não são compatíveis.
Para versões anteriores à 4.7, apenas o terceiro número da versão indica compatibilidade com versões anteriores; alterações nos dois primeiros números da versão indicam incompatibilidade. Por exemplo, 4.6.2 é compatível com 4.6.1, mas 4.6.0 não é compatível com 4.5.0.
Aviso
Modificar o arquivo tgz ou não atualizar completamente o plugin após a descompactação resultará em incompatibilidade.
Guia geral de migração
Para migrar para a nova versão, primeiro use a [janela do Package Manager] para remover o pacote do plugin antigo e adicionar o novo pacote.
Recomenda-se seguir as seguintes etapas:
- Feche o Unity em uso.
- Exclua o diretório de compilação da plataforma gerado quando o Unity empacota o aplicativo.
- Reabra o projeto Unity e remova a versão antiga do EasyAR Sense Unity Plugin do projeto.
- 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 a atualização do plugin, os exemplos importados para o projeto podem não funcionar corretamente; recomenda-se excluir os exemplos da versão antiga antes de prosseguir.
O EasyAR contém arquivos de biblioteca nativa; se as funções da biblioteca forem executadas antes da exclusão ou substituição (o que também acontece durante o empacotamento), esses arquivos de biblioteca serão bloqueados pelo sistema e não poderão ser excluídos ou substituídos.
Importante
Antes de excluir a versão antiga, certifique-se de que nenhuma cena esteja sendo executada no editor e que nenhum aplicativo de nenhuma plataforma tenha sido empacotado. Geralmente, recomenda-se fechar o Unity antes de excluir ou substituir o pacote e substituí-lo imediatamente após reabri-lo.
Antes de reempacotar com o novo plugin, você precisa excluir o diretório de compilação da plataforma gerado pelo Unity, incluindo o diretório do projeto Gradle gerado para Android e o diretório Xcode gerado para iOS.
Dica
Geralmente, esses diretórios podem estar dentro da pasta Library do projeto Unity (por exemplo, Library/Bee/Android/Prj/IL2CPP/Gradle), mas podem variar dependendo da versão do Unity.
Se você empacotou, mas não consegue encontrar 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 atualização incompleta, ou o diretório de compilação gerado pelo Unity não foi atualizado corretamente (Nota: se não for excluído manualmente, é provável que ocorra um erro). Recomenda-se seguir as etapas sugeridas ou recompilar usando um projeto sem o cache Library.
- O arquivo tgz do EasyAR foi modificado manualmente ou o plugin não foi atualizado completamente após a descompactação. Neste caso, o EasyAR não pode garantir a disponibilidade; é necessário baixar o pacote correto novamente e importá-lo.
Importante
Como os arquivos de biblioteca do EasyAR Sense e sua localização após o empacotamento podem mudar, se você reteve o projeto Gradle ou Xcode gerado pelo Unity, deve excluir antecipadamente todos os arquivos relacionados ao EasyAR, como EasyAR.aar, libEasyAR.so, easyar.framework, etc.
Migrar para a versão 4002
Ao migrar da versão 4001 para a 4002, além do guia geral de migração mencionado acima, você também precisa prestar atenção ao seguinte.
Alterações de interface
| Módulo de funcionalidade | v4001 API | v4002 API | Instruções de uso |
|---|---|---|---|
| Funções auxiliares | Image.Image(Buffer, PixelFormat, int, int) | Image.create |
Migrar para a versão 4001
Dica
Há alterações incompatíveis apenas ao usar o Mega; o uso de outras funcionalidades não é afetado.
Ao migrar da versão 4000 para a 4001, além do guia geral de migração mencionado acima, você também precisa prestar atenção ao seguinte.
Alterações de interface
| Módulo de funcionalidade | v4000 API | v4001 API | Instruções de uso |
|---|---|---|---|
| Mega | MegaTrackerFrameFilter.ResultPoseType.EnableLocalization | MegaTrackerFrameFilter.EnableLocalization | Controlar o processo de rastreamento do Mega |
| Mega | MegaTrackerFrameFilter.ResultPoseType.EnableStabilization | - | Funcionalidade removida |
Migração de versões históricas
Ao migrar de versões anteriores a 4000, consulte o seguinte: