Resumen ejecutivo
Usa Unity cuando tu aplicación empresarial necesite contenido 3D interactivo, o Android Studio cuando necesite una interfaz nativa de Android. La configuración estará completa cuando las herramientas necesarias estén instaladas, el proyecto supere las comprobaciones de configuración y tu dispositivo de prueba o emulador esté disponible.
Las instrucciones siguen la documentación oficial de Android XR. Los puertos de desarrollo, los menús de firmware y los permisos específicos de Aura deben contrastarse con las instrucciones de incorporación que se suministran con tu unidad. Esta guía no afirma haber realizado pruebas físicas con Aura.
Elige tu vía de desarrollo
Elige Unity si tu proyecto va a utilizar modelos 3D, formación o simulación interactivas, o si tus desarrolladores ya trabajan con Unity y C#. Unity te ofrece un espacio de trabajo visual para organizar el contenido y configurar las funciones de XR. Puedes configurar el entorno sin escribir código ni crear un prototipo.
Elige Android Studio si vas a ampliar una aplicación empresarial de Android o a crear interfaces nativas, como instrucciones de trabajo, formularios o paneles de tareas. Utiliza Kotlin y las bibliotecas Jetpack XR de Google. Cualquiera de las dos vías puede conectarse más adelante a sistemas empresariales mediante una API, una forma definida de que el software intercambie información; elige la vía en función de la interfaz de la aplicación y de las competencias de tu equipo.
Editor de desarrollo principal:
- Vía Unity: Unity Editor, instalado a través de Unity Hub
- Vía Android Studio: Android Studio
Lenguaje para el desarrollo posterior:
- Vía Unity: C#
- Vía Android Studio: Kotlin
Herramientas de compilación de Android:
- Vía Unity: Android Build Support, que incluye SDK, NDK y OpenJDK
- Vía Android Studio: Herramientas del SDK de Android, instaladas a través de SDK Manager
Compatibilidad básica con XR:
- Vía Unity: OpenXR Plugin, instalado a través de Unity Package Manager
- Vía Android Studio: Bibliotecas del Jetpack XR SDK, descargadas a través de Gradle
Compatibilidad con XR específica de la plataforma:
- Vía Unity: Paquete Unity OpenXR: Android XR
- Vía Android Studio: Plantilla de proyecto de XR y bibliotecas de Jetpack XR necesarias
Qué significan las herramientas de XR:
- Vía Unity: OpenXR es una interfaz común entre una aplicación de XR y el runtime de su dispositivo, el software del sistema que ejecuta las funciones de XR
- Vía Android Studio: Jetpack XR SDK es la colección de bibliotecas de Google para interfaces espaciales nativas y funciones de XR
Conexión y diagnóstico:
- Vía Unity: ADB, la herramienta Android Debug Bridge
- Vía Android Studio: ADB y Logcat de Android Studio, que muestra mensajes de diagnóstico
Prepara tu estación de trabajo y el acceso de desarrollo
Prepara un ordenador de desarrollo compatible, una conexión a internet fiable para las dependencias, una carpeta de proyecto aprobada por la empresa y un cable USB de datos. Los requisitos del emulador difieren de los del editor; consulta la página de hardware del emulador de XR de Google antes de confiar en un dispositivo virtual. Un dispositivo virtual es una simulación por software de un dispositivo Android. [4]
Utiliza una unidad Aura con acceso de desarrollador autorizado, la conexión de las gafas suministrada y la conexión de desarrollo documentada por XREAL. Confirma el suministro regional y la incorporación del kit antes de comprometerte con una fecha de taller. Las páginas actuales de XREAL y las páginas regionales pueden diferir en cuanto a disponibilidad; un anuncio de producto por sí solo no determina el plazo de entrega. [1]
Para uso empresarial, confirma que tu organización cumple los requisitos de la licencia de Unity y las condiciones de Industry que correspondan antes de usar Unity con fines comerciales. Utiliza un control de código fuente gestionado por la empresa, fuentes de paquetes aprobadas y datos de prueba. Android Studio y Unity son herramientas de desarrollo para aplicaciones profesionales; instalarlas no implica que Aura admita la gestión empresarial.
Vía A: Configurar el entorno de desarrollo de Unity
Esta vía instala Unity y sus herramientas de Android, crea un proyecto vacío y habilita la compatibilidad con Android XR. Prepara el espacio de trabajo para el desarrollo posterior.
Paso 1 | Instala el editor de Unity
Unity Hub gestiona las instalaciones del editor; Unity Editor es el espacio de trabajo en el que configuras los proyectos y, más adelante, desarrollas tu aplicación.
Instala Unity Hub desde el sitio web oficial de Unity y ábrelo. Ve a Installs y, después, a Install Editor. Elige una versión compatible de Unity 6.5 (o posterior) que admita el paquete de Android XR que vayas a utilizar, para obtener compatibilidad completa con la entrada del trackpad del puck y otras funciones. La página de configuración de Google especifica actualmente la versión 6000.0.58f2 o superior; también se aplican los requisitos de los paquetes más recientes. [5]
Paso 2 | Añade las herramientas de compilación de Android
Estos módulos permiten a Unity convertir tu proyecto en una aplicación Android.
XREAL Aura funciona con Android XR, por lo que necesita una aplicación Android que su sistema operativo pueda instalar y ejecutar. Tu proyecto de Unity contiene archivos editables para el desarrollo; las herramientas de compilación de Android empaquetan y compilan esos archivos en una aplicación instalable, normalmente un APK para pruebas en el dispositivo.
En los módulos de instalación, selecciona Android Build Support y sus subelementos, haz clic en Continue y completa los pasos de instalación. Las herramientas necesarias son:
· Android SDK (Software Development Kit)
· Android NDK (Native Development Kit): convierte el código de bajo nivel en un formato que el procesador del dispositivo puede ejecutar.
· JDK (Java Development Kit)
Si ya tienes un editor instalado, vuelve a Unity Hub > Installs, abre el menú del editor, elige Add modules, selecciona los mismos elementos y haz clic en Installs.
Paso 3 | Crea un proyecto
Un proyecto vacío te ofrece un lugar donde configurar el entorno de desarrollo de Android XR.
En Unity Hub, abre Projects > New project. Selecciona el editor instalado y elige Universal 3D. Asigna al proyecto el nombre AuraDevelopmentSetup, elige una carpeta y selecciona Create project. Universal 3D utiliza URP, el Universal Render Pipeline que dibuja los gráficos de tu aplicación.
Paso 4 | Comprueba las rutas de las herramientas
Unity necesita saber dónde están instaladas sus herramientas de compilación de Android compatibles.
En Unity Editor, abre Edit > Preferences > External Tools (Unity > Settings o Preferences en macOS). Mantén seleccionados el SDK (herramientas de la plataforma Android), el NDK (herramientas de compilación de código nativo) y el JDK (herramientas de compilación de Java) que proporciona Unity. Estas versiones están adaptadas a tu editor de Unity, lo que ayuda a evitar errores de compilación. No las sustituyas por versiones de herramientas de Android Studio no relacionadas solo porque ambas estén instaladas.
Configura tu entorno de desarrollo para XREAL Aura en Unity
OpenXR es un estándar abierto que ayuda a las aplicaciones de XR a comunicarse con los runtimes de dispositivos compatibles. En Unity, instala OpenXR Plugin para la conexión básica y Unity OpenXR: Android XR para la compatibilidad con Android XR a través de Package Manager. AR Foundation es la interfaz común de Unity para funciones de AR compatibles, como la comprensión del entorno.
Paso 1 | Selecciona el destino de compilación Android XR
El destino de compilación indica a Unity en qué plataforma debe ejecutarse la aplicación.
Abre File > Build Profiles. En Unity 6.1 o posterior, añade o selecciona el perfil de plataforma Android XR y cambia a él. Según la documentación de Unity, esto puede instalar automáticamente el paquete de Android XR compatible. Si tu editor compatible utiliza en su lugar la plataforma Android, selecciona Android y configura OpenXR manualmente. [7]
Paso 2 | Instala los paquetes de OpenXR
Los paquetes añaden los componentes de software que conectan tu escena de Unity con Android XR.
Abre Window > Package Management > Package Manager, o Window > Package Manager en los editores con la distribución de menús antigua. Comprueba que OpenXR Plugin y Unity OpenXR: Android XR estén instalados. Si falta el paquete de Android XR, usa el menú del signo más > Add package by name e introduce com.unity.xr.androidxr-openxr. El identificador del paquete principal de OpenXR es com.unity.xr.openxr. Deja que Package Manager resuelva las dependencias compatibles. [6]
Paso 3 | Habilita el proveedor de XR
Instalar un paquete hace que esté disponible; habilitar el proveedor permite que la aplicación lo utilice.
Abre Edit > Project Settings > XR Plug-in Management. En la pestaña Android, habilita OpenXR. Abre la sección OpenXR que aparece debajo y habilita el grupo de funciones Android XR. Habilita Android XR: Session si utilizas funciones de AR Foundation. Habilita Android XR: AR Session para la versión 1.0. Evita habilitar proveedores no relacionados para esta compilación. [8]
Paso 4 | Valida el proyecto
La validación detecta los ajustes que impedirían una compilación de XR compatible.
Abre XR Plug-in Management > Project Validation y selecciona Android. Revisa y resuelve los problemas obligatorios y vuelve a comprobarlo. Los requisitos de validación específicos de cada paquete tienen prioridad sobre los ajustes copiados de un tutorial antiguo.
Paso 5 | Mantén sencillos los requisitos de entrada
Habilita solo las funciones que requiera la aplicación prevista y que admita el dispositivo de destino.
Deja las funciones de entrada opcionales para la fase de desarrollo de la aplicación, a menos que tu proyecto o plantilla las requiera. Habilitar un perfil de seguimiento ocular o de mando no añade ese hardware a Aura. Revisa los ajustes de interacción necesarios en Project Validation antes de continuar.
Android XR Extensions for Unity de Google es un paquete adicional con funciones extra. Es distinto de Unity OpenXR: Android XR. No necesitas añadirlo solo porque los nombres se parezcan; añádelo cuando tu aplicación necesite alguna de las funciones que ofrece. [9]
Comprueba los ajustes de renderizado y de compilación de Android
Vulkan es la interfaz gráfica que se utiliza para enviar el trabajo de renderizado a la GPU. En Edit > Project Settings > Player, selecciona Android > Other Settings. Si Auto Graphics API está habilitado, desactívalo y coloca Vulkan en primer lugar. Para una configuración básica sencilla de URP, desactiva HDR en el asset de URP y el posprocesado en su asset de renderizador. Google recomienda estos ajustes para Android XR. [5]
En los mismos ajustes de Player, establece un identificador de paquete único, como com.yourcompany.aurapilot. En Configuration, selecciona IL2CPP y ARM64 para la compilación destinada al dispositivo físico. IL2CPP convierte el código C# en código nativo; ARM64 es la arquitectura de procesador a la que se dirige la compilación. Consulta la validación de los paquetes instalados y los requisitos del dispositivo por si hubiera restricciones adicionales.
Google indica API 24 como mínimo del cargador de OpenXR, no como la versión del sistema operativo de Aura. Usa un nivel de API mínimo que también cumpla los requisitos de todos los paquetes instalados, y un SDK de destino instalado que sea compatible con tu editor y con tus requisitos de distribución. Configura GameActivity como punto de entrada de la aplicación, desmarca Activity y habilita Resizable Activity en Resolution and Presentation, tal como indica Google. [5]
Vía B: Configurar el entorno de desarrollo de Android Studio
Esta vía instala Android Studio, descarga las herramientas de desarrollo de Android y crea un proyecto de XR a partir de la plantilla de Google. Prepara el espacio de trabajo nativo de Android para el desarrollo posterior de la aplicación. También puedes crear un emulador para comprobar que el proyecto se compila y se inicia.
Resumen de la configuración: instalar Android Studio → descargar las herramientas de Android → crear un proyecto de XR → comprobar las dependencias → preparar un destino de prueba.Android Studio es el entorno de desarrollo de Google para aplicaciones Android. Kotlin es el lenguaje de programación que se utiliza aquí. Jetpack XR SDK proporciona bibliotecas nativas de interfaz espacial y de XR, mientras que Jetpack Compose describe las interfaces en código Kotlin.
Paso 1 | Instala el editor compatible con XR
La versión recomendada de Android Studio incluye las herramientas y plantillas de XR que se utilizan en esta vía.
Descarga la compilación de Android Studio recomendada en la página de configuración de XR de Google. Las indicaciones actuales recomiendan la última compilación Canary; si es necesario, instálala junto a tu versión estable habitual. Canary es una versión de desarrollo temprana, así que anota la versión exacta que utiliza tu equipo. [10]
Paso 2 | Descarga las herramientas de desarrollo de Android
SDK Manager instala los componentes necesarios para compilar, ejecutar e inspeccionar tu aplicación.
En la pantalla de bienvenida, abre More Actions > SDK Manager. En SDK Tools, instala o actualiza Android SDK Build-Tools, Android Emulator y Android SDK Platform-Tools, además de la versión de Layout Inspector que figura en las instrucciones actuales de Google. Haz clic en Apply y acepta las licencias. [10]
Paso 3 | Crea el proyecto de XR
Una plantilla de XR proporciona una aplicación inicial con la estructura espacial ya preparada.
Abre New Project. Selecciona XR en la lista de plantillas y, a continuación, la plantilla inmersiva para visores de XR o gafas de XR con cable. No selecciones una plantilla de gafas de audio ni de gafas con pantalla. Haz clic en Next, asigna al proyecto el nombre AuraBusinessPanel, establece un nombre de paquete de la empresa si se te ofrece la opción, elige una carpeta de destino y haz clic en Finish. [11]
Paso 4 | Deja que el proyecto descargue las dependencias
Gradle sync prepara las bibliotecas y la configuración de compilación antes de que edites la aplicación.
Espera a que Gradle sync termine. Gradle es el sistema de compilación que descarga las dependencias y compila la aplicación. Abre el panel Project y busca app/build.gradle.kts, o el archivo de Gradle del módulo app. Mantén las versiones de la plantilla, que son compatibles entre sí; no actualices una biblioteca de XR al azar.
Paso 5 | Comprueba los requisitos de la API de Android
La configuración de la API debe cumplir los requisitos de la plantilla y de todas las bibliotecas que utilices.
Contrasta la página de configuración del Jetpack XR SDK con tu plantilla. La base publicada es minSdk 24 y compileSdk 34 o superior; usa valores más altos cuando las bibliotecas elegidas o la plantilla lo requieran. compileSdk es la API de Android que se usa al compilar, mientras que minSdk establece la API de Android más antigua compatible. [12]
La página de configuración del SDK enumera las dependencias Runtime, SceneCore, Compose for XR, Material Design for XR y ARCore for Jetpack XR. Añade solo lo que utilice la aplicación. SceneCore gestiona el contenido espacial; ARCore for Jetpack XR proporciona capacidades de percepción compatibles. Las versiones preliminares pueden cambiar, así que utiliza la plantilla junto con las notas de la versión en lugar de pegar un bloque de dependencias antiguo.
Si tu plantilla no incluye automáticamente las bibliotecas básicas de XR, asegúrate de que tu app/build.gradle.kts refleje las siguientes dependencias básicas:
android {
compileSdk = 34 // o el valor superior que establezca tu plantilla
defaultConfig {
minSdk = 24
}
}
dependencies {
// Dependencias principales del 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")
}
En la fecha de la investigación, Compose for XR 1.0.0-beta02 (21-10-2026) requiere Kotlin 2.2, y sus notas de la versión indican que depende de SceneCore 1.0.0-rc01, que tiene una fuga de memoria conocida; la solución es declarar tú mismo SceneCore 1.0.0 o posterior, algo que el bloque de dependencias anterior ya hace. Este es uno de los motivos para registrar el conjunto completo de dependencias en lugar de describir cualquier instalación más reciente como lista para producción. [13]
Ejecuta en un emulador de XR antes de disponer del hardware
Paso 1 | Crea un dispositivo XR virtual
El emulador te permite comprobar el software antes de disponer de una unidad Aura física.
Abre Tools > Device Manager y, después, Add a new device > Create Virtual Device. Selecciona XR como factor de forma y elige XR Glasses para el flujo de trabajo con gafas con cable. [4]
Paso 2 | Instala la imagen del sistema necesaria
La imagen del sistema proporciona el entorno operativo de Android XR para el dispositivo virtual.
Elige la imagen del sistema preliminar que la guía de Google exige para XR Glasses, descárgala si se te solicita y termina de crear el dispositivo virtual. Inícialo desde Device Manager.
Paso 3 | Ejecuta la aplicación
Android Studio compila el proyecto y lo instala en el dispositivo virtual seleccionado.
En la barra de herramientas superior de Android Studio, elige la configuración de ejecución de la aplicación y el dispositivo XR virtual en funcionamiento. Haz clic en Run. Deja que Android Studio compile e instale la plantilla sin modificar. No necesitas personalizar su interfaz para esta comprobación del entorno.
Paso 4 | Comprueba el resultado
Una compilación y un inicio correctos confirman que las herramientas instaladas pueden procesar la plantilla.
Comprueba que la plantilla se abre sin errores de compilación ni de inicio. Esto valida la configuración básica del software, no la óptica de Aura, el seguimiento físico, el rendimiento ni la preparación para producción.
Conecta XREAL Aura al ordenador de desarrollo
ADB, abreviatura de Android Debug Bridge, permite que un ordenador de desarrollo instale aplicaciones y lea registros de diagnóstico de un dispositivo Android. Tanto Unity como Android Studio pueden utilizarlo.
Según las preguntas frecuentes de XREAL sobre Aura, los dos puertos USB-C del compute puck admiten la depuración ADB estándar con Android Studio, pero su tabla de especificaciones solo indica compatibilidad total con ADB en el puerto de las gafas (Glasses Port), así que, si es posible, céntrate en ese puerto. Mantén las gafas conectadas según las instrucciones. La duplicación por DisplayPort y una conexión ADB autorizada son funciones distintas, de modo que ver la pantalla del portátil en las gafas no demuestra que la conexión de desarrollo funcione.
Paso 1 | Habilita la depuración autorizada
La depuración permite que tu ordenador de desarrollo instale e inspeccione aplicaciones de prueba.
En el sistema Android XR, abre Settings y habilita Developer options y USB debugging siguiendo las instrucciones de tu firmware. En Android estándar, Developer options suele mostrarse al seleccionar repetidamente Build number, pero en las fuentes públicas consultadas no se pudo determinar la ruta exacta del menú en Aura. Si difiere, utiliza la ruta indicada en las instrucciones de incorporación suministradas. [14]
Paso 2 | Conecta y autoriza el ordenador
Este flujo de trabajo de depuración por cable requiere una conexión USB de datos y la aprobación en el dispositivo.
Conecta el host con un cable USB de datos al puerto de desarrollo documentado. Aprueba en el dispositivo la solicitud de autorización de depuración del ordenador. En Windows, instala el controlador ADB del fabricante si el sistema lo requiere. [14]
Paso 3 | Comprueba que ADB detecta el dispositivo
La lista de dispositivos confirma que la conexión está lista antes de intentar compilar y ejecutar.
En Android Studio, abre SDK Manager y anota el valor de Android SDK Location. En tu terminal, abre la carpeta platform-tools de ese SDK y ejecuta el comando correspondiente de los que aparecen a continuación.
# Windows PowerShell, dentro de platform-tools
.\adb.exe devices -l
# macOS o Linux, dentro de platform-tools
./adb devices -l
Resultado esperado: el número de serie de tu dispositivo va seguido de device. Si aparece unauthorized, aprueba la solicitud. Si la lista está vacía, comprueba el cable, el puerto del host, el ajuste de depuración y el controlador. Si hay más de un dispositivo o emulador conectado, selecciona explícitamente el destino deseado.
Confirma que tu entorno de desarrollo está listo
Comprobaciones de preparación en Unity
Paso 1 | Comprueba el perfil de compilación
Comprueba la configuración antes de empezar a desarrollar la aplicación.
Abre File > Build Profiles y confirma que Android XR, o el perfil de Android configurado para XR, está activo. Confirma que los módulos de compilación de Android necesarios están disponibles para este editor.
Paso 2 | Comprueba los paquetes y la validación
El proyecto debe tener instalados y habilitados los paquetes de XR necesarios.
En Package Manager, comprueba OpenXR Plugin y Unity OpenXR: Android XR. En Project Settings > XR Plug-in Management, confirma el proveedor OpenXR de Android y el grupo de funciones Android XR. Resuelve los problemas obligatorios en Project Validation.
Paso 3 | Comprueba el dispositivo de destino
Un dispositivo reconocido completa la parte de conexión de la configuración.
En Build Profiles, actualiza Run Device y comprueba que aparece tu unidad Aura autorizada. Si no aparece, revisa la conexión ADB y las rutas de External Tools de Unity. Puedes configurar el proyecto antes de disponer del hardware, pero la validación del despliegue físico tendrá que esperar a que tengas un dispositivo.
Comprobaciones de preparación en Android Studio
Confirma que Gradle sync termina sin errores, que SDK Manager tiene instaladas las herramientas necesarias y que el emulador de XR o el dispositivo Aura autorizado aparece en el selector de destino. Ejecuta la plantilla de XR sin modificar si hay un destino de prueba disponible. Abre View > Tool Windows > Logcat para inspeccionar los errores de inicio. Logcat muestra los mensajes de diagnóstico de Android.
Cómo funcionan juntos Unity y Android Studio
Unity puede compilar aplicaciones Android con sus propias herramientas compatibles, por lo que Android Studio no es necesario para configurar un proyecto de Unity. Aun así, Android Studio puede ser útil para gestionar emuladores y para diagnósticos de Android como Logcat. Cabe destacar que el emulador de Android XR no admite la simulación de aplicaciones creadas con Unity, Godot, Unreal Engine u OpenXR, por lo que las compilaciones de Unity necesitan una unidad Aura física. Para una aplicación nativa en Kotlin, Android Studio es tu espacio de trabajo principal y Unity no es necesario.
Si más adelante necesitas personalizar la compilación de Android, Unity puede exportar un proyecto de Gradle para Android Studio. No necesitas este paso para la configuración inicial. Mantén seleccionadas las herramientas de compilación compatibles de Unity, salvo que tu integración requiera específicamente un flujo de trabajo de exportación.
Solución de problemas en la primera configuración
- El destino de compilación Android no está disponible: Añade Android Build Support a la instalación exacta del editor de Unity
- Falta el grupo Android XR: Comprueba el identificador del paquete, la compatibilidad y la pestaña del destino Android
- Gradle sync falla: Lee el primer error de compilación; comprueba la instalación del SDK y que las versiones de las dependencias coincidan
- Faltan paquetes o funciones necesarios: Comprueba Package Manager, el destino Android activo y el grupo de funciones Android XR
- Project Validation muestra errores: Revisa cada problema obligatorio y aplica la corrección correspondiente a la versión del paquete instalada
- El dispositivo aparece como unauthorized: Aprueba la solicitud de depuración en el dispositivo
- La instalación falla en el emulador: Comprueba que la arquitectura del APK coincide con la imagen del sistema del emulador
Conclusión
Configurar un entorno de desarrollo para XREAL Aura implica instalar herramientas compatibles, preparar un proyecto de Android XR, habilitar la compatibilidad de plataforma adecuada y comprobar la conexión del dispositivo. Unity es adecuado para proyectos que vayan a usar contenido 3D interactivo, mientras que Android Studio lo es para interfaces nativas de Android. Una configuración clara y repetible ayuda a las empresas a reducir los problemas de configuración y ofrece a los desarrolladores una base fiable para crear y probar aplicaciones.
¿Estás planificando el desarrollo para XREAL Aura? Habla con VR Expert sobre el acceso al hardware, los requisitos de software y el soporte para el despliegue.
Descubre hardware de XR y soporte para empresas en: https://ai.vr-expert.com/

























