Mantendo o Vuforia sempre atualizado no Unity

Veja como atualizar o Package Manager para ter sempre a versão mais recente do Vuforia

Erick Simões
NAVE Recife
3 min readMar 27, 2020

--

Atualmente o Vuforia, um dos kits de desenvolvimento de realidade aumentada mais populares para Unity, é distribuído junto via Package Manager. Desta forma é fácil adicionar o pacote do Vuforia, trabalhar com diferentes versões em projetos distintos e mantê-lo atualizado entre o time de desenvolvimento.

Janela do Package Manager

Porém, nem sempre temos a versão do Vuforia mais recente disponível pelo Package Manager. Isso acontece por causa da política de atualização do Unity, que distribui os pacotes junto com suas atualizações da plataforma. Hoje (março de 2020) a versão mais recente do Vuforia é a 9.0.12, porém no Unity 2019.3.7f1 conseguimos instalar apenas o Vuforia 8.5.9. Desta forma, acaba sendo demorado ter acesso a correções de bugs e a alguns recursos novos como a simulação de câmera e os aprimoramentos da detecção de targets escaneados.

É possível fazer a atualização manualmente, baixando um instalável, mas outras pessoas que também estiverem trabalhando nesse projeto podem ter dificuldade de usar os mesmos recursos, assim, a melhor forma ainda é usando o Package Manager. Para isso, precisamos fazer uma simples atualização no arquivo manifest.json de pacotes do Unity.

Passo 1: Acessando o arquivo manifest.json

Quando o Unity abre um projeto, o Unity Package Manager lê o project manifest com a lista de pacotes a serem carregados. Quando um usuário instala ou desinstala um pacote através da janela Package Manager, essas mudanças são registradas no arquivo manifest.json.

Crie um novo projeto usando o template 3D e abra o project manifest com um editor de texto. Esse arquivo pode ser encontrado em:
[Pasta do Projeto]/Packages/manifest.json

Arquivo manifest.json

Passo 2: Adicionando um registro personalizado

Com o arquivo manifest.json aberto, é possível adicionar um registro específico, que não existe por padrão. No caso, adicionaremos um registro referente ao Vuforia.

Antes da declaração das dependências, devemos adicionar o seguinte trecho de código:

Trecho de código que deve ser adicionado ao manifest.json

Esse código deve ser adicionado depois do { e antes do "dependencies":{.
O arquivo final deve ficar como esse: manifest.json.

Salve o arquivo e volte para o Unity. Pode demorar alguns segundos para atualizar.

Passo 3: Instalando o Vuforia Engine AR no Unity

Por fim, basta instalar o Vuforia Engine AR via Package Manager normalmente.

No Unity, abra o Package Manager:
Windows > Package Manager

Na lista de pacotes, procure por Vuforia Engine AR. Verifique se a versão mais recente está disponível (hoje, é a 9.0.12). Caso ainda não tenha atualizado, clique no ícone de reload 🔄 na parte inferior da tela, abaixo da lista.

Clique em Install, aguarde alguns segundos e pronto! Você tem a versão mais recente do Vuforia.

Assim que novas versões do Vuforia forem lançadas, você terá acesso a elas ainda pelo Package Manager.

Até a próxima e lembrem-se de lavar bem as mãos!

--

--

Erick Simões
NAVE Recife

Bacharel em Sistemas de Informação, professor de jogos digitais, palestrante, programador erudito, adestrador de robôs, defenestrador de bugs, maker diletante