Comienza a usar el SDK de Jetpack XR

En esta guía, se proporcionan instrucciones para crear una aplicación de XR para Android con el SDK de XR de Jetpack. Abarca las dependencias esenciales y la configuración del proyecto en Android Studio para compilar experiencias de XR inmersivas.

Compatibilidad

El SDK de Jetpack XR requiere un minSdk de 24 y debe compilarse para el SDK 34 o una versión posterior.

Cómo agregar dependencias

Consulta las siguientes guías de referencia para comprender las dependencias necesarias y los problemas de compatibilidad de cada una de las bibliotecas del SDK de Jetpack XR:

Luego, agrega las dependencias necesarias al archivo build.gradle.kts de tu app:

Groovy

dependencies {
    
    // Required for Java
    implementation "com.google.guava:listenablefuture:1.0"
    // Required for Kotlin
    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-guava:1.9.0"

    implementation "androidx.xr.runtime:runtime:1.0.0-alpha05"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha06"
    implementation "androidx.xr.compose:compose:1.0.0-alpha06"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha10"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha05"
}

Kotlin

dependencies {
    
    // Required for Java
    implementation("com.google.guava:listenablefuture:1.0")
    // Required for Kotlin
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-guava:1.9.0")

    implementation("androidx.xr.runtime:runtime:1.0.0-alpha05")
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha06")
    implementation("androidx.xr.compose:compose:1.0.0-alpha06")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha10")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha05")
}

Consulta la muestra de Hello Android XR.

Habilita la reducción de código (opcional)

Si deseas habilitar la ofuscación y la minimización de código con ProGuard para tus compilaciones, debes agregar una dependencia en la biblioteca de Android Extensions for XR. Esto es obligatorio para los proyectos que usan Jetpack XR alpha05 o una versión posterior.

Agrega la siguiente dependencia de compileOnly al archivo build.gradle.kts de tu módulo:

Groovy

dependencies {
    // ... other dependencies
    compileOnly "com.android.extensions.xr:extensions-xr:1.0.0"
}

Crea una app nueva en Android Studio con la plantilla Basic Headset Activity

Para crear un proyecto nuevo que incluya Jetpack Compose para XR, sigue estos pasos:

  1. Si te encuentras en la ventana Welcome to Android Studio, haz clic en Start a new Android Studio project. Si ya tienes abierto un proyecto de Android Studio, selecciona File > New en la barra de menú.
  2. Selecciona XR en las opciones de Plantilla y, luego, Actividad básica con auriculares.
  3. En la ventana Configure your project, haz lo siguiente:
    1. Establece el nombre de la aplicación en Application name.
    2. Elige la ubicación del proyecto para tu muestra en Project location.
  4. Haz clic en Finish.
  5. Verifica que el archivo build.gradle del proyecto esté configurado correctamente, como se describe en Archivos de propiedades de Gradle.