Saltar al contenido principal

Primeros pasos para desarrolladores

Configure XREAL AURA para desarrollar.

Requisitos previos​

Antes de empezar, asegúrese de tener:

  • XREAL AURA (gafas + Compute Puck)
  • Un ordenador de desarrollo (Windows, macOS o Linux)
  • Android Studio instalado (última versión estable)
  • Cable USB-C de calidad con transferencia de datos
  • Cuenta de Google para Play Store y servicios

Paso 1: configurar Android Studio​

Instalar Android XR SDK​

  1. Abra Android Studio.
  2. Vaya a SDK Manager (Tools > SDK Manager).
  3. Seleccione la pestaña SDK Platforms.
  4. Marque Android 15 (API 35) o posterior.
  5. Seleccione la pestaña SDK Tools.
  6. Instale lo siguiente:
    • Android SDK Build-Tools
    • Android Emulator
    • Extensiones Android XR (cuando estén disponibles)

Instalar el perfil del emulador XR​

Para probar sin hardware:

  1. Abra Device Manager en Android Studio.
  2. Cree un nuevo dispositivo virtual (Virtual Device).
  3. Seleccione el perfil de dispositivo XR.
  4. Elija la imagen del sistema Android XR.
  5. Configure los ajustes OST para simular XREAL.

Paso 2: activar el modo de desarrollador​

En XREAL AURA:

  1. Vaya a Ajustes (abra el lanzador > Ajustes).
  2. Vaya a Acerca del dispositivo.
  3. Toque Número de compilación 7 veces.
  4. Verá «Modo de desarrollador activado».
  5. Vuelva a Ajustes.
  6. Abra el nuevo menú Opciones de desarrollador.
  7. Active Depuración USB.

Paso 3: conectar el dispositivo al ordenador​

  1. Mantenga las gafas conectadas al puerto de las gafas del lado derecho de Compute Puck.
  2. Conecte un cable USB-C del ordenador al Puerto de carga del lado izquierdo de Compute Puck.
important

Tanto el puerto de las gafas como el Puerto de carga permiten todas las funciones de depuración ADB. Usar el puerto de carga permite depurar por cable mientras ve la imagen en las gafas.

Paso 4: compilar e instalar su primera aplicación​

Crear un proyecto nuevo​

  1. En Android Studio, seleccione New Project
  2. Elija XR Activity como plantilla (si está disponible) o Empty Activity
  3. Establezca el SDK mínimo en API 35
  4. Seleccione Kotlin como lenguaje de programación

Configurar dependencias XR​

En su archivo build.gradle.kts:

android {
    defaultConfig {
        minSdk = 35
        targetSdk = 35
    }
}

dependencies {
    // Add XR dependencies
    implementation("androidx.xr:xr-compose:1.0.0")
    // ... other dependencies
}

Instalar en el dispositivo​

  1. Seleccione el dispositivo conectado en la lista desplegable
  2. Haga clic en Run (botón verde de reproducción)
  3. Espere a que terminen la compilación y la instalación
  4. Póngase las gafas para ver la aplicación en ejecución

Siguientes pasos​

Solución de problemas​

ProblemaSolución
Dispositivo no reconocidoCompruebe el cable y pruebe otro puerto USB
El estado muestra «Unauthorized»Toque «Permitir» en el aviso de depuración USB del dispositivo
La compilación fallaActualice Android Studio y las herramientas de plataforma SDK
La aplicación se cierra al iniciarConsulte logcat para ver los errores y trazas de pila
No se ve la imagen de las gafasVuelva a conectar las gafas cuando termine la sesión ADB

¿Necesita más ayuda? Visite Discord de desarrolladores de XREAL.