Resumo executivo
Utilize o Unity quando a sua aplicação empresarial precisar de conteúdo 3D interativo, ou o Android Studio quando precisar de uma interface Android nativa. A configuração está concluída quando as ferramentas necessárias estiverem instaladas, o projeto passar nas verificações de configuração e o seu dispositivo de teste ou emulador estiver disponível.
As instruções seguem a documentação oficial do Android XR. As portas de desenvolvimento, os menus de firmware e as permissões específicos do Aura devem ser confirmados com base nas instruções de integração fornecidas com a sua unidade. Este guia não afirma ter sido testado fisicamente no Aura.
Escolha o seu percurso de desenvolvimento
Escolha o Unity se o seu projeto for utilizar modelos 3D, formação interativa ou simulação, ou se os seus programadores já trabalham com Unity e C#. O Unity oferece um espaço de trabalho visual para organizar conteúdos e configurar funcionalidades de XR. Pode configurar o ambiente sem escrever código nem criar um protótipo.
Escolha o Android Studio se estiver a expandir uma aplicação empresarial Android ou a criar interfaces nativas, como instruções de trabalho, formulários ou painéis de tarefas. Este utiliza Kotlin e as bibliotecas Jetpack XR da Google. Qualquer um dos percursos pode, mais tarde, ligar-se a sistemas empresariais através de uma API, uma forma definida de o software trocar informações; escolha o percurso com base na interface da aplicação e nas competências da sua equipa.
Editor de desenvolvimento principal:
- Percurso Unity: Unity Editor, instalado através do Unity Hub
- Percurso Android Studio: Android Studio
Linguagem para o desenvolvimento posterior:
- Percurso Unity: C#
- Percurso Android Studio: Kotlin
Ferramentas de compilação Android:
- Percurso Unity: Android Build Support, incluindo SDK, NDK e OpenJDK
- Percurso Android Studio: Ferramentas do Android SDK, instaladas através do SDK Manager
Suporte de XR principal:
- Percurso Unity: OpenXR Plugin, instalado através do Unity Package Manager
- Percurso Android Studio: Bibliotecas do Jetpack XR SDK, transferidas através do Gradle
Suporte de XR específico da plataforma:
- Percurso Unity: Pacote Unity OpenXR: Android XR
- Percurso Android Studio: Modelo de projeto XR e bibliotecas Jetpack XR necessárias
O que significam as ferramentas de XR:
- Percurso Unity: O OpenXR é uma interface comum entre uma aplicação de XR e o runtime do dispositivo, o software de sistema que executa as funcionalidades de XR
- Percurso Android Studio: O Jetpack XR SDK é a coleção de bibliotecas da Google para interfaces espaciais nativas e funcionalidades de XR
Ligação e diagnóstico:
- Percurso Unity: ADB, a ferramenta Android Debug Bridge
- Percurso Android Studio: ADB e Logcat do Android Studio, que apresenta mensagens de diagnóstico
Prepare a sua estação de trabalho e o acesso de desenvolvimento
Prepare um computador de desenvolvimento suportado, um acesso fiável à internet para as dependências, uma pasta de projeto aprovada pela empresa e um cabo USB de dados. Os requisitos do emulador diferem dos requisitos do editor; consulte a página de hardware do emulador de XR da Google antes de depender de um dispositivo virtual. Um dispositivo virtual é uma simulação em software de um dispositivo Android. [4]
Utilize uma unidade Aura com acesso de programador autorizado, a ligação aos óculos fornecida e a ligação de desenvolvimento documentada pela XREAL. Confirme o fornecimento na sua região e a integração do kit antes de se comprometer com uma data de workshop. As páginas atuais da XREAL e as páginas regionais podem divergir quanto à disponibilidade; uma listagem de produto, por si só, não determina o prazo de entrega. [1]
Para uso empresarial, confirme a elegibilidade da sua organização para a licença Unity e quaisquer termos do Unity Industry aplicáveis antes de utilizar o Unity comercialmente. Utilize um controlo de versões gerido pela empresa, fontes de pacotes aprovadas e dados de teste. O Android Studio e o Unity são ferramentas de desenvolvimento para aplicações profissionais; instalá-los não garante suporte de gestão empresarial no Aura.
Percurso A: configurar o ambiente de desenvolvimento Unity
Este percurso instala o Unity e as respetivas ferramentas Android, cria um projeto vazio e ativa o suporte para Android XR. Prepara o espaço de trabalho para o desenvolvimento posterior.
Passo 1 | Instalar o editor Unity
O Unity Hub gere as instalações do editor; o Unity Editor é o espaço de trabalho onde configura projetos e, mais tarde, desenvolve a sua aplicação.
Instale o Unity Hub a partir do site oficial do Unity e abra-o. Aceda a Installs e depois a Install Editor. Escolha uma versão suportada do Unity 6.5 (ou mais recente) compatível com o pacote Android XR que vai utilizar, para obter suporte total para a entrada através do trackpad do puck, entre outras funcionalidades. A página de configuração da Google indica atualmente a versão 6000.0.58f2 ou superior; aplicam-se também os requisitos de pacotes mais recentes. [5]
Passo 2 | Adicionar as ferramentas de compilação Android
Estes módulos permitem ao Unity transformar o seu projeto numa aplicação Android.
O XREAL Aura funciona com Android XR, pelo que precisa de uma aplicação Android que o seu sistema operativo consiga instalar e executar. O seu projeto Unity contém ficheiros editáveis para desenvolvimento; as ferramentas de compilação Android empacotam e compilam esses ficheiros numa aplicação instalável, normalmente um APK para testes no dispositivo.
Nos módulos de instalação, selecione Android Build Support e os respetivos subitens, depois clique em Continue e conclua as instruções de instalação. As ferramentas necessárias são:
· Android SDK (Software Development Kit)
· Android NDK (Native Development Kit): converte código de nível mais baixo num formato que o processador do dispositivo consegue executar.
· JDK (Java Development Kit)
Para um editor já existente, volte a Unity Hub > Installs, abra o menu do editor, escolha Add modules, selecione os mesmos itens e clique em Installs.
Passo 3 | Criar um projeto
Um projeto vazio dá-lhe um espaço para configurar o ambiente de desenvolvimento Android XR.
No Unity Hub, abra Projects > New project. Selecione o editor instalado e escolha Universal 3D. Dê ao projeto o nome AuraDevelopmentSetup, escolha uma pasta e selecione Create project. Universal 3D utiliza o URP, o Universal Render Pipeline que desenha os gráficos da sua aplicação.
Passo 4 | Verificar os caminhos das ferramentas
O Unity precisa de saber onde estão instaladas as ferramentas de compilação Android compatíveis.
No Unity Editor, abra Edit > Preferences > External Tools (Unity > Settings ou Preferences no macOS). Mantenha selecionados o SDK (ferramentas da plataforma Android), o NDK (ferramentas de compilação de código nativo) e o JDK (ferramentas de compilação Java) fornecidos pelo Unity. Estas versões correspondem ao seu editor Unity, o que ajuda a evitar erros de compilação. Não as substitua por versões não relacionadas das ferramentas do Android Studio só porque ambas estão instaladas.
Configurar o seu ambiente de desenvolvimento para XREAL Aura no Unity
O OpenXR é uma norma aberta que ajuda as aplicações de XR a comunicar com runtimes de dispositivos compatíveis. No Unity, instale o OpenXR Plugin para a ligação principal e o Unity OpenXR: Android XR para o suporte de Android XR através do Package Manager. O AR Foundation é a interface comum do Unity para funcionalidades de AR suportadas, como a compreensão do ambiente.
Passo 1 | Selecionar o destino de compilação Android XR
O destino de compilação indica ao Unity em que plataforma a aplicação tem de ser executada.
Abra File > Build Profiles. No Unity 6.1 ou mais recente, adicione ou selecione o perfil da plataforma Android XR e mude para ele. A documentação do Unity indica que isto pode instalar automaticamente o pacote Android XR compatível. Se o seu editor suportado utilizar antes a plataforma Android, selecione Android e configure o OpenXR manualmente. [7]
Passo 2 | Instalar os pacotes OpenXR
Os pacotes acrescentam os componentes de software que ligam a sua cena Unity ao Android XR.
Abra Window > Package Management > Package Manager, ou Window > Package Manager nos editores com a disposição de menus mais antiga. Verifique se o OpenXR Plugin e o Unity OpenXR: Android XR estão instalados. Se faltar o pacote Android XR, utilize o menu de adição (+) > Add package by name e introduza com.unity.xr.androidxr-openxr. O identificador do pacote OpenXR principal é com.unity.xr.openxr. Deixe o Package Manager resolver as dependências compatíveis. [6]
Passo 3 | Ativar o fornecedor de XR
Instalar um pacote torna-o disponível; ativar o fornecedor permite que a aplicação o utilize.
Abra Edit > Project Settings > XR Plug-in Management. No separador Android, ative o OpenXR. Abra a secção OpenXR abaixo e ative o grupo de funcionalidades Android XR. Ative Android XR: Session quando utilizar funcionalidades do AR Foundation. Ative Android XR: AR Session para a versão 1.0. Evite ativar fornecedores não relacionados nesta compilação. [8]
Passo 4 | Validar o projeto
A validação identifica definições que impediriam uma compilação de XR suportada.
Abra XR Plug-in Management > Project Validation e selecione Android. Analise e resolva os problemas obrigatórios e volte a verificar. Os requisitos de validação específicos do pacote têm prioridade sobre definições copiadas de um tutorial mais antigo.
Passo 5 | Manter simples os requisitos de entrada
Ative apenas as funcionalidades exigidas pela aplicação planeada e suportadas pelo dispositivo de destino.
Deixe as funcionalidades de entrada opcionais para a fase de desenvolvimento da aplicação, a menos que o seu projeto ou modelo as exija. Ativar um perfil de seguimento ocular ou de comando não acrescenta esse hardware ao Aura. Analise quaisquer definições de interação necessárias em Project Validation antes de continuar.
O Android XR Extensions for Unity da Google é um pacote adicional com funcionalidades extra. É distinto do Unity OpenXR: Android XR. Não precisa de o adicionar só porque os nomes parecem semelhantes; adicione-o quando a sua aplicação precisar de uma funcionalidade que ele fornece. [9]
Verificar as definições de renderização e de compilação Android
O Vulkan é a interface gráfica utilizada para enviar trabalho de renderização para a GPU. Em Edit > Project Settings > Player, selecione Android > Other Settings. Se Auto Graphics API estiver ativado, desative-o e coloque o Vulkan em primeiro lugar. Para uma base URP simples, desative o HDR no asset URP e o pós-processamento no respetivo asset de renderizador. A Google recomenda estas definições para o Android XR. [5]
Nas mesmas definições do Player, defina um identificador de pacote único, como com.yourcompany.aurapilot. Em Configuration, selecione IL2CPP e ARM64 para a compilação destinada ao dispositivo físico. O IL2CPP converte código C# em código nativo; ARM64 é a arquitetura de processador visada pela compilação. Verifique a validação dos pacotes instalados e os requisitos do dispositivo para eventuais restrições adicionais.
A Google indica a API 24 como o mínimo do carregador OpenXR, não como a versão do sistema operativo do Aura. Utilize um nível mínimo de API que satisfaça também todos os pacotes instalados e um SDK de destino instalado que seja suportado pelo seu editor e pelos requisitos de distribuição. Configure GameActivity como ponto de entrada da aplicação, desmarque Activity e ative Resizable Activity em Resolution and Presentation, conforme indicado pela Google. [5]
Percurso B: configurar o ambiente de desenvolvimento Android Studio
Este percurso instala o Android Studio, transfere as ferramentas de desenvolvimento Android e cria um projeto de XR a partir do modelo da Google. Prepara o espaço de trabalho Android nativo para o desenvolvimento posterior da aplicação. Também pode criar um emulador para verificar se o projeto é compilado e iniciado.
Visão geral da configuração: instalar o Android Studio → transferir as ferramentas Android → criar um projeto de XR → verificar as dependências → preparar um destino de teste.O Android Studio é o ambiente de desenvolvimento da Google para aplicações Android. O Kotlin é a linguagem de programação aqui utilizada. O Jetpack XR SDK fornece bibliotecas nativas de IU espacial e de XR, enquanto o Jetpack Compose descreve interfaces em código Kotlin.
Passo 1 | Instalar o editor compatível com XR
A versão recomendada do Android Studio inclui as ferramentas e os modelos de XR utilizados neste percurso.
Transfira a versão do Android Studio recomendada pela página de configuração de XR da Google. As orientações atuais recomendam a versão Canary mais recente; se necessário, instale-a juntamente com a sua versão estável habitual. Canary designa uma versão de desenvolvimento inicial, por isso registe a versão exata utilizada pela sua equipa. [10]
Passo 2 | Transferir as ferramentas de desenvolvimento Android
SDK Manager instala os componentes necessários para compilar, executar e inspecionar a sua aplicação.
No ecrã de boas-vindas, abra More Actions > SDK Manager. Em SDK Tools, instale ou atualize o Android SDK Build-Tools, o Android Emulator e o Android SDK Platform-Tools, bem como a versão do Layout Inspector indicada nas instruções atuais da Google. Clique em Apply e aceite as licenças. [10]
Passo 3 | Criar o projeto de XR
Um modelo de XR fornece uma aplicação inicial com a estrutura espacial já implementada.
Abra New Project. Selecione XR na lista de modelos e depois o modelo imersivo para headsets de XR ou óculos de XR com fios. Não selecione um modelo para óculos de áudio ou óculos de visualização. Clique em Next, dê ao projeto o nome AuraBusinessPanel, defina um nome de pacote da empresa se essa opção for apresentada, escolha uma pasta para guardar e clique em Finish. [11]
Passo 4 | Deixar o projeto transferir as dependências
Gradle sync prepara as bibliotecas e a configuração de compilação antes de editar a aplicação.
Aguarde que a Gradle sync termine. O Gradle é o sistema de compilação que transfere as dependências e compila a aplicação. Abra o painel Project e localize app/build.gradle.kts, ou o ficheiro Gradle do módulo da aplicação. Mantenha as versões mutuamente compatíveis do modelo; não atualize uma biblioteca de XR ao acaso.
Passo 5 | Verificar os requisitos de API do Android
As definições de API têm de cumprir os requisitos do modelo e de todas as bibliotecas que utilizar.
Compare a página de configuração do Jetpack XR SDK com o seu modelo. A base publicada é minSdk 24 e compileSdk 34 ou superior; utilize valores mais altos quando as bibliotecas escolhidas ou o modelo o exigirem. compileSdk é a API do Android utilizada na compilação, enquanto minSdk define a API do Android mais antiga suportada. [12]
A página de configuração do SDK lista as dependências Runtime, SceneCore, Compose for XR, Material Design for XR e ARCore for Jetpack XR. Adicione apenas o que a aplicação utiliza. O SceneCore gere o conteúdo espacial; o ARCore for Jetpack XR fornece capacidades de perceção suportadas. As versões de pré-visualização podem mudar, por isso utilize o modelo e as notas de versão em conjunto, em vez de colar um bloco de dependências antigo.
Se o seu modelo não incluir automaticamente as bibliotecas de XR base, certifique-se de que o seu app/build.gradle.kts reflete as seguintes dependências de base:
android {
compileSdk = 34 // ou o valor superior definido pelo seu modelo
defaultConfig {
minSdk = 24
}
}
dependencies {
// Dependências principais do Jetpack XR SDK
implementation("androidx.xr.runtime:runtime:1.1.0-alpha02")
implementation("androidx.xr.scenecore:scenecore:1.1.0-alpha01")
implementation("androidx.xr.compose:compose:1.0.0-beta02")
implementation("androidx.xr.compose.material3:material3:1.0.0-alpha17")
}
À data da pesquisa, o Compose for XR 1.0.0-beta02 (21-10-2026) requer Kotlin 2.2, e as respetivas notas de versão indicam que depende do SceneCore 1.0.0-rc01, que tem uma fuga de memória conhecida; a solução alternativa é declarar o SceneCore 1.0.0 ou mais recente manualmente, o que o bloco de dependências acima já faz. Esta é uma das razões para registar o conjunto completo de dependências, em vez de descrever qualquer instalação mais recente como pronta para produção. [13]
Executar num emulador de XR antes de o hardware estar disponível
Passo 1 | Criar um dispositivo virtual de XR
O emulador permite-lhe verificar o software antes de ter disponível uma unidade Aura física.
Abra Tools > Device Manager e depois Add a new device > Create Virtual Device. Selecione XR como fator de forma e escolha XR Glasses para o fluxo de trabalho com óculos com fios. [4]
Passo 2 | Instalar a imagem de sistema necessária
A imagem de sistema fornece o ambiente operativo Android XR para o dispositivo virtual.
Escolha a imagem de sistema de pré-visualização que o guia da Google exige para XR Glasses, transfira-a se lhe for pedido e conclua a criação do dispositivo virtual. Inicie-o a partir do Device Manager.
Passo 3 | Executar a aplicação
O Android Studio compila o projeto e instala-o no dispositivo virtual selecionado.
Na barra de ferramentas superior do Android Studio, escolha a configuração de execução da aplicação e o dispositivo virtual de XR em execução. Clique em Run. Deixe o Android Studio compilar e instalar o modelo sem alterações. Não precisa de personalizar a interface para esta verificação do ambiente.
Passo 4 | Verificar o resultado
Uma compilação e um arranque bem-sucedidos confirmam que as ferramentas instaladas conseguem processar o modelo.
Verifique se o modelo abre sem erros de compilação ou de arranque. Isto valida a configuração básica do software, não a ótica do Aura, o seguimento físico, o desempenho nem a prontidão para produção.
Ligar o XREAL Aura ao computador de desenvolvimento
O ADB, abreviatura de Android Debug Bridge, permite que um computador de desenvolvimento instale aplicações e leia registos de diagnóstico de um dispositivo Android. Tanto o Unity como o Android Studio o podem utilizar.
Segundo as FAQ do Aura da XREAL, ambas as portas USB-C do compute puck suportam depuração ADB padrão com o Android Studio, mas a respetiva tabela de especificações indica suporte ADB completo apenas na Glasses Port, por isso, se possível, dê prioridade a essa porta. Mantenha os óculos ligados conforme indicado. O espelhamento por DisplayPort e uma ligação ADB autorizada são funções diferentes, pelo que ver o ecrã de um portátil nos óculos não prova que a ligação de desenvolvimento funciona.
Passo 1 | Ativar a depuração autorizada
A depuração permite que o seu computador de desenvolvimento instale e inspecione aplicações de teste.
No sistema Android XR, abra Settings e ative Developer options e USB debugging seguindo as instruções para o seu firmware. No Android padrão, as Developer options ficam normalmente disponíveis ao selecionar repetidamente Build number, mas o caminho exato do menu no Aura não foi confirmado nas fontes públicas consultadas. Se for diferente, utilize o caminho indicado nas instruções de integração fornecidas. [14]
Passo 2 | Ligar e autorizar o computador
Este fluxo de trabalho de depuração com fios requer uma ligação USB de dados e a aprovação no dispositivo.
Ligue o anfitrião com um cabo USB de dados através da porta de desenvolvimento documentada. Aprove no dispositivo o pedido de autorização de depuração do computador. No Windows, instale o controlador ADB do fabricante se o sistema o exigir. [14]
Passo 3 | Verificar se o ADB deteta o dispositivo
A lista de dispositivos confirma que a ligação está pronta antes de tentar compilar e executar.
No Android Studio, abra o SDK Manager e anote a Android SDK Location. No terminal, abra a pasta platform-tools desse SDK e execute o comando adequado abaixo.
# Windows PowerShell, dentro de platform-tools
.\adb.exe devices -l
# macOS ou Linux, dentro de platform-tools
./adb devices -l
Resultado esperado: o número de série do dispositivo é seguido de device. Se aparecer unauthorized, aprove o pedido. Se a lista estiver vazia, verifique o cabo, a porta do anfitrião, a definição de depuração e o controlador. Se estiver ligado mais do que um dispositivo ou emulador, selecione explicitamente o destino pretendido.
Confirmar que o seu ambiente de desenvolvimento está pronto
Verificações de prontidão no Unity
Passo 1 | Verificar o perfil de compilação
Verifique a configuração antes de iniciar o desenvolvimento da aplicação.
Abra File > Build Profiles e confirme que o Android XR, ou o perfil Android configurado para XR, está ativo. Confirme que os módulos de compilação Android necessários estão disponíveis para este editor.
Passo 2 | Verificar os pacotes e a validação
O projeto tem de ter os pacotes de XR necessários instalados e ativados.
No Package Manager, verifique o OpenXR Plugin e o Unity OpenXR: Android XR. Em Project Settings > XR Plug-in Management, confirme o fornecedor Android OpenXR e o grupo de funcionalidades Android XR. Resolva os problemas obrigatórios em Project Validation.
Passo 3 | Verificar o dispositivo de destino
Um dispositivo reconhecido conclui a parte da configuração relativa à ligação.
Em Build Profiles, atualize Run Device e verifique se a sua unidade Aura autorizada aparece. Se não aparecer, verifique a ligação ADB e os caminhos em External Tools do Unity. Pode configurar o projeto antes de o hardware estar disponível, mas a validação da implementação física tem de esperar por um dispositivo.
Verificações de prontidão no Android Studio
Confirme que a Gradle sync termina sem erros, que o SDK Manager tem as ferramentas necessárias instaladas e que o emulador de XR ou o dispositivo Aura autorizado aparece no seletor de destino. Execute o modelo de XR sem alterações se tiver um destino de teste disponível. Abra View > Tool Windows > Logcat para inspecionar erros de arranque. O Logcat apresenta mensagens de diagnóstico do Android.
Como o Unity e o Android Studio funcionam em conjunto
O Unity consegue compilar aplicações Android com as suas próprias ferramentas suportadas, pelo que o Android Studio não é necessário para configurar um projeto Unity. Ainda assim, o Android Studio pode ajudar na gestão de emuladores e em diagnósticos Android como o Logcat. Importa salientar que o emulador Android XR não suporta a simulação de aplicações criadas com Unity, Godot, Unreal Engine ou OpenXR, pelo que as compilações Unity precisam de um Aura físico. Para uma aplicação Kotlin nativa, o Android Studio é o seu espaço de trabalho principal e o Unity é desnecessário.
Para personalizar posteriormente a compilação Android, o Unity pode exportar um projeto Gradle para o Android Studio. Não precisa deste passo na configuração inicial. Mantenha selecionadas as ferramentas de compilação suportadas do próprio Unity, a menos que a sua integração exija especificamente um fluxo de trabalho de exportação.
Resolução de problemas na primeira configuração
- O destino de compilação Android não está disponível: Adicione o Android Build Support à instalação exata do editor Unity
- O grupo Android XR não aparece: Verifique o identificador do pacote, a compatibilidade e o separador do destino Android
- A Gradle sync falha: Leia o primeiro erro de compilação; verifique a instalação do SDK e a correspondência entre as versões das dependências
- Faltam pacotes ou funcionalidades necessários: Verifique o Package Manager, o destino Android ativo e o grupo de funcionalidades Android XR
- O Project Validation mostra erros: Analise cada problema obrigatório e aplique a correção adequada à versão do pacote instalada
- O dispositivo aparece como não autorizado: Aprove o pedido de depuração no dispositivo
- A instalação falha no emulador: Compare a arquitetura do APK com a imagem de sistema do emulador
Conclusão
Configurar um ambiente de desenvolvimento para XREAL Aura implica instalar ferramentas compatíveis, preparar um projeto Android XR, ativar o suporte de plataforma adequado e verificar a ligação ao dispositivo. O Unity adequa-se a projetos que vão utilizar conteúdo 3D interativo, enquanto o Android Studio se adequa a interfaces Android nativas. Uma configuração clara e repetível ajuda as empresas a reduzir problemas de configuração e dá aos programadores uma base fiável para criar e testar aplicações.
Está a planear desenvolver para o XREAL Aura? Fale com a VR Expert sobre o acesso ao hardware, os requisitos de software e o apoio à implementação.
Descubra hardware de XR empresarial e apoio em: https://ai.vr-expert.com/

























