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 interactivas.

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 {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha06"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha07"
    implementation "androidx.xr.compose:compose:1.0.0-alpha07"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha11"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha06"

    // For compatibility with guava, use these dependencies:
    implementation "androidx.xr.arcore:arcore-guava:1.0.0-alpha06"
    implementation "androidx.xr.runtime:runtime-guava:1.0.0-alpha06"
    implementation "androidx.xr.scenecore:scenecore-guava:1.0.0-alpha07"

    // For compatibility with rxjava3, use these dependencies:
    implementation "androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha06"
    implementation "androidx.xr.runtime:runtime-rxjava3:1.0.0-alpha06"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha06")
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha07")
    implementation("androidx.xr.compose:compose:1.0.0-alpha07")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha11")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha06")

    // For compatibility with guava, use these dependencies:
    implementation("androidx.xr.arcore:arcore-guava:1.0.0-alpha06")
    implementation("androidx.xr.runtime:runtime-guava:1.0.0-alpha06")
    implementation("androidx.xr.scenecore:scenecore-guava:1.0.0-alpha07")

    // For compatibility with rxjava3, use these dependencies:
    implementation("androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha06")
    implementation("androidx.xr.runtime:runtime-rxjava3:1.0.0-alpha06")
}

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.1.0"
}

Kotlin

dependencies {
    // ... other dependencies
    compileOnly("com.android.extensions.xr:extensions-xr:1.1.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 de 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.