Agrega las dependencias necesarias

En esta guía, se proporcionan instrucciones para crear una aplicación para Android XR con el SDK de Jetpack XR. En él, se abordan las dependencias esenciales y la configuración de proyectos en Android Studio para compilar experiencias de XR envolventes.

Compatibilidad

El SDK de Jetpack XR requiere un minSdk de 24 y debe compilarse en 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.

Ejemplo

En el siguiente fragmento del ejemplo de Hello Android XR, se muestra un archivo build.gradle de ejemplo que incluye todas las dependencias del SDK de Jetpack XR:

dependencies {
    val composeBom = platform(libs.androidx.compose.bom)
    implementation(composeBom)
    implementation(libs.impress)
    implementation(libs.androidx.arcore)
    implementation(libs.androidx.scenecore)
    implementation(libs.androidx.compose)
    implementation(libs.kotlinx.coroutines.guava)

    implementation(libs.material)
    implementation(libs.androidx.compose.material3)
    implementation(libs.androidx.adaptive.android)
    implementation(libs.androidx.concurrent.futures)
    implementation(libs.androidx.compose.runtime)
    implementation(libs.androidx.activity.compose)

    debugImplementation(libs.androidx.compose.ui.tooling)

    screenshotTestImplementation(libs.androidx.compose.ui.tooling)
}

Este es un ejemplo del archivo libs.toml correspondiente:

[versions]
androidx-runtime = "1.8.0-alpha06"
agp = "8.6.1"
arcore = "1.0.0-alpha01"
compose = "1.0.0-alpha01"
impress = "0.0.1"
kotlinxCoroutinesGuava = "1.9.0"
scenecore = "1.0.0-alpha01"
kotlin = "2.0.21"
concurrentFuturesKtx = "1.2.0"
activityCompose = "1.10.0-beta01"
composeBom = "2024.11.00"
material = "1.12.0"
screenshot = "0.0.1-alpha08"
adaptiveAndroid = "1.0.0"

[libraries]
androidx-arcore = { module = "androidx.xr.arcore:arcore", version.ref = "arcore" }
androidx-compose = { module = "androidx.xr.compose:compose", version.ref = "compose" }
androidx-scenecore = { module = "androidx.xr.scenecore:scenecore", version.ref = "scenecore" }
impress = { module = "com.google.ar:impress", version.ref = "impress" }
kotlinx-coroutines-guava = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-guava", version.ref = "kotlinxCoroutinesGuava" }
androidx-compose-material3 = { module = "androidx.compose.material3:material3" }
material = { module = "com.google.android.material:material", version.ref = "material" }
androidx-compose-ui-tooling = { module = "androidx.compose.ui:ui-tooling" }
androidx-concurrent-futures = { module = "androidx.concurrent:concurrent-futures-ktx", version.ref = "concurrentFuturesKtx" }
androidx-activity-compose = { group = "androidx.activity", name = "activity-compose", version.ref = "activityCompose" }
androidx-compose-runtime = { module = "androidx.compose.runtime:runtime", version.ref = "androidx-runtime" }
androidx-compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "composeBom" }

Consulta el ejemplo de Hello Android XR.

Crea una app nueva en Android Studio con la plantilla de actividad de auriculares básica

Para crear un nuevo proyecto 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 Template y, luego, Basic Headset Activity.
  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.